google-apis-logging_v2 0.12.0 → 0.16.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (8) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -0
  3. data/OVERVIEW.md +2 -2
  4. data/lib/google/apis/logging_v2/classes.rb +82 -76
  5. data/lib/google/apis/logging_v2/gem_version.rb +2 -2
  6. data/lib/google/apis/logging_v2/service.rb +453 -430
  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
@@ -119,14 +119,14 @@ module Google
119
119
  execute_or_queue_command(command, &block)
120
120
  end
121
121
 
122
- # Creates a new exclusion in a specified parent resource. Only log entries
123
- # belonging to that resource can be excluded. You can have up to 10 exclusions
124
- # in a resource.
122
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
123
+ # Only log entries belonging to that resource can be excluded. You can have up
124
+ # to 10 exclusions in a resource.
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.
@@ -157,13 +157,13 @@ module Google
157
157
  execute_or_queue_command(command, &block)
158
158
  end
159
159
 
160
- # Deletes an exclusion.
160
+ # Deletes an exclusion in the _Default sink.
161
161
  # @param [String] name
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
@@ -191,13 +191,13 @@ module Google
191
191
  execute_or_queue_command(command, &block)
192
192
  end
193
193
 
194
- # Gets the description of an exclusion.
194
+ # Gets the description of an exclusion in the _Default sink.
195
195
  # @param [String] name
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
@@ -225,7 +225,7 @@ module Google
225
225
  execute_or_queue_command(command, &block)
226
226
  end
227
227
 
228
- # Lists all the exclusions in a parent resource.
228
+ # Lists all the exclusions on the _Default sink in a parent resource.
229
229
  # @param [String] parent
230
230
  # Required. The parent resource whose exclusions are to be listed. "projects/[
231
231
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -268,13 +268,13 @@ module Google
268
268
  execute_or_queue_command(command, &block)
269
269
  end
270
270
 
271
- # Changes one or more properties of an existing exclusion.
271
+ # Changes one or more properties of an existing exclusion in the _Default sink.
272
272
  # @param [String] name
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
@@ -974,14 +976,14 @@ module Google
974
976
  # @param [String] parent
975
977
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
976
978
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
977
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
978
- # 123456789".
979
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
980
+ # 123456789"
979
981
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
980
982
  # @param [Boolean] unique_writer_identity
981
983
  # Optional. Determines the kind of IAM identity returned as writer_identity in
982
984
  # the new sink. If this value is omitted or set to false, and if the sink's
983
985
  # parent is a project, then the value returned as writer_identity is the same
984
- # 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
985
987
  # identities to this API. The sink's destination must be in the same project as
986
988
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
987
989
  # project resource such as an organization, then the value of writer_identity
@@ -1023,8 +1025,8 @@ module Google
1023
1025
  # Required. The full resource name of the sink to delete, including the parent
1024
1026
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1025
1027
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
1026
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1027
- # 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"
1028
1030
  # @param [String] fields
1029
1031
  # Selector specifying which fields to include in a partial response.
1030
1032
  # @param [String] quota_user
@@ -1056,8 +1058,8 @@ module Google
1056
1058
  # @param [String] sink_name
1057
1059
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
1058
1060
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
1059
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1060
- # 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"
1061
1063
  # @param [String] fields
1062
1064
  # Selector specifying which fields to include in a partial response.
1063
1065
  # @param [String] quota_user
@@ -1135,8 +1137,8 @@ module Google
1135
1137
  # Required. The full resource name of the sink to update, including the parent
1136
1138
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1137
1139
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
1138
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1139
- # 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"
1140
1142
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1141
1143
  # @param [Boolean] unique_writer_identity
1142
1144
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1152,10 +1154,11 @@ module Google
1152
1154
  # sink field will be overwritten if, and only if, it is in the update mask. name
1153
1155
  # and output only fields cannot be updated.An empty updateMask is temporarily
1154
1156
  # treated as using the following mask for backwards compatibility purposes:
1155
- # destination,filter,includeChildren At some point in the future, behavior will
1157
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1156
1158
  # be removed and specifying an empty updateMask will be an error.For a detailed
1157
1159
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1158
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1160
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1161
+ # filter
1159
1162
  # @param [String] fields
1160
1163
  # Selector specifying which fields to include in a partial response.
1161
1164
  # @param [String] quota_user
@@ -1194,8 +1197,8 @@ module Google
1194
1197
  # Required. The full resource name of the sink to update, including the parent
1195
1198
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1196
1199
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
1197
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
1198
- # 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"
1199
1202
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1200
1203
  # @param [Boolean] unique_writer_identity
1201
1204
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1211,10 +1214,11 @@ module Google
1211
1214
  # sink field will be overwritten if, and only if, it is in the update mask. name
1212
1215
  # and output only fields cannot be updated.An empty updateMask is temporarily
1213
1216
  # treated as using the following mask for backwards compatibility purposes:
1214
- # destination,filter,includeChildren At some point in the future, behavior will
1217
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1215
1218
  # be removed and specifying an empty updateMask will be an error.For a detailed
1216
1219
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1217
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1220
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1221
+ # filter
1218
1222
  # @param [String] fields
1219
1223
  # Selector specifying which fields to include in a partial response.
1220
1224
  # @param [String] quota_user
@@ -1246,7 +1250,7 @@ module Google
1246
1250
  execute_or_queue_command(command, &block)
1247
1251
  end
1248
1252
 
1249
- # Copies a set of log entries from a logging bucket to a Cloud Storage bucket.
1253
+ # Copies a set of log entries from a log bucket to a Cloud Storage bucket.
1250
1254
  # @param [Google::Apis::LoggingV2::CopyLogEntriesRequest] copy_log_entries_request_object
1251
1255
  # @param [String] fields
1252
1256
  # Selector specifying which fields to include in a partial response.
@@ -1373,14 +1377,14 @@ module Google
1373
1377
  execute_or_queue_command(command, &block)
1374
1378
  end
1375
1379
 
1376
- # Creates a new exclusion in a specified parent resource. Only log entries
1377
- # belonging to that resource can be excluded. You can have up to 10 exclusions
1378
- # in a resource.
1380
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
1381
+ # Only log entries belonging to that resource can be excluded. You can have up
1382
+ # to 10 exclusions in a resource.
1379
1383
  # @param [String] parent
1380
1384
  # Required. The parent resource in which to create the exclusion: "projects/[
1381
1385
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1382
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1383
- # project", "organizations/123456789".
1386
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1387
+ # project" "organizations/123456789"
1384
1388
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1385
1389
  # @param [String] fields
1386
1390
  # Selector specifying which fields to include in a partial response.
@@ -1411,13 +1415,13 @@ module Google
1411
1415
  execute_or_queue_command(command, &block)
1412
1416
  end
1413
1417
 
1414
- # Deletes an exclusion.
1418
+ # Deletes an exclusion in the _Default sink.
1415
1419
  # @param [String] name
1416
1420
  # Required. The resource name of an existing exclusion to delete: "projects/[
1417
1421
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1418
1422
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
1419
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
1420
- # 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"
1421
1425
  # @param [String] fields
1422
1426
  # Selector specifying which fields to include in a partial response.
1423
1427
  # @param [String] quota_user
@@ -1445,13 +1449,13 @@ module Google
1445
1449
  execute_or_queue_command(command, &block)
1446
1450
  end
1447
1451
 
1448
- # Gets the description of an exclusion.
1452
+ # Gets the description of an exclusion in the _Default sink.
1449
1453
  # @param [String] name
1450
1454
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1451
1455
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1452
1456
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1453
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1454
- # id/exclusions/my-exclusion-id".
1457
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1458
+ # project/exclusions/my-exclusion"
1455
1459
  # @param [String] fields
1456
1460
  # Selector specifying which fields to include in a partial response.
1457
1461
  # @param [String] quota_user
@@ -1479,7 +1483,7 @@ module Google
1479
1483
  execute_or_queue_command(command, &block)
1480
1484
  end
1481
1485
 
1482
- # Lists all the exclusions in a parent resource.
1486
+ # Lists all the exclusions on the _Default sink in a parent resource.
1483
1487
  # @param [String] parent
1484
1488
  # Required. The parent resource whose exclusions are to be listed. "projects/[
1485
1489
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -1522,13 +1526,13 @@ module Google
1522
1526
  execute_or_queue_command(command, &block)
1523
1527
  end
1524
1528
 
1525
- # Changes one or more properties of an existing exclusion.
1529
+ # Changes one or more properties of an existing exclusion in the _Default sink.
1526
1530
  # @param [String] name
1527
1531
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1528
1532
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1529
1533
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1530
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1531
- # id/exclusions/my-exclusion-id".
1534
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1535
+ # project/exclusions/my-exclusion"
1532
1536
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1533
1537
  # @param [String] update_mask
1534
1538
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1567,14 +1571,14 @@ module Google
1567
1571
  execute_or_queue_command(command, &block)
1568
1572
  end
1569
1573
 
1570
- # Creates a new exclusion in a specified parent resource. Only log entries
1571
- # belonging to that resource can be excluded. You can have up to 10 exclusions
1572
- # in a resource.
1574
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
1575
+ # Only log entries belonging to that resource can be excluded. You can have up
1576
+ # to 10 exclusions in a resource.
1573
1577
  # @param [String] parent
1574
1578
  # Required. The parent resource in which to create the exclusion: "projects/[
1575
1579
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1576
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1577
- # project", "organizations/123456789".
1580
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1581
+ # project" "organizations/123456789"
1578
1582
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1579
1583
  # @param [String] fields
1580
1584
  # Selector specifying which fields to include in a partial response.
@@ -1605,13 +1609,13 @@ module Google
1605
1609
  execute_or_queue_command(command, &block)
1606
1610
  end
1607
1611
 
1608
- # Deletes an exclusion.
1612
+ # Deletes an exclusion in the _Default sink.
1609
1613
  # @param [String] name
1610
1614
  # Required. The resource name of an existing exclusion to delete: "projects/[
1611
1615
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1612
1616
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
1613
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
1614
- # 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"
1615
1619
  # @param [String] fields
1616
1620
  # Selector specifying which fields to include in a partial response.
1617
1621
  # @param [String] quota_user
@@ -1639,13 +1643,13 @@ module Google
1639
1643
  execute_or_queue_command(command, &block)
1640
1644
  end
1641
1645
 
1642
- # Gets the description of an exclusion.
1646
+ # Gets the description of an exclusion in the _Default sink.
1643
1647
  # @param [String] name
1644
1648
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1645
1649
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1646
1650
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1647
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1648
- # id/exclusions/my-exclusion-id".
1651
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1652
+ # project/exclusions/my-exclusion"
1649
1653
  # @param [String] fields
1650
1654
  # Selector specifying which fields to include in a partial response.
1651
1655
  # @param [String] quota_user
@@ -1673,7 +1677,7 @@ module Google
1673
1677
  execute_or_queue_command(command, &block)
1674
1678
  end
1675
1679
 
1676
- # Lists all the exclusions in a parent resource.
1680
+ # Lists all the exclusions on the _Default sink in a parent resource.
1677
1681
  # @param [String] parent
1678
1682
  # Required. The parent resource whose exclusions are to be listed. "projects/[
1679
1683
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -1716,13 +1720,13 @@ module Google
1716
1720
  execute_or_queue_command(command, &block)
1717
1721
  end
1718
1722
 
1719
- # Changes one or more properties of an existing exclusion.
1723
+ # Changes one or more properties of an existing exclusion in the _Default sink.
1720
1724
  # @param [String] name
1721
1725
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1722
1726
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1723
1727
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
1724
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
1725
- # id/exclusions/my-exclusion-id".
1728
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1729
+ # project/exclusions/my-exclusion"
1726
1730
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1727
1731
  # @param [String] update_mask
1728
1732
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1834,12 +1838,12 @@ module Google
1834
1838
  execute_or_queue_command(command, &block)
1835
1839
  end
1836
1840
 
1837
- # Creates a bucket that can be used to store log entries. Once a bucket has been
1838
- # 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.
1839
1843
  # @param [String] parent
1840
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
1841
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
1842
- # 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"
1843
1847
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
1844
1848
  # @param [String] bucket_id
1845
1849
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -1875,16 +1879,16 @@ module Google
1875
1879
  execute_or_queue_command(command, &block)
1876
1880
  end
1877
1881
 
1878
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
1879
- # the bucket will be purged and all logs in the bucket will be permanently
1880
- # 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.
1881
1885
  # @param [String] name
1882
1886
  # Required. The full resource name of the bucket to delete. "projects/[
1883
1887
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1884
1888
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1885
1889
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
1886
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
1887
- # 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"
1888
1892
  # @param [String] fields
1889
1893
  # Selector specifying which fields to include in a partial response.
1890
1894
  # @param [String] quota_user
@@ -1912,14 +1916,14 @@ module Google
1912
1916
  execute_or_queue_command(command, &block)
1913
1917
  end
1914
1918
 
1915
- # Gets a bucket.
1919
+ # Gets a log bucket.
1916
1920
  # @param [String] name
1917
1921
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
1918
1922
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
1919
1923
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
1920
1924
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
1921
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
1922
- # my-location/buckets/my-bucket-id".
1925
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
1926
+ # global/buckets/my-bucket"
1923
1927
  # @param [String] fields
1924
1928
  # Selector specifying which fields to include in a partial response.
1925
1929
  # @param [String] quota_user
@@ -1947,7 +1951,7 @@ module Google
1947
1951
  execute_or_queue_command(command, &block)
1948
1952
  end
1949
1953
 
1950
- # Lists buckets.
1954
+ # Lists log buckets.
1951
1955
  # @param [String] parent
1952
1956
  # Required. The parent resource whose buckets are to be listed: "projects/[
1953
1957
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -1993,27 +1997,27 @@ module Google
1993
1997
  execute_or_queue_command(command, &block)
1994
1998
  end
1995
1999
 
1996
- # Updates a bucket. This method replaces the following fields in the existing
1997
- # bucket with values from the new bucket: retention_periodIf the retention
1998
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
1999
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
2000
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
2001
- # 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.
2002
2006
  # @param [String] name
2003
2007
  # Required. The full resource name of the bucket to update. "projects/[
2004
2008
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2005
2009
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2006
2010
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2007
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
2008
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
2009
- # 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"
2010
2013
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2011
2014
  # @param [String] update_mask
2012
2015
  # Required. Field mask that specifies the fields in bucket that need an update.
2013
2016
  # A bucket field will be overwritten if, and only if, it is in the update mask.
2014
2017
  # name and output only fields cannot be updated.For a detailed FieldMask
2015
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
2016
- # 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
2017
2021
  # @param [String] fields
2018
2022
  # Selector specifying which fields to include in a partial response.
2019
2023
  # @param [String] quota_user
@@ -2044,15 +2048,15 @@ module Google
2044
2048
  execute_or_queue_command(command, &block)
2045
2049
  end
2046
2050
 
2047
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
2048
- # 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.
2049
2053
  # @param [String] name
2050
2054
  # Required. The full resource name of the bucket to undelete. "projects/[
2051
2055
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2052
2056
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2053
2057
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2054
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
2055
- # 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"
2056
2060
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
2057
2061
  # @param [String] fields
2058
2062
  # Selector specifying which fields to include in a partial response.
@@ -2083,12 +2087,12 @@ module Google
2083
2087
  execute_or_queue_command(command, &block)
2084
2088
  end
2085
2089
 
2086
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
2087
- # views.
2090
+ # Creates a view over log entries in a log bucket. A bucket may contain a
2091
+ # maximum of 30 views.
2088
2092
  # @param [String] parent
2089
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
2090
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
2091
- # 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"
2092
2096
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2093
2097
  # @param [String] view_id
2094
2098
  # Required. The id to use for this view.
@@ -2122,12 +2126,13 @@ module Google
2122
2126
  execute_or_queue_command(command, &block)
2123
2127
  end
2124
2128
 
2125
- # 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.
2126
2132
  # @param [String] name
2127
2133
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
2128
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
2129
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
2130
- # 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"
2131
2136
  # @param [String] fields
2132
2137
  # Selector specifying which fields to include in a partial response.
2133
2138
  # @param [String] quota_user
@@ -2155,11 +2160,11 @@ module Google
2155
2160
  execute_or_queue_command(command, &block)
2156
2161
  end
2157
2162
 
2158
- # Gets a view.
2163
+ # Gets a view on a log bucket..
2159
2164
  # @param [String] name
2160
2165
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
2161
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
2162
- # 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"
2163
2168
  # @param [String] fields
2164
2169
  # Selector specifying which fields to include in a partial response.
2165
2170
  # @param [String] quota_user
@@ -2187,12 +2192,12 @@ module Google
2187
2192
  execute_or_queue_command(command, &block)
2188
2193
  end
2189
2194
 
2190
- # Lists views on a bucket.
2195
+ # Lists views on a log bucket.
2191
2196
  # @param [String] parent
2192
2197
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
2193
2198
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2194
2199
  # @param [Fixnum] page_size
2195
- # 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-
2196
2201
  # positive values are ignored. The presence of nextPageToken in the response
2197
2202
  # indicates that more results might be available.
2198
2203
  # @param [String] page_token
@@ -2229,20 +2234,21 @@ module Google
2229
2234
  execute_or_queue_command(command, &block)
2230
2235
  end
2231
2236
 
2232
- # Updates a view. This method replaces the following fields in the existing view
2233
- # 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.
2234
2241
  # @param [String] name
2235
2242
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
2236
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
2237
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
2238
- # 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"
2239
2245
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2240
2246
  # @param [String] update_mask
2241
2247
  # Optional. Field mask that specifies the fields in view that need an update. A
2242
2248
  # field will be overwritten if, and only if, it is in the update mask. name and
2243
2249
  # output only fields cannot be updated.For a detailed FieldMask definition, see
2244
2250
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
2245
- # google.protobuf.FieldMaskExample: updateMask=filter.
2251
+ # google.protobuf.FieldMaskFor example: updateMask=filter
2246
2252
  # @param [String] fields
2247
2253
  # Selector specifying which fields to include in a partial response.
2248
2254
  # @param [String] quota_user
@@ -2489,14 +2495,14 @@ module Google
2489
2495
  # @param [String] parent
2490
2496
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
2491
2497
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
2492
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
2493
- # 123456789".
2498
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
2499
+ # 123456789"
2494
2500
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2495
2501
  # @param [Boolean] unique_writer_identity
2496
2502
  # Optional. Determines the kind of IAM identity returned as writer_identity in
2497
2503
  # the new sink. If this value is omitted or set to false, and if the sink's
2498
2504
  # parent is a project, then the value returned as writer_identity is the same
2499
- # 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
2500
2506
  # identities to this API. The sink's destination must be in the same project as
2501
2507
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
2502
2508
  # project resource such as an organization, then the value of writer_identity
@@ -2538,8 +2544,8 @@ module Google
2538
2544
  # Required. The full resource name of the sink to delete, including the parent
2539
2545
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2540
2546
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2541
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2542
- # 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"
2543
2549
  # @param [String] fields
2544
2550
  # Selector specifying which fields to include in a partial response.
2545
2551
  # @param [String] quota_user
@@ -2571,8 +2577,8 @@ module Google
2571
2577
  # @param [String] sink_name
2572
2578
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
2573
2579
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2574
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2575
- # 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"
2576
2582
  # @param [String] fields
2577
2583
  # Selector specifying which fields to include in a partial response.
2578
2584
  # @param [String] quota_user
@@ -2650,8 +2656,8 @@ module Google
2650
2656
  # Required. The full resource name of the sink to update, including the parent
2651
2657
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2652
2658
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2653
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2654
- # 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"
2655
2661
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2656
2662
  # @param [Boolean] unique_writer_identity
2657
2663
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2667,10 +2673,11 @@ module Google
2667
2673
  # sink field will be overwritten if, and only if, it is in the update mask. name
2668
2674
  # and output only fields cannot be updated.An empty updateMask is temporarily
2669
2675
  # treated as using the following mask for backwards compatibility purposes:
2670
- # destination,filter,includeChildren At some point in the future, behavior will
2676
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2671
2677
  # be removed and specifying an empty updateMask will be an error.For a detailed
2672
2678
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2673
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2679
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2680
+ # filter
2674
2681
  # @param [String] fields
2675
2682
  # Selector specifying which fields to include in a partial response.
2676
2683
  # @param [String] quota_user
@@ -2709,8 +2716,8 @@ module Google
2709
2716
  # Required. The full resource name of the sink to update, including the parent
2710
2717
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2711
2718
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
2712
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
2713
- # 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"
2714
2721
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2715
2722
  # @param [Boolean] unique_writer_identity
2716
2723
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2726,10 +2733,11 @@ module Google
2726
2733
  # sink field will be overwritten if, and only if, it is in the update mask. name
2727
2734
  # and output only fields cannot be updated.An empty updateMask is temporarily
2728
2735
  # treated as using the following mask for backwards compatibility purposes:
2729
- # destination,filter,includeChildren At some point in the future, behavior will
2736
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2730
2737
  # be removed and specifying an empty updateMask will be an error.For a detailed
2731
2738
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2732
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2739
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2740
+ # filter
2733
2741
  # @param [String] fields
2734
2742
  # Selector specifying which fields to include in a partial response.
2735
2743
  # @param [String] quota_user
@@ -2834,12 +2842,12 @@ module Google
2834
2842
  execute_or_queue_command(command, &block)
2835
2843
  end
2836
2844
 
2837
- # Creates a bucket that can be used to store log entries. Once a bucket has been
2838
- # 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.
2839
2847
  # @param [String] parent
2840
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
2841
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
2842
- # 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"
2843
2851
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2844
2852
  # @param [String] bucket_id
2845
2853
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -2875,16 +2883,16 @@ module Google
2875
2883
  execute_or_queue_command(command, &block)
2876
2884
  end
2877
2885
 
2878
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
2879
- # the bucket will be purged and all logs in the bucket will be permanently
2880
- # 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.
2881
2889
  # @param [String] name
2882
2890
  # Required. The full resource name of the bucket to delete. "projects/[
2883
2891
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2884
2892
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2885
2893
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
2886
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
2887
- # 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"
2888
2896
  # @param [String] fields
2889
2897
  # Selector specifying which fields to include in a partial response.
2890
2898
  # @param [String] quota_user
@@ -2912,14 +2920,14 @@ module Google
2912
2920
  execute_or_queue_command(command, &block)
2913
2921
  end
2914
2922
 
2915
- # Gets a bucket.
2923
+ # Gets a log bucket.
2916
2924
  # @param [String] name
2917
2925
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
2918
2926
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
2919
2927
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
2920
2928
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
2921
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
2922
- # my-location/buckets/my-bucket-id".
2929
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
2930
+ # global/buckets/my-bucket"
2923
2931
  # @param [String] fields
2924
2932
  # Selector specifying which fields to include in a partial response.
2925
2933
  # @param [String] quota_user
@@ -2947,7 +2955,7 @@ module Google
2947
2955
  execute_or_queue_command(command, &block)
2948
2956
  end
2949
2957
 
2950
- # Lists buckets.
2958
+ # Lists log buckets.
2951
2959
  # @param [String] parent
2952
2960
  # Required. The parent resource whose buckets are to be listed: "projects/[
2953
2961
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -2993,27 +3001,27 @@ module Google
2993
3001
  execute_or_queue_command(command, &block)
2994
3002
  end
2995
3003
 
2996
- # Updates a bucket. This method replaces the following fields in the existing
2997
- # bucket with values from the new bucket: retention_periodIf the retention
2998
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
2999
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
3000
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
3001
- # 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.
3002
3010
  # @param [String] name
3003
3011
  # Required. The full resource name of the bucket to update. "projects/[
3004
3012
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3005
3013
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3006
3014
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3007
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
3008
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
3009
- # 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"
3010
3017
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3011
3018
  # @param [String] update_mask
3012
3019
  # Required. Field mask that specifies the fields in bucket that need an update.
3013
3020
  # A bucket field will be overwritten if, and only if, it is in the update mask.
3014
3021
  # name and output only fields cannot be updated.For a detailed FieldMask
3015
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
3016
- # 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
3017
3025
  # @param [String] fields
3018
3026
  # Selector specifying which fields to include in a partial response.
3019
3027
  # @param [String] quota_user
@@ -3044,15 +3052,15 @@ module Google
3044
3052
  execute_or_queue_command(command, &block)
3045
3053
  end
3046
3054
 
3047
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
3048
- # 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.
3049
3057
  # @param [String] name
3050
3058
  # Required. The full resource name of the bucket to undelete. "projects/[
3051
3059
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3052
3060
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3053
3061
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3054
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
3055
- # 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"
3056
3064
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
3057
3065
  # @param [String] fields
3058
3066
  # Selector specifying which fields to include in a partial response.
@@ -3083,12 +3091,12 @@ module Google
3083
3091
  execute_or_queue_command(command, &block)
3084
3092
  end
3085
3093
 
3086
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
3087
- # views.
3094
+ # Creates a view over log entries in a log bucket. A bucket may contain a
3095
+ # maximum of 30 views.
3088
3096
  # @param [String] parent
3089
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
3090
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
3091
- # 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"
3092
3100
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3093
3101
  # @param [String] view_id
3094
3102
  # Required. The id to use for this view.
@@ -3122,12 +3130,13 @@ module Google
3122
3130
  execute_or_queue_command(command, &block)
3123
3131
  end
3124
3132
 
3125
- # 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.
3126
3136
  # @param [String] name
3127
3137
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
3128
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
3129
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
3130
- # 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"
3131
3140
  # @param [String] fields
3132
3141
  # Selector specifying which fields to include in a partial response.
3133
3142
  # @param [String] quota_user
@@ -3155,11 +3164,11 @@ module Google
3155
3164
  execute_or_queue_command(command, &block)
3156
3165
  end
3157
3166
 
3158
- # Gets a view.
3167
+ # Gets a view on a log bucket..
3159
3168
  # @param [String] name
3160
3169
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
3161
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
3162
- # 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"
3163
3172
  # @param [String] fields
3164
3173
  # Selector specifying which fields to include in a partial response.
3165
3174
  # @param [String] quota_user
@@ -3187,12 +3196,12 @@ module Google
3187
3196
  execute_or_queue_command(command, &block)
3188
3197
  end
3189
3198
 
3190
- # Lists views on a bucket.
3199
+ # Lists views on a log bucket.
3191
3200
  # @param [String] parent
3192
3201
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
3193
3202
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
3194
3203
  # @param [Fixnum] page_size
3195
- # 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-
3196
3205
  # positive values are ignored. The presence of nextPageToken in the response
3197
3206
  # indicates that more results might be available.
3198
3207
  # @param [String] page_token
@@ -3229,20 +3238,21 @@ module Google
3229
3238
  execute_or_queue_command(command, &block)
3230
3239
  end
3231
3240
 
3232
- # Updates a view. This method replaces the following fields in the existing view
3233
- # 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.
3234
3245
  # @param [String] name
3235
3246
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
3236
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
3237
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
3238
- # 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"
3239
3249
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3240
3250
  # @param [String] update_mask
3241
3251
  # Optional. Field mask that specifies the fields in view that need an update. A
3242
3252
  # field will be overwritten if, and only if, it is in the update mask. name and
3243
3253
  # output only fields cannot be updated.For a detailed FieldMask definition, see
3244
3254
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
3245
- # google.protobuf.FieldMaskExample: updateMask=filter.
3255
+ # google.protobuf.FieldMaskFor example: updateMask=filter
3246
3256
  # @param [String] fields
3247
3257
  # Selector specifying which fields to include in a partial response.
3248
3258
  # @param [String] quota_user
@@ -3521,17 +3531,18 @@ module Google
3521
3531
  end
3522
3532
 
3523
3533
  # Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
3524
- # Logs Router can currently only be configured for GCP organizations. Once
3525
- # configured, it applies to all projects and folders in the GCP organization.See
3526
- # Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/
3527
- # managed-encryption) for more information.
3534
+ # Logs Router can currently only be configured for Google Cloud organizations.
3535
+ # Once configured, it applies to all projects and folders in the Google Cloud
3536
+ # organization.See Enabling CMEK for Logs Router (https://cloud.google.com/
3537
+ # logging/docs/routing/managed-encryption) for more information.
3528
3538
  # @param [String] name
3529
3539
  # Required. The resource for which to retrieve CMEK settings. "projects/[
3530
3540
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3531
3541
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3532
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3533
- # Logs Router can currently only be configured for GCP organizations. Once
3534
- # configured, it applies to all projects and folders in the GCP organization.
3542
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3543
+ # Logs Router can currently only be configured for Google Cloud organizations.
3544
+ # Once configured, it applies to all projects and folders in the Google Cloud
3545
+ # organization.
3535
3546
  # @param [String] fields
3536
3547
  # Selector specifying which fields to include in a partial response.
3537
3548
  # @param [String] quota_user
@@ -3560,26 +3571,27 @@ module Google
3560
3571
  end
3561
3572
 
3562
3573
  # Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
3563
- # the Logs Router can currently only be configured for GCP organizations. Once
3564
- # configured, it applies to all projects and folders in the GCP organization.
3565
- # UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
3566
- # associated service account does not have the required roles/cloudkms.
3567
- # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
3568
- # is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/
3569
- # logging/docs/routing/managed-encryption) for more information.
3574
+ # the Logs Router can currently only be configured for Google Cloud
3575
+ # organizations. Once configured, it applies to all projects and folders in the
3576
+ # Google Cloud organization.UpdateCmekSettings will fail if 1) kms_key_name is
3577
+ # invalid, or 2) the associated service account does not have the required roles/
3578
+ # cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access
3579
+ # to the key is disabled.See Enabling CMEK for Logs Router (https://cloud.google.
3580
+ # com/logging/docs/routing/managed-encryption) for more information.
3570
3581
  # @param [String] name
3571
3582
  # Required. The resource name for the CMEK settings to update. "projects/[
3572
3583
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3573
3584
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3574
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3575
- # Logs Router can currently only be configured for GCP organizations. Once
3576
- # configured, it applies to all projects and folders in the GCP organization.
3585
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3586
+ # Logs Router can currently only be configured for Google Cloud organizations.
3587
+ # Once configured, it applies to all projects and folders in the Google Cloud
3588
+ # organization.
3577
3589
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
3578
3590
  # @param [String] update_mask
3579
3591
  # Optional. Field mask identifying which fields from cmek_settings should be
3580
3592
  # updated. A field will be overwritten if and only if it is in the update mask.
3581
- # Output only fields cannot be updated.See FieldMask for more information.
3582
- # Example: "updateMask=kmsKeyName"
3593
+ # Output only fields cannot be updated.See FieldMask for more information.For
3594
+ # example: "updateMask=kmsKeyName"
3583
3595
  # @param [String] fields
3584
3596
  # Selector specifying which fields to include in a partial response.
3585
3597
  # @param [String] quota_user
@@ -3610,14 +3622,14 @@ module Google
3610
3622
  execute_or_queue_command(command, &block)
3611
3623
  end
3612
3624
 
3613
- # Creates a new exclusion in a specified parent resource. Only log entries
3614
- # belonging to that resource can be excluded. You can have up to 10 exclusions
3615
- # in a resource.
3625
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
3626
+ # Only log entries belonging to that resource can be excluded. You can have up
3627
+ # to 10 exclusions in a resource.
3616
3628
  # @param [String] parent
3617
3629
  # Required. The parent resource in which to create the exclusion: "projects/[
3618
3630
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
3619
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
3620
- # project", "organizations/123456789".
3631
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
3632
+ # project" "organizations/123456789"
3621
3633
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3622
3634
  # @param [String] fields
3623
3635
  # Selector specifying which fields to include in a partial response.
@@ -3648,13 +3660,13 @@ module Google
3648
3660
  execute_or_queue_command(command, &block)
3649
3661
  end
3650
3662
 
3651
- # Deletes an exclusion.
3663
+ # Deletes an exclusion in the _Default sink.
3652
3664
  # @param [String] name
3653
3665
  # Required. The resource name of an existing exclusion to delete: "projects/[
3654
3666
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
3655
3667
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
3656
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
3657
- # projects/my-project-id/exclusions/my-exclusion-id".
3668
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
3669
+ # projects/my-project/exclusions/my-exclusion"
3658
3670
  # @param [String] fields
3659
3671
  # Selector specifying which fields to include in a partial response.
3660
3672
  # @param [String] quota_user
@@ -3682,13 +3694,13 @@ module Google
3682
3694
  execute_or_queue_command(command, &block)
3683
3695
  end
3684
3696
 
3685
- # Gets the description of an exclusion.
3697
+ # Gets the description of an exclusion in the _Default sink.
3686
3698
  # @param [String] name
3687
3699
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
3688
3700
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3689
3701
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
3690
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
3691
- # id/exclusions/my-exclusion-id".
3702
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3703
+ # project/exclusions/my-exclusion"
3692
3704
  # @param [String] fields
3693
3705
  # Selector specifying which fields to include in a partial response.
3694
3706
  # @param [String] quota_user
@@ -3716,7 +3728,7 @@ module Google
3716
3728
  execute_or_queue_command(command, &block)
3717
3729
  end
3718
3730
 
3719
- # Lists all the exclusions in a parent resource.
3731
+ # Lists all the exclusions on the _Default sink in a parent resource.
3720
3732
  # @param [String] parent
3721
3733
  # Required. The parent resource whose exclusions are to be listed. "projects/[
3722
3734
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -3759,13 +3771,13 @@ module Google
3759
3771
  execute_or_queue_command(command, &block)
3760
3772
  end
3761
3773
 
3762
- # Changes one or more properties of an existing exclusion.
3774
+ # Changes one or more properties of an existing exclusion in the _Default sink.
3763
3775
  # @param [String] name
3764
3776
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
3765
3777
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3766
3778
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
3767
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
3768
- # id/exclusions/my-exclusion-id".
3779
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3780
+ # project/exclusions/my-exclusion"
3769
3781
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3770
3782
  # @param [String] update_mask
3771
3783
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -3877,12 +3889,12 @@ module Google
3877
3889
  execute_or_queue_command(command, &block)
3878
3890
  end
3879
3891
 
3880
- # Creates a bucket that can be used to store log entries. Once a bucket has been
3881
- # created, the region cannot be changed.
3892
+ # Creates a log bucket that can be used to store log entries. After a bucket has
3893
+ # been created, the bucket's location cannot be changed.
3882
3894
  # @param [String] parent
3883
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
3884
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
3885
- # global"
3895
+ # Required. The resource in which to create the log bucket: "projects/[
3896
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
3897
+ # locations/global"
3886
3898
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3887
3899
  # @param [String] bucket_id
3888
3900
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -3918,16 +3930,16 @@ module Google
3918
3930
  execute_or_queue_command(command, &block)
3919
3931
  end
3920
3932
 
3921
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
3922
- # the bucket will be purged and all logs in the bucket will be permanently
3923
- # deleted.
3933
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
3934
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
3935
+ # entries in the bucket will be permanently deleted.
3924
3936
  # @param [String] name
3925
3937
  # Required. The full resource name of the bucket to delete. "projects/[
3926
3938
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3927
3939
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3928
3940
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
3929
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
3930
- # project-id/locations/my-location/buckets/my-bucket-id".
3941
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3942
+ # my-project/locations/global/buckets/my-bucket"
3931
3943
  # @param [String] fields
3932
3944
  # Selector specifying which fields to include in a partial response.
3933
3945
  # @param [String] quota_user
@@ -3955,14 +3967,14 @@ module Google
3955
3967
  execute_or_queue_command(command, &block)
3956
3968
  end
3957
3969
 
3958
- # Gets a bucket.
3970
+ # Gets a log bucket.
3959
3971
  # @param [String] name
3960
3972
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
3961
3973
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
3962
3974
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
3963
3975
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
3964
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
3965
- # my-location/buckets/my-bucket-id".
3976
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
3977
+ # global/buckets/my-bucket"
3966
3978
  # @param [String] fields
3967
3979
  # Selector specifying which fields to include in a partial response.
3968
3980
  # @param [String] quota_user
@@ -3990,7 +4002,7 @@ module Google
3990
4002
  execute_or_queue_command(command, &block)
3991
4003
  end
3992
4004
 
3993
- # Lists buckets.
4005
+ # Lists log buckets.
3994
4006
  # @param [String] parent
3995
4007
  # Required. The parent resource whose buckets are to be listed: "projects/[
3996
4008
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -4036,27 +4048,27 @@ module Google
4036
4048
  execute_or_queue_command(command, &block)
4037
4049
  end
4038
4050
 
4039
- # Updates a bucket. This method replaces the following fields in the existing
4040
- # bucket with values from the new bucket: retention_periodIf the retention
4041
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
4042
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
4043
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
4044
- # after it is created.
4051
+ # Updates a log bucket. This method replaces the following fields in the
4052
+ # existing bucket with values from the new bucket: retention_periodIf the
4053
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
4054
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
4055
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
4056
+ # bucket's location cannot be changed.
4045
4057
  # @param [String] name
4046
4058
  # Required. The full resource name of the bucket to update. "projects/[
4047
4059
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4048
4060
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4049
4061
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4050
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
4051
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
4052
- # permission "resourcemanager.projects.updateLiens" to set the locked property
4062
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4063
+ # my-project/locations/global/buckets/my-bucket"
4053
4064
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4054
4065
  # @param [String] update_mask
4055
4066
  # Required. Field mask that specifies the fields in bucket that need an update.
4056
4067
  # A bucket field will be overwritten if, and only if, it is in the update mask.
4057
4068
  # name and output only fields cannot be updated.For a detailed FieldMask
4058
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
4059
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
4069
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
4070
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4071
+ # retention_days
4060
4072
  # @param [String] fields
4061
4073
  # Selector specifying which fields to include in a partial response.
4062
4074
  # @param [String] quota_user
@@ -4087,15 +4099,15 @@ module Google
4087
4099
  execute_or_queue_command(command, &block)
4088
4100
  end
4089
4101
 
4090
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
4091
- # grace period of 7 days.
4102
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
4103
+ # the grace period of 7 days.
4092
4104
  # @param [String] name
4093
4105
  # Required. The full resource name of the bucket to undelete. "projects/[
4094
4106
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4095
4107
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4096
4108
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
4097
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
4098
- # project-id/locations/my-location/buckets/my-bucket-id".
4109
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4110
+ # my-project/locations/global/buckets/my-bucket"
4099
4111
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
4100
4112
  # @param [String] fields
4101
4113
  # Selector specifying which fields to include in a partial response.
@@ -4126,12 +4138,12 @@ module Google
4126
4138
  execute_or_queue_command(command, &block)
4127
4139
  end
4128
4140
 
4129
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
4130
- # views.
4141
+ # Creates a view over log entries in a log bucket. A bucket may contain a
4142
+ # maximum of 30 views.
4131
4143
  # @param [String] parent
4132
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
4133
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
4134
- # project/locations/my-location/buckets/my-bucket"
4144
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
4145
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
4146
+ # locations/global/buckets/my-bucket"
4135
4147
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4136
4148
  # @param [String] view_id
4137
4149
  # Required. The id to use for this view.
@@ -4165,12 +4177,13 @@ module Google
4165
4177
  execute_or_queue_command(command, &block)
4166
4178
  end
4167
4179
 
4168
- # Deletes a view from a bucket.
4180
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
4181
+ # indicates that system is not in a state where it can delete the view. If this
4182
+ # occurs, please try again in a few minutes.
4169
4183
  # @param [String] name
4170
4184
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
4171
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
4172
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
4173
- # view-id".
4185
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4186
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4174
4187
  # @param [String] fields
4175
4188
  # Selector specifying which fields to include in a partial response.
4176
4189
  # @param [String] quota_user
@@ -4198,11 +4211,11 @@ module Google
4198
4211
  execute_or_queue_command(command, &block)
4199
4212
  end
4200
4213
 
4201
- # Gets a view.
4214
+ # Gets a view on a log bucket..
4202
4215
  # @param [String] name
4203
4216
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
4204
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
4205
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
4217
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
4218
+ # project/locations/global/buckets/my-bucket/views/my-view"
4206
4219
  # @param [String] fields
4207
4220
  # Selector specifying which fields to include in a partial response.
4208
4221
  # @param [String] quota_user
@@ -4230,12 +4243,12 @@ module Google
4230
4243
  execute_or_queue_command(command, &block)
4231
4244
  end
4232
4245
 
4233
- # Lists views on a bucket.
4246
+ # Lists views on a log bucket.
4234
4247
  # @param [String] parent
4235
4248
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
4236
4249
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
4237
4250
  # @param [Fixnum] page_size
4238
- # Optional. The maximum number of results to return from this request. Non-
4251
+ # Optional. The maximum number of results to return from this request.Non-
4239
4252
  # positive values are ignored. The presence of nextPageToken in the response
4240
4253
  # indicates that more results might be available.
4241
4254
  # @param [String] page_token
@@ -4272,20 +4285,21 @@ module Google
4272
4285
  execute_or_queue_command(command, &block)
4273
4286
  end
4274
4287
 
4275
- # Updates a view. This method replaces the following fields in the existing view
4276
- # with values from the new view: filter.
4288
+ # Updates a view on a log bucket. This method replaces the following fields in
4289
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
4290
+ # error is returned, this indicates that system is not in a state where it can
4291
+ # update the view. If this occurs, please try again in a few minutes.
4277
4292
  # @param [String] name
4278
4293
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
4279
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
4280
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
4281
- # view-id".
4294
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4295
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4282
4296
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4283
4297
  # @param [String] update_mask
4284
4298
  # Optional. Field mask that specifies the fields in view that need an update. A
4285
4299
  # field will be overwritten if, and only if, it is in the update mask. name and
4286
4300
  # output only fields cannot be updated.For a detailed FieldMask definition, see
4287
4301
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
4288
- # google.protobuf.FieldMaskExample: updateMask=filter.
4302
+ # google.protobuf.FieldMaskFor example: updateMask=filter
4289
4303
  # @param [String] fields
4290
4304
  # Selector specifying which fields to include in a partial response.
4291
4305
  # @param [String] quota_user
@@ -4532,14 +4546,14 @@ module Google
4532
4546
  # @param [String] parent
4533
4547
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
4534
4548
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
4535
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
4536
- # 123456789".
4549
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
4550
+ # 123456789"
4537
4551
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4538
4552
  # @param [Boolean] unique_writer_identity
4539
4553
  # Optional. Determines the kind of IAM identity returned as writer_identity in
4540
4554
  # the new sink. If this value is omitted or set to false, and if the sink's
4541
4555
  # parent is a project, then the value returned as writer_identity is the same
4542
- # group or service account used by Logging before the addition of writer
4556
+ # group or service account used by Cloud Logging before the addition of writer
4543
4557
  # identities to this API. The sink's destination must be in the same project as
4544
4558
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
4545
4559
  # project resource such as an organization, then the value of writer_identity
@@ -4581,8 +4595,8 @@ module Google
4581
4595
  # Required. The full resource name of the sink to delete, including the parent
4582
4596
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4583
4597
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4584
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4585
- # Example: "projects/my-project-id/sinks/my-sink-id".
4598
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4599
+ # example:"projects/my-project/sinks/my-sink"
4586
4600
  # @param [String] fields
4587
4601
  # Selector specifying which fields to include in a partial response.
4588
4602
  # @param [String] quota_user
@@ -4614,8 +4628,8 @@ module Google
4614
4628
  # @param [String] sink_name
4615
4629
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
4616
4630
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4617
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4618
- # Example: "projects/my-project-id/sinks/my-sink-id".
4631
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4632
+ # example:"projects/my-project/sinks/my-sink"
4619
4633
  # @param [String] fields
4620
4634
  # Selector specifying which fields to include in a partial response.
4621
4635
  # @param [String] quota_user
@@ -4693,8 +4707,8 @@ module Google
4693
4707
  # Required. The full resource name of the sink to update, including the parent
4694
4708
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4695
4709
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4696
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4697
- # Example: "projects/my-project-id/sinks/my-sink-id".
4710
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4711
+ # example:"projects/my-project/sinks/my-sink"
4698
4712
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4699
4713
  # @param [Boolean] unique_writer_identity
4700
4714
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4710,10 +4724,11 @@ module Google
4710
4724
  # sink field will be overwritten if, and only if, it is in the update mask. name
4711
4725
  # and output only fields cannot be updated.An empty updateMask is temporarily
4712
4726
  # treated as using the following mask for backwards compatibility purposes:
4713
- # destination,filter,includeChildren At some point in the future, behavior will
4727
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4714
4728
  # be removed and specifying an empty updateMask will be an error.For a detailed
4715
4729
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4716
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4730
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4731
+ # filter
4717
4732
  # @param [String] fields
4718
4733
  # Selector specifying which fields to include in a partial response.
4719
4734
  # @param [String] quota_user
@@ -4752,8 +4767,8 @@ module Google
4752
4767
  # Required. The full resource name of the sink to update, including the parent
4753
4768
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4754
4769
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
4755
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
4756
- # Example: "projects/my-project-id/sinks/my-sink-id".
4770
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4771
+ # example:"projects/my-project/sinks/my-sink"
4757
4772
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4758
4773
  # @param [Boolean] unique_writer_identity
4759
4774
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4769,10 +4784,11 @@ module Google
4769
4784
  # sink field will be overwritten if, and only if, it is in the update mask. name
4770
4785
  # and output only fields cannot be updated.An empty updateMask is temporarily
4771
4786
  # treated as using the following mask for backwards compatibility purposes:
4772
- # destination,filter,includeChildren At some point in the future, behavior will
4787
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4773
4788
  # be removed and specifying an empty updateMask will be an error.For a detailed
4774
4789
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4775
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4790
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4791
+ # filter
4776
4792
  # @param [String] fields
4777
4793
  # Selector specifying which fields to include in a partial response.
4778
4794
  # @param [String] quota_user
@@ -4804,14 +4820,14 @@ module Google
4804
4820
  execute_or_queue_command(command, &block)
4805
4821
  end
4806
4822
 
4807
- # Creates a new exclusion in a specified parent resource. Only log entries
4808
- # belonging to that resource can be excluded. You can have up to 10 exclusions
4809
- # in a resource.
4823
+ # Creates a new exclusion in the _Default sink in a specified parent resource.
4824
+ # Only log entries belonging to that resource can be excluded. You can have up
4825
+ # to 10 exclusions in a resource.
4810
4826
  # @param [String] parent
4811
4827
  # Required. The parent resource in which to create the exclusion: "projects/[
4812
4828
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
4813
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
4814
- # project", "organizations/123456789".
4829
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
4830
+ # project" "organizations/123456789"
4815
4831
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4816
4832
  # @param [String] fields
4817
4833
  # Selector specifying which fields to include in a partial response.
@@ -4842,13 +4858,13 @@ module Google
4842
4858
  execute_or_queue_command(command, &block)
4843
4859
  end
4844
4860
 
4845
- # Deletes an exclusion.
4861
+ # Deletes an exclusion in the _Default sink.
4846
4862
  # @param [String] name
4847
4863
  # Required. The resource name of an existing exclusion to delete: "projects/[
4848
4864
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
4849
4865
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
4850
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
4851
- # projects/my-project-id/exclusions/my-exclusion-id".
4866
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
4867
+ # projects/my-project/exclusions/my-exclusion"
4852
4868
  # @param [String] fields
4853
4869
  # Selector specifying which fields to include in a partial response.
4854
4870
  # @param [String] quota_user
@@ -4876,13 +4892,13 @@ module Google
4876
4892
  execute_or_queue_command(command, &block)
4877
4893
  end
4878
4894
 
4879
- # Gets the description of an exclusion.
4895
+ # Gets the description of an exclusion in the _Default sink.
4880
4896
  # @param [String] name
4881
4897
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
4882
4898
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4883
4899
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
4884
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
4885
- # id/exclusions/my-exclusion-id".
4900
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4901
+ # project/exclusions/my-exclusion"
4886
4902
  # @param [String] fields
4887
4903
  # Selector specifying which fields to include in a partial response.
4888
4904
  # @param [String] quota_user
@@ -4910,7 +4926,7 @@ module Google
4910
4926
  execute_or_queue_command(command, &block)
4911
4927
  end
4912
4928
 
4913
- # Lists all the exclusions in a parent resource.
4929
+ # Lists all the exclusions on the _Default sink in a parent resource.
4914
4930
  # @param [String] parent
4915
4931
  # Required. The parent resource whose exclusions are to be listed. "projects/[
4916
4932
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
@@ -4953,13 +4969,13 @@ module Google
4953
4969
  execute_or_queue_command(command, &block)
4954
4970
  end
4955
4971
 
4956
- # Changes one or more properties of an existing exclusion.
4972
+ # Changes one or more properties of an existing exclusion in the _Default sink.
4957
4973
  # @param [String] name
4958
4974
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
4959
4975
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4960
4976
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
4961
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
4962
- # id/exclusions/my-exclusion-id".
4977
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4978
+ # project/exclusions/my-exclusion"
4963
4979
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4964
4980
  # @param [String] update_mask
4965
4981
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -5071,12 +5087,12 @@ module Google
5071
5087
  execute_or_queue_command(command, &block)
5072
5088
  end
5073
5089
 
5074
- # Creates a bucket that can be used to store log entries. Once a bucket has been
5075
- # created, the region cannot be changed.
5090
+ # Creates a log bucket that can be used to store log entries. After a bucket has
5091
+ # been created, the bucket's location cannot be changed.
5076
5092
  # @param [String] parent
5077
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
5078
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
5079
- # global"
5093
+ # Required. The resource in which to create the log bucket: "projects/[
5094
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
5095
+ # locations/global"
5080
5096
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5081
5097
  # @param [String] bucket_id
5082
5098
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -5112,16 +5128,16 @@ module Google
5112
5128
  execute_or_queue_command(command, &block)
5113
5129
  end
5114
5130
 
5115
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
5116
- # the bucket will be purged and all logs in the bucket will be permanently
5117
- # deleted.
5131
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
5132
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
5133
+ # entries in the bucket will be permanently deleted.
5118
5134
  # @param [String] name
5119
5135
  # Required. The full resource name of the bucket to delete. "projects/[
5120
5136
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5121
5137
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5122
5138
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5123
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
5124
- # project-id/locations/my-location/buckets/my-bucket-id".
5139
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5140
+ # my-project/locations/global/buckets/my-bucket"
5125
5141
  # @param [String] fields
5126
5142
  # Selector specifying which fields to include in a partial response.
5127
5143
  # @param [String] quota_user
@@ -5149,14 +5165,14 @@ module Google
5149
5165
  execute_or_queue_command(command, &block)
5150
5166
  end
5151
5167
 
5152
- # Gets a bucket.
5168
+ # Gets a log bucket.
5153
5169
  # @param [String] name
5154
5170
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
5155
5171
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
5156
5172
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
5157
5173
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
5158
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
5159
- # my-location/buckets/my-bucket-id".
5174
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
5175
+ # global/buckets/my-bucket"
5160
5176
  # @param [String] fields
5161
5177
  # Selector specifying which fields to include in a partial response.
5162
5178
  # @param [String] quota_user
@@ -5184,7 +5200,7 @@ module Google
5184
5200
  execute_or_queue_command(command, &block)
5185
5201
  end
5186
5202
 
5187
- # Lists buckets.
5203
+ # Lists log buckets.
5188
5204
  # @param [String] parent
5189
5205
  # Required. The parent resource whose buckets are to be listed: "projects/[
5190
5206
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -5230,27 +5246,27 @@ module Google
5230
5246
  execute_or_queue_command(command, &block)
5231
5247
  end
5232
5248
 
5233
- # Updates a bucket. This method replaces the following fields in the existing
5234
- # bucket with values from the new bucket: retention_periodIf the retention
5235
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
5236
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
5237
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
5238
- # after it is created.
5249
+ # Updates a log bucket. This method replaces the following fields in the
5250
+ # existing bucket with values from the new bucket: retention_periodIf the
5251
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
5252
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
5253
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
5254
+ # bucket's location cannot be changed.
5239
5255
  # @param [String] name
5240
5256
  # Required. The full resource name of the bucket to update. "projects/[
5241
5257
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5242
5258
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5243
5259
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5244
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
5245
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
5246
- # permission "resourcemanager.projects.updateLiens" to set the locked property
5260
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5261
+ # my-project/locations/global/buckets/my-bucket"
5247
5262
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5248
5263
  # @param [String] update_mask
5249
5264
  # Required. Field mask that specifies the fields in bucket that need an update.
5250
5265
  # A bucket field will be overwritten if, and only if, it is in the update mask.
5251
5266
  # name and output only fields cannot be updated.For a detailed FieldMask
5252
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
5253
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
5267
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
5268
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
5269
+ # retention_days
5254
5270
  # @param [String] fields
5255
5271
  # Selector specifying which fields to include in a partial response.
5256
5272
  # @param [String] quota_user
@@ -5281,15 +5297,15 @@ module Google
5281
5297
  execute_or_queue_command(command, &block)
5282
5298
  end
5283
5299
 
5284
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
5285
- # grace period of 7 days.
5300
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
5301
+ # the grace period of 7 days.
5286
5302
  # @param [String] name
5287
5303
  # Required. The full resource name of the bucket to undelete. "projects/[
5288
5304
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5289
5305
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5290
5306
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
5291
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
5292
- # project-id/locations/my-location/buckets/my-bucket-id".
5307
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5308
+ # my-project/locations/global/buckets/my-bucket"
5293
5309
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
5294
5310
  # @param [String] fields
5295
5311
  # Selector specifying which fields to include in a partial response.
@@ -5320,12 +5336,12 @@ module Google
5320
5336
  execute_or_queue_command(command, &block)
5321
5337
  end
5322
5338
 
5323
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
5324
- # views.
5339
+ # Creates a view over log entries in a log bucket. A bucket may contain a
5340
+ # maximum of 30 views.
5325
5341
  # @param [String] parent
5326
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
5327
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
5328
- # project/locations/my-location/buckets/my-bucket"
5342
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
5343
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
5344
+ # locations/global/buckets/my-bucket"
5329
5345
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
5330
5346
  # @param [String] view_id
5331
5347
  # Required. The id to use for this view.
@@ -5359,12 +5375,13 @@ module Google
5359
5375
  execute_or_queue_command(command, &block)
5360
5376
  end
5361
5377
 
5362
- # Deletes a view from a bucket.
5378
+ # Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this
5379
+ # indicates that system is not in a state where it can delete the view. If this
5380
+ # occurs, please try again in a few minutes.
5363
5381
  # @param [String] name
5364
5382
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
5365
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
5366
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
5367
- # view-id".
5383
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5384
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
5368
5385
  # @param [String] fields
5369
5386
  # Selector specifying which fields to include in a partial response.
5370
5387
  # @param [String] quota_user
@@ -5392,11 +5409,11 @@ module Google
5392
5409
  execute_or_queue_command(command, &block)
5393
5410
  end
5394
5411
 
5395
- # Gets a view.
5412
+ # Gets a view on a log bucket..
5396
5413
  # @param [String] name
5397
5414
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
5398
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
5399
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
5415
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
5416
+ # project/locations/global/buckets/my-bucket/views/my-view"
5400
5417
  # @param [String] fields
5401
5418
  # Selector specifying which fields to include in a partial response.
5402
5419
  # @param [String] quota_user
@@ -5424,12 +5441,12 @@ module Google
5424
5441
  execute_or_queue_command(command, &block)
5425
5442
  end
5426
5443
 
5427
- # Lists views on a bucket.
5444
+ # Lists views on a log bucket.
5428
5445
  # @param [String] parent
5429
5446
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
5430
5447
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
5431
5448
  # @param [Fixnum] page_size
5432
- # Optional. The maximum number of results to return from this request. Non-
5449
+ # Optional. The maximum number of results to return from this request.Non-
5433
5450
  # positive values are ignored. The presence of nextPageToken in the response
5434
5451
  # indicates that more results might be available.
5435
5452
  # @param [String] page_token
@@ -5466,20 +5483,21 @@ module Google
5466
5483
  execute_or_queue_command(command, &block)
5467
5484
  end
5468
5485
 
5469
- # Updates a view. This method replaces the following fields in the existing view
5470
- # with values from the new view: filter.
5486
+ # Updates a view on a log bucket. This method replaces the following fields in
5487
+ # the existing view with values from the new view: filter. If an UNAVAILABLE
5488
+ # error is returned, this indicates that system is not in a state where it can
5489
+ # update the view. If this occurs, please try again in a few minutes.
5471
5490
  # @param [String] name
5472
5491
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
5473
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
5474
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
5475
- # view-id".
5492
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5493
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
5476
5494
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
5477
5495
  # @param [String] update_mask
5478
5496
  # Optional. Field mask that specifies the fields in view that need an update. A
5479
5497
  # field will be overwritten if, and only if, it is in the update mask. name and
5480
5498
  # output only fields cannot be updated.For a detailed FieldMask definition, see
5481
5499
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
5482
- # google.protobuf.FieldMaskExample: updateMask=filter.
5500
+ # google.protobuf.FieldMaskFor example: updateMask=filter
5483
5501
  # @param [String] fields
5484
5502
  # Selector specifying which fields to include in a partial response.
5485
5503
  # @param [String] quota_user
@@ -5900,14 +5918,14 @@ module Google
5900
5918
  # @param [String] parent
5901
5919
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
5902
5920
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
5903
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
5904
- # 123456789".
5921
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
5922
+ # 123456789"
5905
5923
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5906
5924
  # @param [Boolean] unique_writer_identity
5907
5925
  # Optional. Determines the kind of IAM identity returned as writer_identity in
5908
5926
  # the new sink. If this value is omitted or set to false, and if the sink's
5909
5927
  # parent is a project, then the value returned as writer_identity is the same
5910
- # group or service account used by Logging before the addition of writer
5928
+ # group or service account used by Cloud Logging before the addition of writer
5911
5929
  # identities to this API. The sink's destination must be in the same project as
5912
5930
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
5913
5931
  # project resource such as an organization, then the value of writer_identity
@@ -5949,8 +5967,8 @@ module Google
5949
5967
  # Required. The full resource name of the sink to delete, including the parent
5950
5968
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5951
5969
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5952
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5953
- # Example: "projects/my-project-id/sinks/my-sink-id".
5970
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
5971
+ # example:"projects/my-project/sinks/my-sink"
5954
5972
  # @param [String] fields
5955
5973
  # Selector specifying which fields to include in a partial response.
5956
5974
  # @param [String] quota_user
@@ -5982,8 +6000,8 @@ module Google
5982
6000
  # @param [String] sink_name
5983
6001
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
5984
6002
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
5985
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
5986
- # Example: "projects/my-project-id/sinks/my-sink-id".
6003
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6004
+ # example:"projects/my-project/sinks/my-sink"
5987
6005
  # @param [String] fields
5988
6006
  # Selector specifying which fields to include in a partial response.
5989
6007
  # @param [String] quota_user
@@ -6061,8 +6079,8 @@ module Google
6061
6079
  # Required. The full resource name of the sink to update, including the parent
6062
6080
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6063
6081
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
6064
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
6065
- # Example: "projects/my-project-id/sinks/my-sink-id".
6082
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6083
+ # example:"projects/my-project/sinks/my-sink"
6066
6084
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6067
6085
  # @param [Boolean] unique_writer_identity
6068
6086
  # Optional. See sinks.create for a description of this field. When updating a
@@ -6078,10 +6096,11 @@ module Google
6078
6096
  # sink field will be overwritten if, and only if, it is in the update mask. name
6079
6097
  # and output only fields cannot be updated.An empty updateMask is temporarily
6080
6098
  # treated as using the following mask for backwards compatibility purposes:
6081
- # destination,filter,includeChildren At some point in the future, behavior will
6099
+ # destination,filter,includeChildrenAt some point in the future, behavior will
6082
6100
  # be removed and specifying an empty updateMask will be an error.For a detailed
6083
6101
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
6084
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6102
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6103
+ # filter
6085
6104
  # @param [String] fields
6086
6105
  # Selector specifying which fields to include in a partial response.
6087
6106
  # @param [String] quota_user
@@ -6120,8 +6139,8 @@ module Google
6120
6139
  # Required. The full resource name of the sink to update, including the parent
6121
6140
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6122
6141
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
6123
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
6124
- # Example: "projects/my-project-id/sinks/my-sink-id".
6142
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6143
+ # example:"projects/my-project/sinks/my-sink"
6125
6144
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6126
6145
  # @param [Boolean] unique_writer_identity
6127
6146
  # Optional. See sinks.create for a description of this field. When updating a
@@ -6137,10 +6156,11 @@ module Google
6137
6156
  # sink field will be overwritten if, and only if, it is in the update mask. name
6138
6157
  # and output only fields cannot be updated.An empty updateMask is temporarily
6139
6158
  # treated as using the following mask for backwards compatibility purposes:
6140
- # destination,filter,includeChildren At some point in the future, behavior will
6159
+ # destination,filter,includeChildrenAt some point in the future, behavior will
6141
6160
  # be removed and specifying an empty updateMask will be an error.For a detailed
6142
6161
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
6143
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6162
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6163
+ # filter
6144
6164
  # @param [String] fields
6145
6165
  # Selector specifying which fields to include in a partial response.
6146
6166
  # @param [String] quota_user
@@ -6179,14 +6199,14 @@ module Google
6179
6199
  # @param [String] parent
6180
6200
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
6181
6201
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
6182
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
6183
- # 123456789".
6202
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
6203
+ # 123456789"
6184
6204
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6185
6205
  # @param [Boolean] unique_writer_identity
6186
6206
  # Optional. Determines the kind of IAM identity returned as writer_identity in
6187
6207
  # the new sink. If this value is omitted or set to false, and if the sink's
6188
6208
  # parent is a project, then the value returned as writer_identity is the same
6189
- # group or service account used by Logging before the addition of writer
6209
+ # group or service account used by Cloud Logging before the addition of writer
6190
6210
  # identities to this API. The sink's destination must be in the same project as
6191
6211
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
6192
6212
  # project resource such as an organization, then the value of writer_identity
@@ -6228,8 +6248,8 @@ module Google
6228
6248
  # Required. The full resource name of the sink to delete, including the parent
6229
6249
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6230
6250
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
6231
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
6232
- # Example: "projects/my-project-id/sinks/my-sink-id".
6251
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6252
+ # example:"projects/my-project/sinks/my-sink"
6233
6253
  # @param [String] fields
6234
6254
  # Selector specifying which fields to include in a partial response.
6235
6255
  # @param [String] quota_user
@@ -6261,8 +6281,8 @@ module Google
6261
6281
  # @param [String] sink_name
6262
6282
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
6263
6283
  # " "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
6264
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
6265
- # Example: "projects/my-project-id/sinks/my-sink-id".
6284
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6285
+ # example:"projects/my-project/sinks/my-sink"
6266
6286
  # @param [String] fields
6267
6287
  # Selector specifying which fields to include in a partial response.
6268
6288
  # @param [String] quota_user
@@ -6340,8 +6360,8 @@ module Google
6340
6360
  # Required. The full resource name of the sink to update, including the parent
6341
6361
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6342
6362
  # organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" "billingAccounts/[
6343
- # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]"
6344
- # Example: "projects/my-project-id/sinks/my-sink-id".
6363
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6364
+ # example:"projects/my-project/sinks/my-sink"
6345
6365
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6346
6366
  # @param [Boolean] unique_writer_identity
6347
6367
  # Optional. See sinks.create for a description of this field. When updating a
@@ -6357,10 +6377,11 @@ module Google
6357
6377
  # sink field will be overwritten if, and only if, it is in the update mask. name
6358
6378
  # and output only fields cannot be updated.An empty updateMask is temporarily
6359
6379
  # treated as using the following mask for backwards compatibility purposes:
6360
- # destination,filter,includeChildren At some point in the future, behavior will
6380
+ # destination,filter,includeChildrenAt some point in the future, behavior will
6361
6381
  # be removed and specifying an empty updateMask will be an error.For a detailed
6362
6382
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
6363
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6383
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6384
+ # filter
6364
6385
  # @param [String] fields
6365
6386
  # Selector specifying which fields to include in a partial response.
6366
6387
  # @param [String] quota_user
@@ -6393,17 +6414,18 @@ module Google
6393
6414
  end
6394
6415
 
6395
6416
  # Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
6396
- # Logs Router can currently only be configured for GCP organizations. Once
6397
- # configured, it applies to all projects and folders in the GCP organization.See
6398
- # Enabling CMEK for Logs Router (https://cloud.google.com/logging/docs/routing/
6399
- # managed-encryption) for more information.
6417
+ # Logs Router can currently only be configured for Google Cloud organizations.
6418
+ # Once configured, it applies to all projects and folders in the Google Cloud
6419
+ # organization.See Enabling CMEK for Logs Router (https://cloud.google.com/
6420
+ # logging/docs/routing/managed-encryption) for more information.
6400
6421
  # @param [String] name
6401
6422
  # Required. The resource for which to retrieve CMEK settings. "projects/[
6402
6423
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6403
6424
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6404
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6405
- # Logs Router can currently only be configured for GCP organizations. Once
6406
- # configured, it applies to all projects and folders in the GCP organization.
6425
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6426
+ # Logs Router can currently only be configured for Google Cloud organizations.
6427
+ # Once configured, it applies to all projects and folders in the Google Cloud
6428
+ # organization.
6407
6429
  # @param [String] fields
6408
6430
  # Selector specifying which fields to include in a partial response.
6409
6431
  # @param [String] quota_user
@@ -6432,26 +6454,27 @@ module Google
6432
6454
  end
6433
6455
 
6434
6456
  # Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
6435
- # the Logs Router can currently only be configured for GCP organizations. Once
6436
- # configured, it applies to all projects and folders in the GCP organization.
6437
- # UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
6438
- # associated service account does not have the required roles/cloudkms.
6439
- # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
6440
- # is disabled.See Enabling CMEK for Logs Router (https://cloud.google.com/
6441
- # logging/docs/routing/managed-encryption) for more information.
6457
+ # the Logs Router can currently only be configured for Google Cloud
6458
+ # organizations. Once configured, it applies to all projects and folders in the
6459
+ # Google Cloud organization.UpdateCmekSettings will fail if 1) kms_key_name is
6460
+ # invalid, or 2) the associated service account does not have the required roles/
6461
+ # cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access
6462
+ # to the key is disabled.See Enabling CMEK for Logs Router (https://cloud.google.
6463
+ # com/logging/docs/routing/managed-encryption) for more information.
6442
6464
  # @param [String] name
6443
6465
  # Required. The resource name for the CMEK settings to update. "projects/[
6444
6466
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6445
6467
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6446
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6447
- # Logs Router can currently only be configured for GCP organizations. Once
6448
- # configured, it applies to all projects and folders in the GCP organization.
6468
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6469
+ # Logs Router can currently only be configured for Google Cloud organizations.
6470
+ # Once configured, it applies to all projects and folders in the Google Cloud
6471
+ # organization.
6449
6472
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
6450
6473
  # @param [String] update_mask
6451
6474
  # Optional. Field mask identifying which fields from cmek_settings should be
6452
6475
  # updated. A field will be overwritten if and only if it is in the update mask.
6453
- # Output only fields cannot be updated.See FieldMask for more information.
6454
- # Example: "updateMask=kmsKeyName"
6476
+ # Output only fields cannot be updated.See FieldMask for more information.For
6477
+ # example: "updateMask=kmsKeyName"
6455
6478
  # @param [String] fields
6456
6479
  # Selector specifying which fields to include in a partial response.
6457
6480
  # @param [String] quota_user