google-apis-logging_v2 0.11.0 → 0.15.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 +323 -68
  4. data/lib/google/apis/logging_v2/gem_version.rb +3 -3
  5. data/lib/google/apis/logging_v2/representations.rb +108 -0
  6. data/lib/google/apis/logging_v2/service.rb +998 -364
  7. data/lib/google/apis/logging_v2.rb +2 -2
  8. metadata +5 -5
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,13 @@ 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. If an UNAVAILABLE error is returned, this
643
+ # indicates that system is not in a state where it can delete the view. If this
644
+ # occurs, please try again in a few minutes.
643
645
  # @param [String] name
644
646
  # 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".
647
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
648
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
648
649
  # @param [String] fields
649
650
  # Selector specifying which fields to include in a partial response.
650
651
  # @param [String] quota_user
@@ -672,12 +673,12 @@ module Google
672
673
  execute_or_queue_command(command, &block)
673
674
  end
674
675
 
675
- # Lists views on a bucket.
676
+ # Lists views on a log bucket.
676
677
  # @param [String] parent
677
678
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
678
679
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
679
680
  # @param [Fixnum] page_size
680
- # Optional. The maximum number of results to return from this request. Non-
681
+ # Optional. The maximum number of results to return from this request.Non-
681
682
  # positive values are ignored. The presence of nextPageToken in the response
682
683
  # indicates that more results might be available.
683
684
  # @param [String] page_token
@@ -714,20 +715,21 @@ module Google
714
715
  execute_or_queue_command(command, &block)
715
716
  end
716
717
 
717
- # Updates a view. This method replaces the following fields in the existing view
718
- # with values from the new view: filter.
718
+ # Updates a view on a log bucket. This method replaces the following fields in
719
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
720
+ # error is returned, this indicates that system is not in a state where it can
721
+ # update the view. If this occurs, please try again in a few minutes.
719
722
  # @param [String] name
720
723
  # 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".
724
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
725
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
724
726
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
725
727
  # @param [String] update_mask
726
728
  # Optional. Field mask that specifies the fields in view that need an update. A
727
729
  # field will be overwritten if, and only if, it is in the update mask. name and
728
730
  # output only fields cannot be updated.For a detailed FieldMask definition, see
729
731
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
730
- # google.protobuf.FieldMaskExample: updateMask=filter.
732
+ # google.protobuf.FieldMaskFor example: updateMask=filter
731
733
  # @param [String] fields
732
734
  # Selector specifying which fields to include in a partial response.
733
735
  # @param [String] quota_user
@@ -758,6 +760,92 @@ module Google
758
760
  execute_or_queue_command(command, &block)
759
761
  end
760
762
 
763
+ # Starts asynchronous cancellation on a long-running operation. The server makes
764
+ # a best effort to cancel the operation, but success is not guaranteed. If the
765
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
766
+ # Clients can use Operations.GetOperation or other methods to check whether the
767
+ # cancellation succeeded or whether the operation completed despite cancellation.
768
+ # On successful cancellation, the operation is not deleted; instead, it becomes
769
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
770
+ # corresponding to Code.CANCELLED.
771
+ # @param [String] name
772
+ # The name of the operation resource to be cancelled.
773
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
774
+ # @param [String] fields
775
+ # Selector specifying which fields to include in a partial response.
776
+ # @param [String] quota_user
777
+ # Available to use for quota purposes for server-side applications. Can be any
778
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
779
+ # @param [Google::Apis::RequestOptions] options
780
+ # Request-specific options
781
+ #
782
+ # @yield [result, err] Result & error if block supplied
783
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
784
+ # @yieldparam err [StandardError] error object if request failed
785
+ #
786
+ # @return [Google::Apis::LoggingV2::Empty]
787
+ #
788
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
789
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
790
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
791
+ def cancel_billing_account_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
792
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
793
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
794
+ command.request_object = cancel_operation_request_object
795
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
796
+ command.response_class = Google::Apis::LoggingV2::Empty
797
+ command.params['name'] = name unless name.nil?
798
+ command.query['fields'] = fields unless fields.nil?
799
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
800
+ execute_or_queue_command(command, &block)
801
+ end
802
+
803
+ # Lists operations that match the specified filter in the request. If the server
804
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
805
+ # allows API services to override the binding to use different resource name
806
+ # schemes, such as users/*/operations. To override the binding, API services can
807
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
808
+ # configuration. For backwards compatibility, the default name includes the
809
+ # operations collection id, however overriding users must ensure the name
810
+ # binding is the parent resource, without the operations collection id.
811
+ # @param [String] name
812
+ # The name of the operation's parent resource.
813
+ # @param [String] filter
814
+ # The standard list filter.
815
+ # @param [Fixnum] page_size
816
+ # The standard list page size.
817
+ # @param [String] page_token
818
+ # The standard list page token.
819
+ # @param [String] fields
820
+ # Selector specifying which fields to include in a partial response.
821
+ # @param [String] quota_user
822
+ # Available to use for quota purposes for server-side applications. Can be any
823
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
824
+ # @param [Google::Apis::RequestOptions] options
825
+ # Request-specific options
826
+ #
827
+ # @yield [result, err] Result & error if block supplied
828
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
829
+ # @yieldparam err [StandardError] error object if request failed
830
+ #
831
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
832
+ #
833
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
834
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
835
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
836
+ def list_billing_account_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
837
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
838
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
839
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
840
+ command.params['name'] = name unless name.nil?
841
+ command.query['filter'] = filter unless filter.nil?
842
+ command.query['pageSize'] = page_size unless page_size.nil?
843
+ command.query['pageToken'] = page_token unless page_token.nil?
844
+ command.query['fields'] = fields unless fields.nil?
845
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
846
+ execute_or_queue_command(command, &block)
847
+ end
848
+
761
849
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
762
850
  # reappears if it receives new entries. Log entries written shortly before the
763
851
  # delete operation might not be deleted. Entries received after the delete
@@ -850,6 +938,37 @@ module Google
850
938
  execute_or_queue_command(command, &block)
851
939
  end
852
940
 
941
+ # Gets the latest state of a long-running operation. Clients can use this method
942
+ # to poll the operation result at intervals as recommended by the API service.
943
+ # @param [String] name
944
+ # The name of the operation resource.
945
+ # @param [String] fields
946
+ # Selector specifying which fields to include in a partial response.
947
+ # @param [String] quota_user
948
+ # Available to use for quota purposes for server-side applications. Can be any
949
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
950
+ # @param [Google::Apis::RequestOptions] options
951
+ # Request-specific options
952
+ #
953
+ # @yield [result, err] Result & error if block supplied
954
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
955
+ # @yieldparam err [StandardError] error object if request failed
956
+ #
957
+ # @return [Google::Apis::LoggingV2::Operation]
958
+ #
959
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
960
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
961
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
962
+ def get_billing_account_operation(name, fields: nil, quota_user: nil, options: nil, &block)
963
+ command = make_simple_command(:get, 'v2/{+name}', options)
964
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
965
+ command.response_class = Google::Apis::LoggingV2::Operation
966
+ command.params['name'] = name unless name.nil?
967
+ command.query['fields'] = fields unless fields.nil?
968
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
969
+ execute_or_queue_command(command, &block)
970
+ end
971
+
853
972
  # Creates a sink that exports specified log entries to a destination. The export
854
973
  # of newly-ingested log entries begins immediately, unless the sink's
855
974
  # writer_identity is not permitted to write to the destination. A sink can
@@ -857,14 +976,14 @@ module Google
857
976
  # @param [String] parent
858
977
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
859
978
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
860
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
861
- # 123456789".
979
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
980
+ # 123456789"
862
981
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
863
982
  # @param [Boolean] unique_writer_identity
864
983
  # Optional. Determines the kind of IAM identity returned as writer_identity in
865
984
  # the new sink. If this value is omitted or set to false, and if the sink's
866
985
  # 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
986
+ # group or service account used by Cloud Logging before the addition of writer
868
987
  # identities to this API. The sink's destination must be in the same project as
869
988
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
870
989
  # project resource such as an organization, then the value of writer_identity
@@ -906,8 +1025,8 @@ module Google
906
1025
  # Required. The full resource name of the sink to delete, including the parent
907
1026
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
908
1027
  # 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".
1028
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1029
+ # example:"projects/my-project/sinks/my-sink"
911
1030
  # @param [String] fields
912
1031
  # Selector specifying which fields to include in a partial response.
913
1032
  # @param [String] quota_user
@@ -939,8 +1058,8 @@ module Google
939
1058
  # @param [String] sink_name
940
1059
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
941
1060
  # " "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".
1061
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1062
+ # example:"projects/my-project/sinks/my-sink"
944
1063
  # @param [String] fields
945
1064
  # Selector specifying which fields to include in a partial response.
946
1065
  # @param [String] quota_user
@@ -1018,8 +1137,8 @@ module Google
1018
1137
  # Required. The full resource name of the sink to update, including the parent
1019
1138
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1020
1139
  # 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".
1140
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1141
+ # example:"projects/my-project/sinks/my-sink"
1023
1142
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1024
1143
  # @param [Boolean] unique_writer_identity
1025
1144
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1035,10 +1154,11 @@ module Google
1035
1154
  # sink field will be overwritten if, and only if, it is in the update mask. name
1036
1155
  # and output only fields cannot be updated.An empty updateMask is temporarily
1037
1156
  # treated as using the following mask for backwards compatibility purposes:
1038
- # destination,filter,includeChildren At some point in the future, behavior will
1157
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1039
1158
  # be removed and specifying an empty updateMask will be an error.For a detailed
1040
1159
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1041
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1160
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1161
+ # filter
1042
1162
  # @param [String] fields
1043
1163
  # Selector specifying which fields to include in a partial response.
1044
1164
  # @param [String] quota_user
@@ -1077,8 +1197,8 @@ module Google
1077
1197
  # Required. The full resource name of the sink to update, including the parent
1078
1198
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1079
1199
  # 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".
1200
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1201
+ # example:"projects/my-project/sinks/my-sink"
1082
1202
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1083
1203
  # @param [Boolean] unique_writer_identity
1084
1204
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1094,10 +1214,11 @@ module Google
1094
1214
  # sink field will be overwritten if, and only if, it is in the update mask. name
1095
1215
  # and output only fields cannot be updated.An empty updateMask is temporarily
1096
1216
  # treated as using the following mask for backwards compatibility purposes:
1097
- # destination,filter,includeChildren At some point in the future, behavior will
1217
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1098
1218
  # be removed and specifying an empty updateMask will be an error.For a detailed
1099
1219
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1100
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1220
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1221
+ # filter
1101
1222
  # @param [String] fields
1102
1223
  # Selector specifying which fields to include in a partial response.
1103
1224
  # @param [String] quota_user
@@ -1129,6 +1250,36 @@ module Google
1129
1250
  execute_or_queue_command(command, &block)
1130
1251
  end
1131
1252
 
1253
+ # Copies a set of log entries from a log bucket to a Cloud Storage bucket.
1254
+ # @param [Google::Apis::LoggingV2::CopyLogEntriesRequest] copy_log_entries_request_object
1255
+ # @param [String] fields
1256
+ # Selector specifying which fields to include in a partial response.
1257
+ # @param [String] quota_user
1258
+ # Available to use for quota purposes for server-side applications. Can be any
1259
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1260
+ # @param [Google::Apis::RequestOptions] options
1261
+ # Request-specific options
1262
+ #
1263
+ # @yield [result, err] Result & error if block supplied
1264
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
1265
+ # @yieldparam err [StandardError] error object if request failed
1266
+ #
1267
+ # @return [Google::Apis::LoggingV2::Operation]
1268
+ #
1269
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1270
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1271
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1272
+ def copy_entry_log_entries(copy_log_entries_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1273
+ command = make_simple_command(:post, 'v2/entries:copy', options)
1274
+ command.request_representation = Google::Apis::LoggingV2::CopyLogEntriesRequest::Representation
1275
+ command.request_object = copy_log_entries_request_object
1276
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
1277
+ command.response_class = Google::Apis::LoggingV2::Operation
1278
+ command.query['fields'] = fields unless fields.nil?
1279
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1280
+ execute_or_queue_command(command, &block)
1281
+ end
1282
+
1132
1283
  # Lists log entries. Use this method to retrieve log entries that originated
1133
1284
  # from a project/folder/organization/billing account. For ways to export log
1134
1285
  # entries, see Exporting Logs (https://cloud.google.com/logging/docs/export).
@@ -1232,8 +1383,8 @@ module Google
1232
1383
  # @param [String] parent
1233
1384
  # Required. The parent resource in which to create the exclusion: "projects/[
1234
1385
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1235
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1236
- # project", "organizations/123456789".
1386
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1387
+ # project" "organizations/123456789"
1237
1388
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1238
1389
  # @param [String] fields
1239
1390
  # Selector specifying which fields to include in a partial response.
@@ -1269,8 +1420,8 @@ module Google
1269
1420
  # Required. The resource name of an existing exclusion to delete: "projects/[
1270
1421
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1271
1422
  # 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".
1423
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
1424
+ # projects/my-project/exclusions/my-exclusion"
1274
1425
  # @param [String] fields
1275
1426
  # Selector specifying which fields to include in a partial response.
1276
1427
  # @param [String] quota_user
@@ -1303,8 +1454,8 @@ module Google
1303
1454
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1304
1455
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1305
1456
  # 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".
1457
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1458
+ # project/exclusions/my-exclusion"
1308
1459
  # @param [String] fields
1309
1460
  # Selector specifying which fields to include in a partial response.
1310
1461
  # @param [String] quota_user
@@ -1380,8 +1531,8 @@ module Google
1380
1531
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1381
1532
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1382
1533
  # 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".
1534
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1535
+ # project/exclusions/my-exclusion"
1385
1536
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1386
1537
  # @param [String] update_mask
1387
1538
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1426,8 +1577,8 @@ module Google
1426
1577
  # @param [String] parent
1427
1578
  # Required. The parent resource in which to create the exclusion: "projects/[
1428
1579
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1429
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1430
- # project", "organizations/123456789".
1580
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1581
+ # project" "organizations/123456789"
1431
1582
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1432
1583
  # @param [String] fields
1433
1584
  # Selector specifying which fields to include in a partial response.
@@ -1463,8 +1614,8 @@ module Google
1463
1614
  # Required. The resource name of an existing exclusion to delete: "projects/[
1464
1615
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1465
1616
  # 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".
1617
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
1618
+ # projects/my-project/exclusions/my-exclusion"
1468
1619
  # @param [String] fields
1469
1620
  # Selector specifying which fields to include in a partial response.
1470
1621
  # @param [String] quota_user
@@ -1497,8 +1648,8 @@ module Google
1497
1648
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1498
1649
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1499
1650
  # 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".
1651
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1652
+ # project/exclusions/my-exclusion"
1502
1653
  # @param [String] fields
1503
1654
  # Selector specifying which fields to include in a partial response.
1504
1655
  # @param [String] quota_user
@@ -1574,8 +1725,8 @@ module Google
1574
1725
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1575
1726
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1576
1727
  # 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".
1728
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1729
+ # project/exclusions/my-exclusion"
1579
1730
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1580
1731
  # @param [String] update_mask
1581
1732
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1687,12 +1838,12 @@ module Google
1687
1838
  execute_or_queue_command(command, &block)
1688
1839
  end
1689
1840
 
1690
- # Creates a bucket that can be used to store log entries. Once a bucket has been
1691
- # created, the region cannot be changed.
1841
+ # Creates a log bucket that can be used to store log entries. After a bucket has
1842
+ # been created, the bucket's location cannot be changed.
1692
1843
  # @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"
1844
+ # Required. The resource in which to create the log bucket: "projects/[
1845
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
1846
+ # locations/global"
1696
1847
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
1697
1848
  # @param [String] bucket_id
1698
1849
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -1728,16 +1879,16 @@ module Google
1728
1879
  execute_or_queue_command(command, &block)
1729
1880
  end
1730
1881
 
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.
1882
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
1883
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
1884
+ # entries in the bucket will be permanently deleted.
1734
1885
  # @param [String] name
1735
1886
  # Required. The full resource name of the bucket to delete. "projects/[
1736
1887
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1737
1888
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1738
1889
  # [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".
1890
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
1891
+ # my-project/locations/global/buckets/my-bucket"
1741
1892
  # @param [String] fields
1742
1893
  # Selector specifying which fields to include in a partial response.
1743
1894
  # @param [String] quota_user
@@ -1765,14 +1916,14 @@ module Google
1765
1916
  execute_or_queue_command(command, &block)
1766
1917
  end
1767
1918
 
1768
- # Gets a bucket.
1919
+ # Gets a log bucket.
1769
1920
  # @param [String] name
1770
1921
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
1771
1922
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
1772
1923
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
1773
1924
  # 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".
1925
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
1926
+ # global/buckets/my-bucket"
1776
1927
  # @param [String] fields
1777
1928
  # Selector specifying which fields to include in a partial response.
1778
1929
  # @param [String] quota_user
@@ -1800,7 +1951,7 @@ module Google
1800
1951
  execute_or_queue_command(command, &block)
1801
1952
  end
1802
1953
 
1803
- # Lists buckets.
1954
+ # Lists log buckets.
1804
1955
  # @param [String] parent
1805
1956
  # Required. The parent resource whose buckets are to be listed: "projects/[
1806
1957
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -1846,27 +1997,27 @@ module Google
1846
1997
  execute_or_queue_command(command, &block)
1847
1998
  end
1848
1999
 
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.
2000
+ # Updates a log bucket. This method replaces the following fields in the
2001
+ # existing bucket with values from the new bucket: retention_periodIf the
2002
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
2003
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
2004
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
2005
+ # bucket's location cannot be changed.
1855
2006
  # @param [String] name
1856
2007
  # Required. The full resource name of the bucket to update. "projects/[
1857
2008
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1858
2009
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1859
2010
  # [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
2011
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2012
+ # my-project/locations/global/buckets/my-bucket"
1863
2013
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
1864
2014
  # @param [String] update_mask
1865
2015
  # Required. Field mask that specifies the fields in bucket that need an update.
1866
2016
  # A bucket field will be overwritten if, and only if, it is in the update mask.
1867
2017
  # 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.
2018
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
2019
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2020
+ # retention_days
1870
2021
  # @param [String] fields
1871
2022
  # Selector specifying which fields to include in a partial response.
1872
2023
  # @param [String] quota_user
@@ -1897,15 +2048,15 @@ module Google
1897
2048
  execute_or_queue_command(command, &block)
1898
2049
  end
1899
2050
 
1900
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
1901
- # grace period of 7 days.
2051
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
2052
+ # the grace period of 7 days.
1902
2053
  # @param [String] name
1903
2054
  # Required. The full resource name of the bucket to undelete. "projects/[
1904
2055
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1905
2056
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1906
2057
  # [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".
2058
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2059
+ # my-project/locations/global/buckets/my-bucket"
1909
2060
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
1910
2061
  # @param [String] fields
1911
2062
  # Selector specifying which fields to include in a partial response.
@@ -1936,12 +2087,12 @@ module Google
1936
2087
  execute_or_queue_command(command, &block)
1937
2088
  end
1938
2089
 
1939
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
1940
- # views.
2090
+ # Creates a view over log entries in a log bucket. A bucket may contain a
2091
+ # maximum of 30 views.
1941
2092
  # @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"
2093
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
2094
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
2095
+ # locations/global/buckets/my-bucket"
1945
2096
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
1946
2097
  # @param [String] view_id
1947
2098
  # Required. The id to use for this view.
@@ -1975,12 +2126,13 @@ module Google
1975
2126
  execute_or_queue_command(command, &block)
1976
2127
  end
1977
2128
 
1978
- # Deletes a view from a bucket.
2129
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
2130
+ # indicates that system is not in a state where it can delete the view. If this
2131
+ # occurs, please try again in a few minutes.
1979
2132
  # @param [String] name
1980
2133
  # 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".
2134
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
2135
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
1984
2136
  # @param [String] fields
1985
2137
  # Selector specifying which fields to include in a partial response.
1986
2138
  # @param [String] quota_user
@@ -2008,11 +2160,11 @@ module Google
2008
2160
  execute_or_queue_command(command, &block)
2009
2161
  end
2010
2162
 
2011
- # Gets a view.
2163
+ # Gets a view on a log bucket..
2012
2164
  # @param [String] name
2013
2165
  # 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".
2166
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
2167
+ # project/locations/global/buckets/my-bucket/views/my-view"
2016
2168
  # @param [String] fields
2017
2169
  # Selector specifying which fields to include in a partial response.
2018
2170
  # @param [String] quota_user
@@ -2040,12 +2192,12 @@ module Google
2040
2192
  execute_or_queue_command(command, &block)
2041
2193
  end
2042
2194
 
2043
- # Lists views on a bucket.
2195
+ # Lists views on a log bucket.
2044
2196
  # @param [String] parent
2045
2197
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
2046
2198
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2047
2199
  # @param [Fixnum] page_size
2048
- # Optional. The maximum number of results to return from this request. Non-
2200
+ # Optional. The maximum number of results to return from this request.Non-
2049
2201
  # positive values are ignored. The presence of nextPageToken in the response
2050
2202
  # indicates that more results might be available.
2051
2203
  # @param [String] page_token
@@ -2082,20 +2234,21 @@ module Google
2082
2234
  execute_or_queue_command(command, &block)
2083
2235
  end
2084
2236
 
2085
- # Updates a view. This method replaces the following fields in the existing view
2086
- # with values from the new view: filter.
2237
+ # Updates a view on a log bucket. This method replaces the following fields in
2238
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
2239
+ # error is returned, this indicates that system is not in a state where it can
2240
+ # update the view. If this occurs, please try again in a few minutes.
2087
2241
  # @param [String] name
2088
2242
  # 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".
2243
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
2244
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2092
2245
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2093
2246
  # @param [String] update_mask
2094
2247
  # Optional. Field mask that specifies the fields in view that need an update. A
2095
2248
  # field will be overwritten if, and only if, it is in the update mask. name and
2096
2249
  # output only fields cannot be updated.For a detailed FieldMask definition, see
2097
2250
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
2098
- # google.protobuf.FieldMaskExample: updateMask=filter.
2251
+ # google.protobuf.FieldMaskFor example: updateMask=filter
2099
2252
  # @param [String] fields
2100
2253
  # Selector specifying which fields to include in a partial response.
2101
2254
  # @param [String] quota_user
@@ -2126,6 +2279,123 @@ module Google
2126
2279
  execute_or_queue_command(command, &block)
2127
2280
  end
2128
2281
 
2282
+ # Starts asynchronous cancellation on a long-running operation. The server makes
2283
+ # a best effort to cancel the operation, but success is not guaranteed. If the
2284
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
2285
+ # Clients can use Operations.GetOperation or other methods to check whether the
2286
+ # cancellation succeeded or whether the operation completed despite cancellation.
2287
+ # On successful cancellation, the operation is not deleted; instead, it becomes
2288
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
2289
+ # corresponding to Code.CANCELLED.
2290
+ # @param [String] name
2291
+ # The name of the operation resource to be cancelled.
2292
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
2293
+ # @param [String] fields
2294
+ # Selector specifying which fields to include in a partial response.
2295
+ # @param [String] quota_user
2296
+ # Available to use for quota purposes for server-side applications. Can be any
2297
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2298
+ # @param [Google::Apis::RequestOptions] options
2299
+ # Request-specific options
2300
+ #
2301
+ # @yield [result, err] Result & error if block supplied
2302
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
2303
+ # @yieldparam err [StandardError] error object if request failed
2304
+ #
2305
+ # @return [Google::Apis::LoggingV2::Empty]
2306
+ #
2307
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2308
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2309
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2310
+ def cancel_folder_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2311
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
2312
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
2313
+ command.request_object = cancel_operation_request_object
2314
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
2315
+ command.response_class = Google::Apis::LoggingV2::Empty
2316
+ command.params['name'] = name unless name.nil?
2317
+ command.query['fields'] = fields unless fields.nil?
2318
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2319
+ execute_or_queue_command(command, &block)
2320
+ end
2321
+
2322
+ # Gets the latest state of a long-running operation. Clients can use this method
2323
+ # to poll the operation result at intervals as recommended by the API service.
2324
+ # @param [String] name
2325
+ # The name of the operation resource.
2326
+ # @param [String] fields
2327
+ # Selector specifying which fields to include in a partial response.
2328
+ # @param [String] quota_user
2329
+ # Available to use for quota purposes for server-side applications. Can be any
2330
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2331
+ # @param [Google::Apis::RequestOptions] options
2332
+ # Request-specific options
2333
+ #
2334
+ # @yield [result, err] Result & error if block supplied
2335
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
2336
+ # @yieldparam err [StandardError] error object if request failed
2337
+ #
2338
+ # @return [Google::Apis::LoggingV2::Operation]
2339
+ #
2340
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2341
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2342
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2343
+ def get_folder_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
2344
+ command = make_simple_command(:get, 'v2/{+name}', options)
2345
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
2346
+ command.response_class = Google::Apis::LoggingV2::Operation
2347
+ command.params['name'] = name unless name.nil?
2348
+ command.query['fields'] = fields unless fields.nil?
2349
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2350
+ execute_or_queue_command(command, &block)
2351
+ end
2352
+
2353
+ # Lists operations that match the specified filter in the request. If the server
2354
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
2355
+ # allows API services to override the binding to use different resource name
2356
+ # schemes, such as users/*/operations. To override the binding, API services can
2357
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
2358
+ # configuration. For backwards compatibility, the default name includes the
2359
+ # operations collection id, however overriding users must ensure the name
2360
+ # binding is the parent resource, without the operations collection id.
2361
+ # @param [String] name
2362
+ # The name of the operation's parent resource.
2363
+ # @param [String] filter
2364
+ # The standard list filter.
2365
+ # @param [Fixnum] page_size
2366
+ # The standard list page size.
2367
+ # @param [String] page_token
2368
+ # The standard list page token.
2369
+ # @param [String] fields
2370
+ # Selector specifying which fields to include in a partial response.
2371
+ # @param [String] quota_user
2372
+ # Available to use for quota purposes for server-side applications. Can be any
2373
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2374
+ # @param [Google::Apis::RequestOptions] options
2375
+ # Request-specific options
2376
+ #
2377
+ # @yield [result, err] Result & error if block supplied
2378
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
2379
+ # @yieldparam err [StandardError] error object if request failed
2380
+ #
2381
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
2382
+ #
2383
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2384
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2385
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2386
+ def list_folder_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2387
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
2388
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
2389
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
2390
+ command.params['name'] = name unless name.nil?
2391
+ command.query['filter'] = filter unless filter.nil?
2392
+ command.query['pageSize'] = page_size unless page_size.nil?
2393
+ command.query['pageToken'] = page_token unless page_token.nil?
2394
+ command.query['fields'] = fields unless fields.nil?
2395
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2396
+ execute_or_queue_command(command, &block)
2397
+ end
2398
+
2129
2399
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
2130
2400
  # reappears if it receives new entries. Log entries written shortly before the
2131
2401
  # delete operation might not be deleted. Entries received after the delete
@@ -2225,14 +2495,14 @@ module Google
2225
2495
  # @param [String] parent
2226
2496
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
2227
2497
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
2228
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
2229
- # 123456789".
2498
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
2499
+ # 123456789"
2230
2500
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2231
2501
  # @param [Boolean] unique_writer_identity
2232
2502
  # Optional. Determines the kind of IAM identity returned as writer_identity in
2233
2503
  # the new sink. If this value is omitted or set to false, and if the sink's
2234
2504
  # 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
2505
+ # group or service account used by Cloud Logging before the addition of writer
2236
2506
  # identities to this API. The sink's destination must be in the same project as
2237
2507
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
2238
2508
  # project resource such as an organization, then the value of writer_identity
@@ -2274,8 +2544,8 @@ module Google
2274
2544
  # Required. The full resource name of the sink to delete, including the parent
2275
2545
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2276
2546
  # 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".
2547
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2548
+ # example:"projects/my-project/sinks/my-sink"
2279
2549
  # @param [String] fields
2280
2550
  # Selector specifying which fields to include in a partial response.
2281
2551
  # @param [String] quota_user
@@ -2307,8 +2577,8 @@ module Google
2307
2577
  # @param [String] sink_name
2308
2578
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
2309
2579
  # " "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".
2580
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2581
+ # example:"projects/my-project/sinks/my-sink"
2312
2582
  # @param [String] fields
2313
2583
  # Selector specifying which fields to include in a partial response.
2314
2584
  # @param [String] quota_user
@@ -2386,8 +2656,8 @@ module Google
2386
2656
  # Required. The full resource name of the sink to update, including the parent
2387
2657
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2388
2658
  # 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".
2659
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2660
+ # example:"projects/my-project/sinks/my-sink"
2391
2661
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2392
2662
  # @param [Boolean] unique_writer_identity
2393
2663
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2403,10 +2673,11 @@ module Google
2403
2673
  # sink field will be overwritten if, and only if, it is in the update mask. name
2404
2674
  # and output only fields cannot be updated.An empty updateMask is temporarily
2405
2675
  # treated as using the following mask for backwards compatibility purposes:
2406
- # destination,filter,includeChildren At some point in the future, behavior will
2676
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2407
2677
  # be removed and specifying an empty updateMask will be an error.For a detailed
2408
2678
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2409
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2679
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2680
+ # filter
2410
2681
  # @param [String] fields
2411
2682
  # Selector specifying which fields to include in a partial response.
2412
2683
  # @param [String] quota_user
@@ -2445,8 +2716,8 @@ module Google
2445
2716
  # Required. The full resource name of the sink to update, including the parent
2446
2717
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2447
2718
  # 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".
2719
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2720
+ # example:"projects/my-project/sinks/my-sink"
2450
2721
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2451
2722
  # @param [Boolean] unique_writer_identity
2452
2723
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2462,10 +2733,11 @@ module Google
2462
2733
  # sink field will be overwritten if, and only if, it is in the update mask. name
2463
2734
  # and output only fields cannot be updated.An empty updateMask is temporarily
2464
2735
  # treated as using the following mask for backwards compatibility purposes:
2465
- # destination,filter,includeChildren At some point in the future, behavior will
2736
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2466
2737
  # be removed and specifying an empty updateMask will be an error.For a detailed
2467
2738
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2468
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2739
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2740
+ # filter
2469
2741
  # @param [String] fields
2470
2742
  # Selector specifying which fields to include in a partial response.
2471
2743
  # @param [String] quota_user
@@ -2570,12 +2842,12 @@ module Google
2570
2842
  execute_or_queue_command(command, &block)
2571
2843
  end
2572
2844
 
2573
- # Creates a bucket that can be used to store log entries. Once a bucket has been
2574
- # created, the region cannot be changed.
2845
+ # Creates a log bucket that can be used to store log entries. After a bucket has
2846
+ # been created, the bucket's location cannot be changed.
2575
2847
  # @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"
2848
+ # Required. The resource in which to create the log bucket: "projects/[
2849
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
2850
+ # locations/global"
2579
2851
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2580
2852
  # @param [String] bucket_id
2581
2853
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -2611,16 +2883,16 @@ module Google
2611
2883
  execute_or_queue_command(command, &block)
2612
2884
  end
2613
2885
 
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.
2886
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
2887
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
2888
+ # entries in the bucket will be permanently deleted.
2617
2889
  # @param [String] name
2618
2890
  # Required. The full resource name of the bucket to delete. "projects/[
2619
2891
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2620
2892
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2621
2893
  # [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".
2894
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2895
+ # my-project/locations/global/buckets/my-bucket"
2624
2896
  # @param [String] fields
2625
2897
  # Selector specifying which fields to include in a partial response.
2626
2898
  # @param [String] quota_user
@@ -2648,14 +2920,14 @@ module Google
2648
2920
  execute_or_queue_command(command, &block)
2649
2921
  end
2650
2922
 
2651
- # Gets a bucket.
2923
+ # Gets a log bucket.
2652
2924
  # @param [String] name
2653
2925
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
2654
2926
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
2655
2927
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
2656
2928
  # 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".
2929
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
2930
+ # global/buckets/my-bucket"
2659
2931
  # @param [String] fields
2660
2932
  # Selector specifying which fields to include in a partial response.
2661
2933
  # @param [String] quota_user
@@ -2683,7 +2955,7 @@ module Google
2683
2955
  execute_or_queue_command(command, &block)
2684
2956
  end
2685
2957
 
2686
- # Lists buckets.
2958
+ # Lists log buckets.
2687
2959
  # @param [String] parent
2688
2960
  # Required. The parent resource whose buckets are to be listed: "projects/[
2689
2961
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -2729,27 +3001,27 @@ module Google
2729
3001
  execute_or_queue_command(command, &block)
2730
3002
  end
2731
3003
 
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.
3004
+ # Updates a log bucket. This method replaces the following fields in the
3005
+ # existing bucket with values from the new bucket: retention_periodIf the
3006
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
3007
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
3008
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
3009
+ # bucket's location cannot be changed.
2738
3010
  # @param [String] name
2739
3011
  # Required. The full resource name of the bucket to update. "projects/[
2740
3012
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2741
3013
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2742
3014
  # [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
3015
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3016
+ # my-project/locations/global/buckets/my-bucket"
2746
3017
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2747
3018
  # @param [String] update_mask
2748
3019
  # Required. Field mask that specifies the fields in bucket that need an update.
2749
3020
  # A bucket field will be overwritten if, and only if, it is in the update mask.
2750
3021
  # 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.
3022
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
3023
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
3024
+ # retention_days
2753
3025
  # @param [String] fields
2754
3026
  # Selector specifying which fields to include in a partial response.
2755
3027
  # @param [String] quota_user
@@ -2780,15 +3052,15 @@ module Google
2780
3052
  execute_or_queue_command(command, &block)
2781
3053
  end
2782
3054
 
2783
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
2784
- # grace period of 7 days.
3055
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
3056
+ # the grace period of 7 days.
2785
3057
  # @param [String] name
2786
3058
  # Required. The full resource name of the bucket to undelete. "projects/[
2787
3059
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2788
3060
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2789
3061
  # [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".
3062
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3063
+ # my-project/locations/global/buckets/my-bucket"
2792
3064
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
2793
3065
  # @param [String] fields
2794
3066
  # Selector specifying which fields to include in a partial response.
@@ -2819,12 +3091,12 @@ module Google
2819
3091
  execute_or_queue_command(command, &block)
2820
3092
  end
2821
3093
 
2822
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
2823
- # views.
3094
+ # Creates a view over log entries in a log bucket. A bucket may contain a
3095
+ # maximum of 30 views.
2824
3096
  # @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"
3097
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
3098
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
3099
+ # locations/global/buckets/my-bucket"
2828
3100
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2829
3101
  # @param [String] view_id
2830
3102
  # Required. The id to use for this view.
@@ -2858,12 +3130,13 @@ module Google
2858
3130
  execute_or_queue_command(command, &block)
2859
3131
  end
2860
3132
 
2861
- # Deletes a view from a bucket.
3133
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
3134
+ # indicates that system is not in a state where it can delete the view. If this
3135
+ # occurs, please try again in a few minutes.
2862
3136
  # @param [String] name
2863
3137
  # 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".
3138
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3139
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2867
3140
  # @param [String] fields
2868
3141
  # Selector specifying which fields to include in a partial response.
2869
3142
  # @param [String] quota_user
@@ -2891,11 +3164,11 @@ module Google
2891
3164
  execute_or_queue_command(command, &block)
2892
3165
  end
2893
3166
 
2894
- # Gets a view.
3167
+ # Gets a view on a log bucket..
2895
3168
  # @param [String] name
2896
3169
  # 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".
3170
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
3171
+ # project/locations/global/buckets/my-bucket/views/my-view"
2899
3172
  # @param [String] fields
2900
3173
  # Selector specifying which fields to include in a partial response.
2901
3174
  # @param [String] quota_user
@@ -2923,12 +3196,12 @@ module Google
2923
3196
  execute_or_queue_command(command, &block)
2924
3197
  end
2925
3198
 
2926
- # Lists views on a bucket.
3199
+ # Lists views on a log bucket.
2927
3200
  # @param [String] parent
2928
3201
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
2929
3202
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2930
3203
  # @param [Fixnum] page_size
2931
- # Optional. The maximum number of results to return from this request. Non-
3204
+ # Optional. The maximum number of results to return from this request.Non-
2932
3205
  # positive values are ignored. The presence of nextPageToken in the response
2933
3206
  # indicates that more results might be available.
2934
3207
  # @param [String] page_token
@@ -2965,20 +3238,21 @@ module Google
2965
3238
  execute_or_queue_command(command, &block)
2966
3239
  end
2967
3240
 
2968
- # Updates a view. This method replaces the following fields in the existing view
2969
- # with values from the new view: filter.
3241
+ # Updates a view on a log bucket. This method replaces the following fields in
3242
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
3243
+ # error is returned, this indicates that system is not in a state where it can
3244
+ # update the view. If this occurs, please try again in a few minutes.
2970
3245
  # @param [String] name
2971
3246
  # 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".
3247
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3248
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2975
3249
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2976
3250
  # @param [String] update_mask
2977
3251
  # Optional. Field mask that specifies the fields in view that need an update. A
2978
3252
  # field will be overwritten if, and only if, it is in the update mask. name and
2979
3253
  # output only fields cannot be updated.For a detailed FieldMask definition, see
2980
3254
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
2981
- # google.protobuf.FieldMaskExample: updateMask=filter.
3255
+ # google.protobuf.FieldMaskFor example: updateMask=filter
2982
3256
  # @param [String] fields
2983
3257
  # Selector specifying which fields to include in a partial response.
2984
3258
  # @param [String] quota_user
@@ -3009,6 +3283,123 @@ module Google
3009
3283
  execute_or_queue_command(command, &block)
3010
3284
  end
3011
3285
 
3286
+ # Starts asynchronous cancellation on a long-running operation. The server makes
3287
+ # a best effort to cancel the operation, but success is not guaranteed. If the
3288
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
3289
+ # Clients can use Operations.GetOperation or other methods to check whether the
3290
+ # cancellation succeeded or whether the operation completed despite cancellation.
3291
+ # On successful cancellation, the operation is not deleted; instead, it becomes
3292
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
3293
+ # corresponding to Code.CANCELLED.
3294
+ # @param [String] name
3295
+ # The name of the operation resource to be cancelled.
3296
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
3297
+ # @param [String] fields
3298
+ # Selector specifying which fields to include in a partial response.
3299
+ # @param [String] quota_user
3300
+ # Available to use for quota purposes for server-side applications. Can be any
3301
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3302
+ # @param [Google::Apis::RequestOptions] options
3303
+ # Request-specific options
3304
+ #
3305
+ # @yield [result, err] Result & error if block supplied
3306
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
3307
+ # @yieldparam err [StandardError] error object if request failed
3308
+ #
3309
+ # @return [Google::Apis::LoggingV2::Empty]
3310
+ #
3311
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3312
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3313
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3314
+ def cancel_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3315
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
3316
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
3317
+ command.request_object = cancel_operation_request_object
3318
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
3319
+ command.response_class = Google::Apis::LoggingV2::Empty
3320
+ command.params['name'] = name unless name.nil?
3321
+ command.query['fields'] = fields unless fields.nil?
3322
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3323
+ execute_or_queue_command(command, &block)
3324
+ end
3325
+
3326
+ # Gets the latest state of a long-running operation. Clients can use this method
3327
+ # to poll the operation result at intervals as recommended by the API service.
3328
+ # @param [String] name
3329
+ # The name of the operation resource.
3330
+ # @param [String] fields
3331
+ # Selector specifying which fields to include in a partial response.
3332
+ # @param [String] quota_user
3333
+ # Available to use for quota purposes for server-side applications. Can be any
3334
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3335
+ # @param [Google::Apis::RequestOptions] options
3336
+ # Request-specific options
3337
+ #
3338
+ # @yield [result, err] Result & error if block supplied
3339
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
3340
+ # @yieldparam err [StandardError] error object if request failed
3341
+ #
3342
+ # @return [Google::Apis::LoggingV2::Operation]
3343
+ #
3344
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3345
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3346
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3347
+ def get_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
3348
+ command = make_simple_command(:get, 'v2/{+name}', options)
3349
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
3350
+ command.response_class = Google::Apis::LoggingV2::Operation
3351
+ command.params['name'] = name unless name.nil?
3352
+ command.query['fields'] = fields unless fields.nil?
3353
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3354
+ execute_or_queue_command(command, &block)
3355
+ end
3356
+
3357
+ # Lists operations that match the specified filter in the request. If the server
3358
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
3359
+ # allows API services to override the binding to use different resource name
3360
+ # schemes, such as users/*/operations. To override the binding, API services can
3361
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
3362
+ # configuration. For backwards compatibility, the default name includes the
3363
+ # operations collection id, however overriding users must ensure the name
3364
+ # binding is the parent resource, without the operations collection id.
3365
+ # @param [String] name
3366
+ # The name of the operation's parent resource.
3367
+ # @param [String] filter
3368
+ # The standard list filter.
3369
+ # @param [Fixnum] page_size
3370
+ # The standard list page size.
3371
+ # @param [String] page_token
3372
+ # The standard list page token.
3373
+ # @param [String] fields
3374
+ # Selector specifying which fields to include in a partial response.
3375
+ # @param [String] quota_user
3376
+ # Available to use for quota purposes for server-side applications. Can be any
3377
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3378
+ # @param [Google::Apis::RequestOptions] options
3379
+ # Request-specific options
3380
+ #
3381
+ # @yield [result, err] Result & error if block supplied
3382
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
3383
+ # @yieldparam err [StandardError] error object if request failed
3384
+ #
3385
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
3386
+ #
3387
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3388
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3389
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3390
+ def list_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3391
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
3392
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
3393
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
3394
+ command.params['name'] = name unless name.nil?
3395
+ command.query['filter'] = filter unless filter.nil?
3396
+ command.query['pageSize'] = page_size unless page_size.nil?
3397
+ command.query['pageToken'] = page_token unless page_token.nil?
3398
+ command.query['fields'] = fields unless fields.nil?
3399
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3400
+ execute_or_queue_command(command, &block)
3401
+ end
3402
+
3012
3403
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
3013
3404
  # reappears if it receives new entries. Log entries written shortly before the
3014
3405
  # delete operation might not be deleted. Entries received after the delete
@@ -3148,7 +3539,7 @@ module Google
3148
3539
  # Required. The resource for which to retrieve CMEK settings. "projects/[
3149
3540
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3150
3541
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3151
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3542
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3152
3543
  # Logs Router can currently only be configured for GCP organizations. Once
3153
3544
  # configured, it applies to all projects and folders in the GCP organization.
3154
3545
  # @param [String] fields
@@ -3190,15 +3581,15 @@ module Google
3190
3581
  # Required. The resource name for the CMEK settings to update. "projects/[
3191
3582
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3192
3583
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3193
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3584
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3194
3585
  # Logs Router can currently only be configured for GCP organizations. Once
3195
3586
  # configured, it applies to all projects and folders in the GCP organization.
3196
3587
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
3197
3588
  # @param [String] update_mask
3198
3589
  # Optional. Field mask identifying which fields from cmek_settings should be
3199
3590
  # 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"
3591
+ # Output only fields cannot be updated.See FieldMask for more information.For
3592
+ # example: "updateMask=kmsKeyName"
3202
3593
  # @param [String] fields
3203
3594
  # Selector specifying which fields to include in a partial response.
3204
3595
  # @param [String] quota_user
@@ -3235,8 +3626,8 @@ module Google
3235
3626
  # @param [String] parent
3236
3627
  # Required. The parent resource in which to create the exclusion: "projects/[
3237
3628
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
3238
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
3239
- # project", "organizations/123456789".
3629
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
3630
+ # project" "organizations/123456789"
3240
3631
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3241
3632
  # @param [String] fields
3242
3633
  # Selector specifying which fields to include in a partial response.
@@ -3272,8 +3663,8 @@ module Google
3272
3663
  # Required. The resource name of an existing exclusion to delete: "projects/[
3273
3664
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
3274
3665
  # 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".
3666
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
3667
+ # projects/my-project/exclusions/my-exclusion"
3277
3668
  # @param [String] fields
3278
3669
  # Selector specifying which fields to include in a partial response.
3279
3670
  # @param [String] quota_user
@@ -3306,8 +3697,8 @@ module Google
3306
3697
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
3307
3698
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3308
3699
  # 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".
3700
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3701
+ # project/exclusions/my-exclusion"
3311
3702
  # @param [String] fields
3312
3703
  # Selector specifying which fields to include in a partial response.
3313
3704
  # @param [String] quota_user
@@ -3383,8 +3774,8 @@ module Google
3383
3774
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
3384
3775
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3385
3776
  # 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".
3777
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3778
+ # project/exclusions/my-exclusion"
3388
3779
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3389
3780
  # @param [String] update_mask
3390
3781
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -3496,12 +3887,12 @@ module Google
3496
3887
  execute_or_queue_command(command, &block)
3497
3888
  end
3498
3889
 
3499
- # Creates a bucket that can be used to store log entries. Once a bucket has been
3500
- # created, the region cannot be changed.
3890
+ # Creates a log bucket that can be used to store log entries. After a bucket has
3891
+ # been created, the bucket's location cannot be changed.
3501
3892
  # @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"
3893
+ # Required. The resource in which to create the log bucket: "projects/[
3894
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
3895
+ # locations/global"
3505
3896
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3506
3897
  # @param [String] bucket_id
3507
3898
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -3537,16 +3928,16 @@ module Google
3537
3928
  execute_or_queue_command(command, &block)
3538
3929
  end
3539
3930
 
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.
3931
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
3932
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
3933
+ # entries in the bucket will be permanently deleted.
3543
3934
  # @param [String] name
3544
3935
  # Required. The full resource name of the bucket to delete. "projects/[
3545
3936
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3546
3937
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3547
3938
  # [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".
3939
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3940
+ # my-project/locations/global/buckets/my-bucket"
3550
3941
  # @param [String] fields
3551
3942
  # Selector specifying which fields to include in a partial response.
3552
3943
  # @param [String] quota_user
@@ -3574,14 +3965,14 @@ module Google
3574
3965
  execute_or_queue_command(command, &block)
3575
3966
  end
3576
3967
 
3577
- # Gets a bucket.
3968
+ # Gets a log bucket.
3578
3969
  # @param [String] name
3579
3970
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
3580
3971
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
3581
3972
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
3582
3973
  # 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".
3974
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
3975
+ # global/buckets/my-bucket"
3585
3976
  # @param [String] fields
3586
3977
  # Selector specifying which fields to include in a partial response.
3587
3978
  # @param [String] quota_user
@@ -3609,7 +4000,7 @@ module Google
3609
4000
  execute_or_queue_command(command, &block)
3610
4001
  end
3611
4002
 
3612
- # Lists buckets.
4003
+ # Lists log buckets.
3613
4004
  # @param [String] parent
3614
4005
  # Required. The parent resource whose buckets are to be listed: "projects/[
3615
4006
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -3655,27 +4046,27 @@ module Google
3655
4046
  execute_or_queue_command(command, &block)
3656
4047
  end
3657
4048
 
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.
4049
+ # Updates a log bucket. This method replaces the following fields in the
4050
+ # existing bucket with values from the new bucket: retention_periodIf the
4051
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
4052
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
4053
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
4054
+ # bucket's location cannot be changed.
3664
4055
  # @param [String] name
3665
4056
  # Required. The full resource name of the bucket to update. "projects/[
3666
4057
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3667
4058
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3668
4059
  # [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
4060
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4061
+ # my-project/locations/global/buckets/my-bucket"
3672
4062
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3673
4063
  # @param [String] update_mask
3674
4064
  # Required. Field mask that specifies the fields in bucket that need an update.
3675
4065
  # A bucket field will be overwritten if, and only if, it is in the update mask.
3676
4066
  # 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.
4067
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
4068
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4069
+ # retention_days
3679
4070
  # @param [String] fields
3680
4071
  # Selector specifying which fields to include in a partial response.
3681
4072
  # @param [String] quota_user
@@ -3706,15 +4097,15 @@ module Google
3706
4097
  execute_or_queue_command(command, &block)
3707
4098
  end
3708
4099
 
3709
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
3710
- # grace period of 7 days.
4100
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
4101
+ # the grace period of 7 days.
3711
4102
  # @param [String] name
3712
4103
  # Required. The full resource name of the bucket to undelete. "projects/[
3713
4104
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3714
4105
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3715
4106
  # [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".
4107
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4108
+ # my-project/locations/global/buckets/my-bucket"
3718
4109
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
3719
4110
  # @param [String] fields
3720
4111
  # Selector specifying which fields to include in a partial response.
@@ -3745,12 +4136,12 @@ module Google
3745
4136
  execute_or_queue_command(command, &block)
3746
4137
  end
3747
4138
 
3748
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
3749
- # views.
4139
+ # Creates a view over log entries in a log bucket. A bucket may contain a
4140
+ # maximum of 30 views.
3750
4141
  # @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"
4142
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
4143
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
4144
+ # locations/global/buckets/my-bucket"
3754
4145
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3755
4146
  # @param [String] view_id
3756
4147
  # Required. The id to use for this view.
@@ -3784,12 +4175,13 @@ module Google
3784
4175
  execute_or_queue_command(command, &block)
3785
4176
  end
3786
4177
 
3787
- # Deletes a view from a bucket.
4178
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
4179
+ # indicates that system is not in a state where it can delete the view. If this
4180
+ # occurs, please try again in a few minutes.
3788
4181
  # @param [String] name
3789
4182
  # 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".
4183
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4184
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3793
4185
  # @param [String] fields
3794
4186
  # Selector specifying which fields to include in a partial response.
3795
4187
  # @param [String] quota_user
@@ -3817,11 +4209,11 @@ module Google
3817
4209
  execute_or_queue_command(command, &block)
3818
4210
  end
3819
4211
 
3820
- # Gets a view.
4212
+ # Gets a view on a log bucket..
3821
4213
  # @param [String] name
3822
4214
  # 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".
4215
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
4216
+ # project/locations/global/buckets/my-bucket/views/my-view"
3825
4217
  # @param [String] fields
3826
4218
  # Selector specifying which fields to include in a partial response.
3827
4219
  # @param [String] quota_user
@@ -3849,12 +4241,12 @@ module Google
3849
4241
  execute_or_queue_command(command, &block)
3850
4242
  end
3851
4243
 
3852
- # Lists views on a bucket.
4244
+ # Lists views on a log bucket.
3853
4245
  # @param [String] parent
3854
4246
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
3855
4247
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
3856
4248
  # @param [Fixnum] page_size
3857
- # Optional. The maximum number of results to return from this request. Non-
4249
+ # Optional. The maximum number of results to return from this request.Non-
3858
4250
  # positive values are ignored. The presence of nextPageToken in the response
3859
4251
  # indicates that more results might be available.
3860
4252
  # @param [String] page_token
@@ -3891,20 +4283,21 @@ module Google
3891
4283
  execute_or_queue_command(command, &block)
3892
4284
  end
3893
4285
 
3894
- # Updates a view. This method replaces the following fields in the existing view
3895
- # with values from the new view: filter.
4286
+ # Updates a view on a log bucket. This method replaces the following fields in
4287
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
4288
+ # error is returned, this indicates that system is not in a state where it can
4289
+ # update the view. If this occurs, please try again in a few minutes.
3896
4290
  # @param [String] name
3897
4291
  # 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".
4292
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4293
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3901
4294
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3902
4295
  # @param [String] update_mask
3903
4296
  # Optional. Field mask that specifies the fields in view that need an update. A
3904
4297
  # field will be overwritten if, and only if, it is in the update mask. name and
3905
4298
  # output only fields cannot be updated.For a detailed FieldMask definition, see
3906
4299
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
3907
- # google.protobuf.FieldMaskExample: updateMask=filter.
4300
+ # google.protobuf.FieldMaskFor example: updateMask=filter
3908
4301
  # @param [String] fields
3909
4302
  # Selector specifying which fields to include in a partial response.
3910
4303
  # @param [String] quota_user
@@ -3935,6 +4328,123 @@ module Google
3935
4328
  execute_or_queue_command(command, &block)
3936
4329
  end
3937
4330
 
4331
+ # Starts asynchronous cancellation on a long-running operation. The server makes
4332
+ # a best effort to cancel the operation, but success is not guaranteed. If the
4333
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
4334
+ # Clients can use Operations.GetOperation or other methods to check whether the
4335
+ # cancellation succeeded or whether the operation completed despite cancellation.
4336
+ # On successful cancellation, the operation is not deleted; instead, it becomes
4337
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
4338
+ # corresponding to Code.CANCELLED.
4339
+ # @param [String] name
4340
+ # The name of the operation resource to be cancelled.
4341
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
4342
+ # @param [String] fields
4343
+ # Selector specifying which fields to include in a partial response.
4344
+ # @param [String] quota_user
4345
+ # Available to use for quota purposes for server-side applications. Can be any
4346
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4347
+ # @param [Google::Apis::RequestOptions] options
4348
+ # Request-specific options
4349
+ #
4350
+ # @yield [result, err] Result & error if block supplied
4351
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
4352
+ # @yieldparam err [StandardError] error object if request failed
4353
+ #
4354
+ # @return [Google::Apis::LoggingV2::Empty]
4355
+ #
4356
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4357
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4358
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4359
+ def cancel_organization_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4360
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
4361
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
4362
+ command.request_object = cancel_operation_request_object
4363
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
4364
+ command.response_class = Google::Apis::LoggingV2::Empty
4365
+ command.params['name'] = name unless name.nil?
4366
+ command.query['fields'] = fields unless fields.nil?
4367
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4368
+ execute_or_queue_command(command, &block)
4369
+ end
4370
+
4371
+ # Gets the latest state of a long-running operation. Clients can use this method
4372
+ # to poll the operation result at intervals as recommended by the API service.
4373
+ # @param [String] name
4374
+ # The name of the operation resource.
4375
+ # @param [String] fields
4376
+ # Selector specifying which fields to include in a partial response.
4377
+ # @param [String] quota_user
4378
+ # Available to use for quota purposes for server-side applications. Can be any
4379
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4380
+ # @param [Google::Apis::RequestOptions] options
4381
+ # Request-specific options
4382
+ #
4383
+ # @yield [result, err] Result & error if block supplied
4384
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
4385
+ # @yieldparam err [StandardError] error object if request failed
4386
+ #
4387
+ # @return [Google::Apis::LoggingV2::Operation]
4388
+ #
4389
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4390
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4391
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4392
+ def get_organization_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
4393
+ command = make_simple_command(:get, 'v2/{+name}', options)
4394
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
4395
+ command.response_class = Google::Apis::LoggingV2::Operation
4396
+ command.params['name'] = name unless name.nil?
4397
+ command.query['fields'] = fields unless fields.nil?
4398
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4399
+ execute_or_queue_command(command, &block)
4400
+ end
4401
+
4402
+ # Lists operations that match the specified filter in the request. If the server
4403
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
4404
+ # allows API services to override the binding to use different resource name
4405
+ # schemes, such as users/*/operations. To override the binding, API services can
4406
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
4407
+ # configuration. For backwards compatibility, the default name includes the
4408
+ # operations collection id, however overriding users must ensure the name
4409
+ # binding is the parent resource, without the operations collection id.
4410
+ # @param [String] name
4411
+ # The name of the operation's parent resource.
4412
+ # @param [String] filter
4413
+ # The standard list filter.
4414
+ # @param [Fixnum] page_size
4415
+ # The standard list page size.
4416
+ # @param [String] page_token
4417
+ # The standard list page token.
4418
+ # @param [String] fields
4419
+ # Selector specifying which fields to include in a partial response.
4420
+ # @param [String] quota_user
4421
+ # Available to use for quota purposes for server-side applications. Can be any
4422
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4423
+ # @param [Google::Apis::RequestOptions] options
4424
+ # Request-specific options
4425
+ #
4426
+ # @yield [result, err] Result & error if block supplied
4427
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
4428
+ # @yieldparam err [StandardError] error object if request failed
4429
+ #
4430
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
4431
+ #
4432
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4433
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4434
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4435
+ def list_organization_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4436
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
4437
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
4438
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
4439
+ command.params['name'] = name unless name.nil?
4440
+ command.query['filter'] = filter unless filter.nil?
4441
+ command.query['pageSize'] = page_size unless page_size.nil?
4442
+ command.query['pageToken'] = page_token unless page_token.nil?
4443
+ command.query['fields'] = fields unless fields.nil?
4444
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4445
+ execute_or_queue_command(command, &block)
4446
+ end
4447
+
3938
4448
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
3939
4449
  # reappears if it receives new entries. Log entries written shortly before the
3940
4450
  # delete operation might not be deleted. Entries received after the delete
@@ -4034,14 +4544,14 @@ module Google
4034
4544
  # @param [String] parent
4035
4545
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
4036
4546
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
4037
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
4038
- # 123456789".
4547
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
4548
+ # 123456789"
4039
4549
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4040
4550
  # @param [Boolean] unique_writer_identity
4041
4551
  # Optional. Determines the kind of IAM identity returned as writer_identity in
4042
4552
  # the new sink. If this value is omitted or set to false, and if the sink's
4043
4553
  # 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
4554
+ # group or service account used by Cloud Logging before the addition of writer
4045
4555
  # identities to this API. The sink's destination must be in the same project as
4046
4556
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
4047
4557
  # project resource such as an organization, then the value of writer_identity
@@ -4083,8 +4593,8 @@ module Google
4083
4593
  # Required. The full resource name of the sink to delete, including the parent
4084
4594
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4085
4595
  # 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".
4596
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4597
+ # example:"projects/my-project/sinks/my-sink"
4088
4598
  # @param [String] fields
4089
4599
  # Selector specifying which fields to include in a partial response.
4090
4600
  # @param [String] quota_user
@@ -4116,8 +4626,8 @@ module Google
4116
4626
  # @param [String] sink_name
4117
4627
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
4118
4628
  # " "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".
4629
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4630
+ # example:"projects/my-project/sinks/my-sink"
4121
4631
  # @param [String] fields
4122
4632
  # Selector specifying which fields to include in a partial response.
4123
4633
  # @param [String] quota_user
@@ -4195,8 +4705,8 @@ module Google
4195
4705
  # Required. The full resource name of the sink to update, including the parent
4196
4706
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4197
4707
  # 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".
4708
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4709
+ # example:"projects/my-project/sinks/my-sink"
4200
4710
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4201
4711
  # @param [Boolean] unique_writer_identity
4202
4712
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4212,10 +4722,11 @@ module Google
4212
4722
  # sink field will be overwritten if, and only if, it is in the update mask. name
4213
4723
  # and output only fields cannot be updated.An empty updateMask is temporarily
4214
4724
  # treated as using the following mask for backwards compatibility purposes:
4215
- # destination,filter,includeChildren At some point in the future, behavior will
4725
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4216
4726
  # be removed and specifying an empty updateMask will be an error.For a detailed
4217
4727
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4218
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4728
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4729
+ # filter
4219
4730
  # @param [String] fields
4220
4731
  # Selector specifying which fields to include in a partial response.
4221
4732
  # @param [String] quota_user
@@ -4254,8 +4765,8 @@ module Google
4254
4765
  # Required. The full resource name of the sink to update, including the parent
4255
4766
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4256
4767
  # 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".
4768
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4769
+ # example:"projects/my-project/sinks/my-sink"
4259
4770
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4260
4771
  # @param [Boolean] unique_writer_identity
4261
4772
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4271,10 +4782,11 @@ module Google
4271
4782
  # sink field will be overwritten if, and only if, it is in the update mask. name
4272
4783
  # and output only fields cannot be updated.An empty updateMask is temporarily
4273
4784
  # treated as using the following mask for backwards compatibility purposes:
4274
- # destination,filter,includeChildren At some point in the future, behavior will
4785
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4275
4786
  # be removed and specifying an empty updateMask will be an error.For a detailed
4276
4787
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4277
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4788
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4789
+ # filter
4278
4790
  # @param [String] fields
4279
4791
  # Selector specifying which fields to include in a partial response.
4280
4792
  # @param [String] quota_user
@@ -4312,8 +4824,8 @@ module Google
4312
4824
  # @param [String] parent
4313
4825
  # Required. The parent resource in which to create the exclusion: "projects/[
4314
4826
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
4315
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
4316
- # project", "organizations/123456789".
4827
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
4828
+ # project" "organizations/123456789"
4317
4829
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4318
4830
  # @param [String] fields
4319
4831
  # Selector specifying which fields to include in a partial response.
@@ -4349,8 +4861,8 @@ module Google
4349
4861
  # Required. The resource name of an existing exclusion to delete: "projects/[
4350
4862
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
4351
4863
  # 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".
4864
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
4865
+ # projects/my-project/exclusions/my-exclusion"
4354
4866
  # @param [String] fields
4355
4867
  # Selector specifying which fields to include in a partial response.
4356
4868
  # @param [String] quota_user
@@ -4383,8 +4895,8 @@ module Google
4383
4895
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
4384
4896
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4385
4897
  # 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".
4898
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4899
+ # project/exclusions/my-exclusion"
4388
4900
  # @param [String] fields
4389
4901
  # Selector specifying which fields to include in a partial response.
4390
4902
  # @param [String] quota_user
@@ -4460,8 +4972,8 @@ module Google
4460
4972
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
4461
4973
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4462
4974
  # 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".
4975
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4976
+ # project/exclusions/my-exclusion"
4465
4977
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4466
4978
  # @param [String] update_mask
4467
4979
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -4573,12 +5085,12 @@ module Google
4573
5085
  execute_or_queue_command(command, &block)
4574
5086
  end
4575
5087
 
4576
- # Creates a bucket that can be used to store log entries. Once a bucket has been
4577
- # created, the region cannot be changed.
5088
+ # Creates a log bucket that can be used to store log entries. After a bucket has
5089
+ # been created, the bucket's location cannot be changed.
4578
5090
  # @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"
5091
+ # Required. The resource in which to create the log bucket: "projects/[
5092
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
5093
+ # locations/global"
4582
5094
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4583
5095
  # @param [String] bucket_id
4584
5096
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -4614,16 +5126,16 @@ module Google
4614
5126
  execute_or_queue_command(command, &block)
4615
5127
  end
4616
5128
 
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.
5129
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
5130
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
5131
+ # entries in the bucket will be permanently deleted.
4620
5132
  # @param [String] name
4621
5133
  # Required. The full resource name of the bucket to delete. "projects/[
4622
5134
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4623
5135
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4624
5136
  # [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".
5137
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5138
+ # my-project/locations/global/buckets/my-bucket"
4627
5139
  # @param [String] fields
4628
5140
  # Selector specifying which fields to include in a partial response.
4629
5141
  # @param [String] quota_user
@@ -4651,14 +5163,14 @@ module Google
4651
5163
  execute_or_queue_command(command, &block)
4652
5164
  end
4653
5165
 
4654
- # Gets a bucket.
5166
+ # Gets a log bucket.
4655
5167
  # @param [String] name
4656
5168
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
4657
5169
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
4658
5170
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
4659
5171
  # 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".
5172
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
5173
+ # global/buckets/my-bucket"
4662
5174
  # @param [String] fields
4663
5175
  # Selector specifying which fields to include in a partial response.
4664
5176
  # @param [String] quota_user
@@ -4686,7 +5198,7 @@ module Google
4686
5198
  execute_or_queue_command(command, &block)
4687
5199
  end
4688
5200
 
4689
- # Lists buckets.
5201
+ # Lists log buckets.
4690
5202
  # @param [String] parent
4691
5203
  # Required. The parent resource whose buckets are to be listed: "projects/[
4692
5204
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -4732,27 +5244,27 @@ module Google
4732
5244
  execute_or_queue_command(command, &block)
4733
5245
  end
4734
5246
 
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.
5247
+ # Updates a log bucket. This method replaces the following fields in the
5248
+ # existing bucket with values from the new bucket: retention_periodIf the
5249
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
5250
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
5251
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
5252
+ # bucket's location cannot be changed.
4741
5253
  # @param [String] name
4742
5254
  # Required. The full resource name of the bucket to update. "projects/[
4743
5255
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4744
5256
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4745
5257
  # [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
5258
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5259
+ # my-project/locations/global/buckets/my-bucket"
4749
5260
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4750
5261
  # @param [String] update_mask
4751
5262
  # Required. Field mask that specifies the fields in bucket that need an update.
4752
5263
  # A bucket field will be overwritten if, and only if, it is in the update mask.
4753
5264
  # 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.
5265
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
5266
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
5267
+ # retention_days
4756
5268
  # @param [String] fields
4757
5269
  # Selector specifying which fields to include in a partial response.
4758
5270
  # @param [String] quota_user
@@ -4783,15 +5295,15 @@ module Google
4783
5295
  execute_or_queue_command(command, &block)
4784
5296
  end
4785
5297
 
4786
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
4787
- # grace period of 7 days.
5298
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
5299
+ # the grace period of 7 days.
4788
5300
  # @param [String] name
4789
5301
  # Required. The full resource name of the bucket to undelete. "projects/[
4790
5302
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4791
5303
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4792
5304
  # [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".
5305
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5306
+ # my-project/locations/global/buckets/my-bucket"
4795
5307
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
4796
5308
  # @param [String] fields
4797
5309
  # Selector specifying which fields to include in a partial response.
@@ -4822,12 +5334,12 @@ module Google
4822
5334
  execute_or_queue_command(command, &block)
4823
5335
  end
4824
5336
 
4825
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
4826
- # views.
5337
+ # Creates a view over log entries in a log bucket. A bucket may contain a
5338
+ # maximum of 30 views.
4827
5339
  # @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"
5340
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
5341
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
5342
+ # locations/global/buckets/my-bucket"
4831
5343
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4832
5344
  # @param [String] view_id
4833
5345
  # Required. The id to use for this view.
@@ -4861,12 +5373,13 @@ module Google
4861
5373
  execute_or_queue_command(command, &block)
4862
5374
  end
4863
5375
 
4864
- # Deletes a view from a bucket.
5376
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
5377
+ # indicates that system is not in a state where it can delete the view. If this
5378
+ # occurs, please try again in a few minutes.
4865
5379
  # @param [String] name
4866
5380
  # 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".
5381
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5382
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4870
5383
  # @param [String] fields
4871
5384
  # Selector specifying which fields to include in a partial response.
4872
5385
  # @param [String] quota_user
@@ -4894,11 +5407,11 @@ module Google
4894
5407
  execute_or_queue_command(command, &block)
4895
5408
  end
4896
5409
 
4897
- # Gets a view.
5410
+ # Gets a view on a log bucket..
4898
5411
  # @param [String] name
4899
5412
  # 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".
5413
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
5414
+ # project/locations/global/buckets/my-bucket/views/my-view"
4902
5415
  # @param [String] fields
4903
5416
  # Selector specifying which fields to include in a partial response.
4904
5417
  # @param [String] quota_user
@@ -4926,12 +5439,12 @@ module Google
4926
5439
  execute_or_queue_command(command, &block)
4927
5440
  end
4928
5441
 
4929
- # Lists views on a bucket.
5442
+ # Lists views on a log bucket.
4930
5443
  # @param [String] parent
4931
5444
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
4932
5445
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
4933
5446
  # @param [Fixnum] page_size
4934
- # Optional. The maximum number of results to return from this request. Non-
5447
+ # Optional. The maximum number of results to return from this request.Non-
4935
5448
  # positive values are ignored. The presence of nextPageToken in the response
4936
5449
  # indicates that more results might be available.
4937
5450
  # @param [String] page_token
@@ -4968,20 +5481,21 @@ module Google
4968
5481
  execute_or_queue_command(command, &block)
4969
5482
  end
4970
5483
 
4971
- # Updates a view. This method replaces the following fields in the existing view
4972
- # with values from the new view: filter.
5484
+ # Updates a view on a log bucket. This method replaces the following fields in
5485
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
5486
+ # error is returned, this indicates that system is not in a state where it can
5487
+ # update the view. If this occurs, please try again in a few minutes.
4973
5488
  # @param [String] name
4974
5489
  # 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".
5490
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5491
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4978
5492
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4979
5493
  # @param [String] update_mask
4980
5494
  # Optional. Field mask that specifies the fields in view that need an update. A
4981
5495
  # field will be overwritten if, and only if, it is in the update mask. name and
4982
5496
  # output only fields cannot be updated.For a detailed FieldMask definition, see
4983
5497
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
4984
- # google.protobuf.FieldMaskExample: updateMask=filter.
5498
+ # google.protobuf.FieldMaskFor example: updateMask=filter
4985
5499
  # @param [String] fields
4986
5500
  # Selector specifying which fields to include in a partial response.
4987
5501
  # @param [String] quota_user
@@ -5012,6 +5526,123 @@ module Google
5012
5526
  execute_or_queue_command(command, &block)
5013
5527
  end
5014
5528
 
5529
+ # Starts asynchronous cancellation on a long-running operation. The server makes
5530
+ # a best effort to cancel the operation, but success is not guaranteed. If the
5531
+ # server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.
5532
+ # Clients can use Operations.GetOperation or other methods to check whether the
5533
+ # cancellation succeeded or whether the operation completed despite cancellation.
5534
+ # On successful cancellation, the operation is not deleted; instead, it becomes
5535
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
5536
+ # corresponding to Code.CANCELLED.
5537
+ # @param [String] name
5538
+ # The name of the operation resource to be cancelled.
5539
+ # @param [Google::Apis::LoggingV2::CancelOperationRequest] cancel_operation_request_object
5540
+ # @param [String] fields
5541
+ # Selector specifying which fields to include in a partial response.
5542
+ # @param [String] quota_user
5543
+ # Available to use for quota purposes for server-side applications. Can be any
5544
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5545
+ # @param [Google::Apis::RequestOptions] options
5546
+ # Request-specific options
5547
+ #
5548
+ # @yield [result, err] Result & error if block supplied
5549
+ # @yieldparam result [Google::Apis::LoggingV2::Empty] parsed result object
5550
+ # @yieldparam err [StandardError] error object if request failed
5551
+ #
5552
+ # @return [Google::Apis::LoggingV2::Empty]
5553
+ #
5554
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5555
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5556
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5557
+ def cancel_project_location_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5558
+ command = make_simple_command(:post, 'v2/{+name}:cancel', options)
5559
+ command.request_representation = Google::Apis::LoggingV2::CancelOperationRequest::Representation
5560
+ command.request_object = cancel_operation_request_object
5561
+ command.response_representation = Google::Apis::LoggingV2::Empty::Representation
5562
+ command.response_class = Google::Apis::LoggingV2::Empty
5563
+ command.params['name'] = name unless name.nil?
5564
+ command.query['fields'] = fields unless fields.nil?
5565
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5566
+ execute_or_queue_command(command, &block)
5567
+ end
5568
+
5569
+ # Gets the latest state of a long-running operation. Clients can use this method
5570
+ # to poll the operation result at intervals as recommended by the API service.
5571
+ # @param [String] name
5572
+ # The name of the operation resource.
5573
+ # @param [String] fields
5574
+ # Selector specifying which fields to include in a partial response.
5575
+ # @param [String] quota_user
5576
+ # Available to use for quota purposes for server-side applications. Can be any
5577
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5578
+ # @param [Google::Apis::RequestOptions] options
5579
+ # Request-specific options
5580
+ #
5581
+ # @yield [result, err] Result & error if block supplied
5582
+ # @yieldparam result [Google::Apis::LoggingV2::Operation] parsed result object
5583
+ # @yieldparam err [StandardError] error object if request failed
5584
+ #
5585
+ # @return [Google::Apis::LoggingV2::Operation]
5586
+ #
5587
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5588
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5589
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5590
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
5591
+ command = make_simple_command(:get, 'v2/{+name}', options)
5592
+ command.response_representation = Google::Apis::LoggingV2::Operation::Representation
5593
+ command.response_class = Google::Apis::LoggingV2::Operation
5594
+ command.params['name'] = name unless name.nil?
5595
+ command.query['fields'] = fields unless fields.nil?
5596
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5597
+ execute_or_queue_command(command, &block)
5598
+ end
5599
+
5600
+ # Lists operations that match the specified filter in the request. If the server
5601
+ # doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name binding
5602
+ # allows API services to override the binding to use different resource name
5603
+ # schemes, such as users/*/operations. To override the binding, API services can
5604
+ # add a binding such as "/v1/`name=users/*`/operations" to their service
5605
+ # configuration. For backwards compatibility, the default name includes the
5606
+ # operations collection id, however overriding users must ensure the name
5607
+ # binding is the parent resource, without the operations collection id.
5608
+ # @param [String] name
5609
+ # The name of the operation's parent resource.
5610
+ # @param [String] filter
5611
+ # The standard list filter.
5612
+ # @param [Fixnum] page_size
5613
+ # The standard list page size.
5614
+ # @param [String] page_token
5615
+ # The standard list page token.
5616
+ # @param [String] fields
5617
+ # Selector specifying which fields to include in a partial response.
5618
+ # @param [String] quota_user
5619
+ # Available to use for quota purposes for server-side applications. Can be any
5620
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5621
+ # @param [Google::Apis::RequestOptions] options
5622
+ # Request-specific options
5623
+ #
5624
+ # @yield [result, err] Result & error if block supplied
5625
+ # @yieldparam result [Google::Apis::LoggingV2::ListOperationsResponse] parsed result object
5626
+ # @yieldparam err [StandardError] error object if request failed
5627
+ #
5628
+ # @return [Google::Apis::LoggingV2::ListOperationsResponse]
5629
+ #
5630
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5631
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5632
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5633
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5634
+ command = make_simple_command(:get, 'v2/{+name}/operations', options)
5635
+ command.response_representation = Google::Apis::LoggingV2::ListOperationsResponse::Representation
5636
+ command.response_class = Google::Apis::LoggingV2::ListOperationsResponse
5637
+ command.params['name'] = name unless name.nil?
5638
+ command.query['filter'] = filter unless filter.nil?
5639
+ command.query['pageSize'] = page_size unless page_size.nil?
5640
+ command.query['pageToken'] = page_token unless page_token.nil?
5641
+ command.query['fields'] = fields unless fields.nil?
5642
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5643
+ execute_or_queue_command(command, &block)
5644
+ end
5645
+
5015
5646
  # Deletes all the log entries in a log for the _Default Log Bucket. The log
5016
5647
  # reappears if it receives new entries. Log entries written shortly before the
5017
5648
  # delete operation might not be deleted. Entries received after the delete
@@ -5285,14 +5916,14 @@ module Google
5285
5916
  # @param [String] parent
5286
5917
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
5287
5918
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
5288
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
5289
- # 123456789".
5919
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
5920
+ # 123456789"
5290
5921
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5291
5922
  # @param [Boolean] unique_writer_identity
5292
5923
  # Optional. Determines the kind of IAM identity returned as writer_identity in
5293
5924
  # the new sink. If this value is omitted or set to false, and if the sink's
5294
5925
  # 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
5926
+ # group or service account used by Cloud Logging before the addition of writer
5296
5927
  # identities to this API. The sink's destination must be in the same project as
5297
5928
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
5298
5929
  # project resource such as an organization, then the value of writer_identity
@@ -5334,8 +5965,8 @@ module Google
5334
5965
  # Required. The full resource name of the sink to delete, including the parent
5335
5966
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5336
5967
  # 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".
5968
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
5969
+ # example:"projects/my-project/sinks/my-sink"
5339
5970
  # @param [String] fields
5340
5971
  # Selector specifying which fields to include in a partial response.
5341
5972
  # @param [String] quota_user
@@ -5367,8 +5998,8 @@ module Google
5367
5998
  # @param [String] sink_name
5368
5999
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
5369
6000
  # " "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".
6001
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6002
+ # example:"projects/my-project/sinks/my-sink"
5372
6003
  # @param [String] fields
5373
6004
  # Selector specifying which fields to include in a partial response.
5374
6005
  # @param [String] quota_user
@@ -5446,8 +6077,8 @@ module Google
5446
6077
  # Required. The full resource name of the sink to update, including the parent
5447
6078
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5448
6079
  # 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".
6080
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6081
+ # example:"projects/my-project/sinks/my-sink"
5451
6082
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5452
6083
  # @param [Boolean] unique_writer_identity
5453
6084
  # Optional. See sinks.create for a description of this field. When updating a
@@ -5463,10 +6094,11 @@ module Google
5463
6094
  # sink field will be overwritten if, and only if, it is in the update mask. name
5464
6095
  # and output only fields cannot be updated.An empty updateMask is temporarily
5465
6096
  # treated as using the following mask for backwards compatibility purposes:
5466
- # destination,filter,includeChildren At some point in the future, behavior will
6097
+ # destination,filter,includeChildrenAt some point in the future, behavior will
5467
6098
  # be removed and specifying an empty updateMask will be an error.For a detailed
5468
6099
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
5469
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6100
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6101
+ # filter
5470
6102
  # @param [String] fields
5471
6103
  # Selector specifying which fields to include in a partial response.
5472
6104
  # @param [String] quota_user
@@ -5505,8 +6137,8 @@ module Google
5505
6137
  # Required. The full resource name of the sink to update, including the parent
5506
6138
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5507
6139
  # 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".
6140
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6141
+ # example:"projects/my-project/sinks/my-sink"
5510
6142
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5511
6143
  # @param [Boolean] unique_writer_identity
5512
6144
  # Optional. See sinks.create for a description of this field. When updating a
@@ -5522,10 +6154,11 @@ module Google
5522
6154
  # sink field will be overwritten if, and only if, it is in the update mask. name
5523
6155
  # and output only fields cannot be updated.An empty updateMask is temporarily
5524
6156
  # treated as using the following mask for backwards compatibility purposes:
5525
- # destination,filter,includeChildren At some point in the future, behavior will
6157
+ # destination,filter,includeChildrenAt some point in the future, behavior will
5526
6158
  # be removed and specifying an empty updateMask will be an error.For a detailed
5527
6159
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
5528
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6160
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6161
+ # filter
5529
6162
  # @param [String] fields
5530
6163
  # Selector specifying which fields to include in a partial response.
5531
6164
  # @param [String] quota_user
@@ -5564,14 +6197,14 @@ module Google
5564
6197
  # @param [String] parent
5565
6198
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
5566
6199
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
5567
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
5568
- # 123456789".
6200
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
6201
+ # 123456789"
5569
6202
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5570
6203
  # @param [Boolean] unique_writer_identity
5571
6204
  # Optional. Determines the kind of IAM identity returned as writer_identity in
5572
6205
  # the new sink. If this value is omitted or set to false, and if the sink's
5573
6206
  # 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
6207
+ # group or service account used by Cloud Logging before the addition of writer
5575
6208
  # identities to this API. The sink's destination must be in the same project as
5576
6209
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
5577
6210
  # project resource such as an organization, then the value of writer_identity
@@ -5613,8 +6246,8 @@ module Google
5613
6246
  # Required. The full resource name of the sink to delete, including the parent
5614
6247
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5615
6248
  # 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".
6249
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6250
+ # example:"projects/my-project/sinks/my-sink"
5618
6251
  # @param [String] fields
5619
6252
  # Selector specifying which fields to include in a partial response.
5620
6253
  # @param [String] quota_user
@@ -5646,8 +6279,8 @@ module Google
5646
6279
  # @param [String] sink_name
5647
6280
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
5648
6281
  # " "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".
6282
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6283
+ # example:"projects/my-project/sinks/my-sink"
5651
6284
  # @param [String] fields
5652
6285
  # Selector specifying which fields to include in a partial response.
5653
6286
  # @param [String] quota_user
@@ -5725,8 +6358,8 @@ module Google
5725
6358
  # Required. The full resource name of the sink to update, including the parent
5726
6359
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5727
6360
  # 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".
6361
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6362
+ # example:"projects/my-project/sinks/my-sink"
5730
6363
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5731
6364
  # @param [Boolean] unique_writer_identity
5732
6365
  # Optional. See sinks.create for a description of this field. When updating a
@@ -5742,10 +6375,11 @@ module Google
5742
6375
  # sink field will be overwritten if, and only if, it is in the update mask. name
5743
6376
  # and output only fields cannot be updated.An empty updateMask is temporarily
5744
6377
  # treated as using the following mask for backwards compatibility purposes:
5745
- # destination,filter,includeChildren At some point in the future, behavior will
6378
+ # destination,filter,includeChildrenAt some point in the future, behavior will
5746
6379
  # be removed and specifying an empty updateMask will be an error.For a detailed
5747
6380
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
5748
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6381
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6382
+ # filter
5749
6383
  # @param [String] fields
5750
6384
  # Selector specifying which fields to include in a partial response.
5751
6385
  # @param [String] quota_user
@@ -5786,7 +6420,7 @@ module Google
5786
6420
  # Required. The resource for which to retrieve CMEK settings. "projects/[
5787
6421
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
5788
6422
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
5789
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6423
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
5790
6424
  # Logs Router can currently only be configured for GCP organizations. Once
5791
6425
  # configured, it applies to all projects and folders in the GCP organization.
5792
6426
  # @param [String] fields
@@ -5828,15 +6462,15 @@ module Google
5828
6462
  # Required. The resource name for the CMEK settings to update. "projects/[
5829
6463
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
5830
6464
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
5831
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6465
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
5832
6466
  # Logs Router can currently only be configured for GCP organizations. Once
5833
6467
  # configured, it applies to all projects and folders in the GCP organization.
5834
6468
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
5835
6469
  # @param [String] update_mask
5836
6470
  # Optional. Field mask identifying which fields from cmek_settings should be
5837
6471
  # 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"
6472
+ # Output only fields cannot be updated.See FieldMask for more information.For
6473
+ # example: "updateMask=kmsKeyName"
5840
6474
  # @param [String] fields
5841
6475
  # Selector specifying which fields to include in a partial response.
5842
6476
  # @param [String] quota_user