google-apis-logging_v2 0.13.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -0
  3. data/OVERVIEW.md +2 -2
  4. data/lib/google/apis/logging_v2/classes.rb +88 -82
  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