google-apis-logging_v2 0.11.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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