google-apis-logging_v2 0.13.0 → 0.14.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.
@@ -52,14 +52,14 @@ module Google
52
52
  @batch_path = 'batch'
53
53
  end
54
54
 
55
- # Gets a bucket.
55
+ # Gets a log bucket.
56
56
  # @param [String] name
57
57
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
58
58
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
59
59
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
60
60
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[FOLDER_ID]/locations/[
61
- # LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-project-id/locations/
62
- # my-location/buckets/my-bucket-id".
61
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
62
+ # global/buckets/my-bucket"
63
63
  # @param [String] fields
64
64
  # Selector specifying which fields to include in a partial response.
65
65
  # @param [String] quota_user
@@ -87,11 +87,11 @@ module Google
87
87
  execute_or_queue_command(command, &block)
88
88
  end
89
89
 
90
- # Gets a view.
90
+ # Gets a view on a log bucket..
91
91
  # @param [String] name
92
92
  # Required. The resource name of the policy: "projects/[PROJECT_ID]/locations/[
93
- # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "projects/my-
94
- # project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id".
93
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
94
+ # project/locations/global/buckets/my-bucket/views/my-view"
95
95
  # @param [String] fields
96
96
  # Selector specifying which fields to include in a partial response.
97
97
  # @param [String] quota_user
@@ -125,8 +125,8 @@ module Google
125
125
  # @param [String] parent
126
126
  # Required. The parent resource in which to create the exclusion: "projects/[
127
127
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
128
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
129
- # project", "organizations/123456789".
128
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
129
+ # project" "organizations/123456789"
130
130
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
131
131
  # @param [String] fields
132
132
  # Selector specifying which fields to include in a partial response.
@@ -162,8 +162,8 @@ module Google
162
162
  # Required. The resource name of an existing exclusion to delete: "projects/[
163
163
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
164
164
  # exclusions/[EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[
165
- # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "
166
- # projects/my-project-id/exclusions/my-exclusion-id".
165
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
166
+ # projects/my-project/exclusions/my-exclusion"
167
167
  # @param [String] fields
168
168
  # Selector specifying which fields to include in a partial response.
169
169
  # @param [String] quota_user
@@ -196,8 +196,8 @@ module Google
196
196
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
197
197
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
198
198
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
199
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
200
- # id/exclusions/my-exclusion-id".
199
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
200
+ # project/exclusions/my-exclusion"
201
201
  # @param [String] fields
202
202
  # Selector specifying which fields to include in a partial response.
203
203
  # @param [String] quota_user
@@ -273,8 +273,8 @@ module Google
273
273
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
274
274
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
275
275
  # EXCLUSION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
276
- # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: "projects/my-project-
277
- # id/exclusions/my-exclusion-id".
276
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
277
+ # project/exclusions/my-exclusion"
278
278
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
279
279
  # @param [String] update_mask
280
280
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -386,12 +386,12 @@ module Google
386
386
  execute_or_queue_command(command, &block)
387
387
  end
388
388
 
389
- # Creates a bucket that can be used to store log entries. Once a bucket has been
390
- # created, the region cannot be changed.
389
+ # Creates a log bucket that can be used to store log entries. After a bucket has
390
+ # been created, the bucket's location cannot be changed.
391
391
  # @param [String] parent
392
- # Required. The resource in which to create the bucket: "projects/[PROJECT_ID]/
393
- # locations/[LOCATION_ID]" Example: "projects/my-logging-project/locations/
394
- # global"
392
+ # Required. The resource in which to create the log bucket: "projects/[
393
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
394
+ # locations/global"
395
395
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
396
396
  # @param [String] bucket_id
397
397
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -427,16 +427,16 @@ module Google
427
427
  execute_or_queue_command(command, &block)
428
428
  end
429
429
 
430
- # Deletes a bucket. Moves the bucket to the DELETE_REQUESTED state. After 7 days,
431
- # the bucket will be purged and all logs in the bucket will be permanently
432
- # deleted.
430
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
431
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
432
+ # entries in the bucket will be permanently deleted.
433
433
  # @param [String] name
434
434
  # Required. The full resource name of the bucket to delete. "projects/[
435
435
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
436
436
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
437
437
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
438
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
439
- # project-id/locations/my-location/buckets/my-bucket-id".
438
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
439
+ # my-project/locations/global/buckets/my-bucket"
440
440
  # @param [String] fields
441
441
  # Selector specifying which fields to include in a partial response.
442
442
  # @param [String] quota_user
@@ -464,7 +464,7 @@ module Google
464
464
  execute_or_queue_command(command, &block)
465
465
  end
466
466
 
467
- # Lists buckets.
467
+ # Lists log buckets.
468
468
  # @param [String] parent
469
469
  # Required. The parent resource whose buckets are to be listed: "projects/[
470
470
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -510,27 +510,27 @@ module Google
510
510
  execute_or_queue_command(command, &block)
511
511
  end
512
512
 
513
- # Updates a bucket. This method replaces the following fields in the existing
514
- # bucket with values from the new bucket: retention_periodIf the retention
515
- # period is decreased and the bucket is locked, FAILED_PRECONDITION will be
516
- # returned.If the bucket has a LifecycleState of DELETE_REQUESTED,
517
- # FAILED_PRECONDITION will be returned.A buckets region may not be modified
518
- # after it is created.
513
+ # Updates a log bucket. This method replaces the following fields in the
514
+ # existing bucket with values from the new bucket: retention_periodIf the
515
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
516
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
517
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
518
+ # bucket's location cannot be changed.
519
519
  # @param [String] name
520
520
  # Required. The full resource name of the bucket to update. "projects/[
521
521
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
522
522
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
523
523
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
524
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
525
- # project-id/locations/my-location/buckets/my-bucket-id". Also requires
526
- # permission "resourcemanager.projects.updateLiens" to set the locked property
524
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
525
+ # my-project/locations/global/buckets/my-bucket"
527
526
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
528
527
  # @param [String] update_mask
529
528
  # Required. Field mask that specifies the fields in bucket that need an update.
530
529
  # A bucket field will be overwritten if, and only if, it is in the update mask.
531
530
  # name and output only fields cannot be updated.For a detailed FieldMask
532
- # definition, see https://developers.google.com/protocol-buffers/docs/reference/
533
- # google.protobuf#google.protobuf.FieldMaskExample: updateMask=retention_days.
531
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
532
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
533
+ # retention_days
534
534
  # @param [String] fields
535
535
  # Selector specifying which fields to include in a partial response.
536
536
  # @param [String] quota_user
@@ -561,15 +561,15 @@ module Google
561
561
  execute_or_queue_command(command, &block)
562
562
  end
563
563
 
564
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
565
- # grace period of 7 days.
564
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
565
+ # the grace period of 7 days.
566
566
  # @param [String] name
567
567
  # Required. The full resource name of the bucket to undelete. "projects/[
568
568
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
569
569
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
570
570
  # [BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "folders/[
571
- # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-
572
- # project-id/locations/my-location/buckets/my-bucket-id".
571
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
572
+ # my-project/locations/global/buckets/my-bucket"
573
573
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
574
574
  # @param [String] fields
575
575
  # Selector specifying which fields to include in a partial response.
@@ -600,12 +600,12 @@ module Google
600
600
  execute_or_queue_command(command, &block)
601
601
  end
602
602
 
603
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
604
- # views.
603
+ # Creates a view over log entries in a log bucket. A bucket may contain a
604
+ # maximum of 30 views.
605
605
  # @param [String] parent
606
- # Required. The bucket in which to create the view "projects/[PROJECT_ID]/
607
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]" Example: "projects/my-logging-
608
- # project/locations/my-location/buckets/my-bucket"
606
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
607
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
608
+ # locations/global/buckets/my-bucket"
609
609
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
610
610
  # @param [String] view_id
611
611
  # Required. The id to use for this view.
@@ -639,12 +639,11 @@ module Google
639
639
  execute_or_queue_command(command, &block)
640
640
  end
641
641
 
642
- # Deletes a view from a bucket.
642
+ # Deletes a view on a log bucket.
643
643
  # @param [String] name
644
644
  # Required. The full resource name of the view to delete: "projects/[PROJECT_ID]/
645
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
646
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
647
- # view-id".
645
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
646
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
648
647
  # @param [String] fields
649
648
  # Selector specifying which fields to include in a partial response.
650
649
  # @param [String] quota_user
@@ -672,12 +671,12 @@ module Google
672
671
  execute_or_queue_command(command, &block)
673
672
  end
674
673
 
675
- # Lists views on a bucket.
674
+ # Lists views on a log bucket.
676
675
  # @param [String] parent
677
676
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
678
677
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
679
678
  # @param [Fixnum] page_size
680
- # Optional. The maximum number of results to return from this request. Non-
679
+ # Optional. The maximum number of results to return from this request.Non-
681
680
  # positive values are ignored. The presence of nextPageToken in the response
682
681
  # indicates that more results might be available.
683
682
  # @param [String] page_token
@@ -714,20 +713,19 @@ module Google
714
713
  execute_or_queue_command(command, &block)
715
714
  end
716
715
 
717
- # Updates a view. This method replaces the following fields in the existing view
718
- # with values from the new view: filter.
716
+ # Updates a view on a log bucket. This method replaces the following fields in
717
+ # the existing view with values from the new view: filter.
719
718
  # @param [String] name
720
719
  # Required. The full resource name of the view to update "projects/[PROJECT_ID]/
721
- # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" Example: "
722
- # projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-
723
- # view-id".
720
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
721
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
724
722
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
725
723
  # @param [String] update_mask
726
724
  # Optional. Field mask that specifies the fields in view that need an update. A
727
725
  # field will be overwritten if, and only if, it is in the update mask. name and
728
726
  # output only fields cannot be updated.For a detailed FieldMask definition, see
729
727
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
730
- # google.protobuf.FieldMaskExample: updateMask=filter.
728
+ # google.protobuf.FieldMaskFor example: updateMask=filter
731
729
  # @param [String] fields
732
730
  # Selector specifying which fields to include in a partial response.
733
731
  # @param [String] quota_user
@@ -974,14 +972,14 @@ module Google
974
972
  # @param [String] parent
975
973
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
976
974
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
977
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
978
- # 123456789".
975
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
976
+ # 123456789"
979
977
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
980
978
  # @param [Boolean] unique_writer_identity
981
979
  # Optional. Determines the kind of IAM identity returned as writer_identity in
982
980
  # the new sink. If this value is omitted or set to false, and if the sink's
983
981
  # 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
982
+ # group or service account used by Cloud Logging before the addition of writer
985
983
  # identities to this API. The sink's destination must be in the same project as
986
984
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
987
985
  # project resource such as an organization, then the value of writer_identity
@@ -1023,8 +1021,8 @@ module Google
1023
1021
  # Required. The full resource name of the sink to delete, including the parent
1024
1022
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1025
1023
  # 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".
1024
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1025
+ # example:"projects/my-project/sinks/my-sink"
1028
1026
  # @param [String] fields
1029
1027
  # Selector specifying which fields to include in a partial response.
1030
1028
  # @param [String] quota_user
@@ -1056,8 +1054,8 @@ module Google
1056
1054
  # @param [String] sink_name
1057
1055
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
1058
1056
  # " "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".
1057
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1058
+ # example:"projects/my-project/sinks/my-sink"
1061
1059
  # @param [String] fields
1062
1060
  # Selector specifying which fields to include in a partial response.
1063
1061
  # @param [String] quota_user
@@ -1135,8 +1133,8 @@ module Google
1135
1133
  # Required. The full resource name of the sink to update, including the parent
1136
1134
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1137
1135
  # 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".
1136
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1137
+ # example:"projects/my-project/sinks/my-sink"
1140
1138
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1141
1139
  # @param [Boolean] unique_writer_identity
1142
1140
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1152,10 +1150,11 @@ module Google
1152
1150
  # sink field will be overwritten if, and only if, it is in the update mask. name
1153
1151
  # and output only fields cannot be updated.An empty updateMask is temporarily
1154
1152
  # treated as using the following mask for backwards compatibility purposes:
1155
- # destination,filter,includeChildren At some point in the future, behavior will
1153
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1156
1154
  # be removed and specifying an empty updateMask will be an error.For a detailed
1157
1155
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1158
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1156
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1157
+ # filter
1159
1158
  # @param [String] fields
1160
1159
  # Selector specifying which fields to include in a partial response.
1161
1160
  # @param [String] quota_user
@@ -1194,8 +1193,8 @@ module Google
1194
1193
  # Required. The full resource name of the sink to update, including the parent
1195
1194
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
1196
1195
  # 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".
1196
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
1197
+ # example:"projects/my-project/sinks/my-sink"
1199
1198
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
1200
1199
  # @param [Boolean] unique_writer_identity
1201
1200
  # Optional. See sinks.create for a description of this field. When updating a
@@ -1211,10 +1210,11 @@ module Google
1211
1210
  # sink field will be overwritten if, and only if, it is in the update mask. name
1212
1211
  # and output only fields cannot be updated.An empty updateMask is temporarily
1213
1212
  # treated as using the following mask for backwards compatibility purposes:
1214
- # destination,filter,includeChildren At some point in the future, behavior will
1213
+ # destination,filter,includeChildrenAt some point in the future, behavior will
1215
1214
  # be removed and specifying an empty updateMask will be an error.For a detailed
1216
1215
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
1217
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
1216
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
1217
+ # filter
1218
1218
  # @param [String] fields
1219
1219
  # Selector specifying which fields to include in a partial response.
1220
1220
  # @param [String] quota_user
@@ -1246,7 +1246,7 @@ module Google
1246
1246
  execute_or_queue_command(command, &block)
1247
1247
  end
1248
1248
 
1249
- # Copies a set of log entries from a logging bucket to a Cloud Storage bucket.
1249
+ # Copies a set of log entries from a log bucket to a Cloud Storage bucket.
1250
1250
  # @param [Google::Apis::LoggingV2::CopyLogEntriesRequest] copy_log_entries_request_object
1251
1251
  # @param [String] fields
1252
1252
  # Selector specifying which fields to include in a partial response.
@@ -1379,8 +1379,8 @@ module Google
1379
1379
  # @param [String] parent
1380
1380
  # Required. The parent resource in which to create the exclusion: "projects/[
1381
1381
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1382
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1383
- # project", "organizations/123456789".
1382
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1383
+ # project" "organizations/123456789"
1384
1384
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1385
1385
  # @param [String] fields
1386
1386
  # Selector specifying which fields to include in a partial response.
@@ -1416,8 +1416,8 @@ module Google
1416
1416
  # Required. The resource name of an existing exclusion to delete: "projects/[
1417
1417
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1418
1418
  # 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".
1419
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
1420
+ # projects/my-project/exclusions/my-exclusion"
1421
1421
  # @param [String] fields
1422
1422
  # Selector specifying which fields to include in a partial response.
1423
1423
  # @param [String] quota_user
@@ -1450,8 +1450,8 @@ module Google
1450
1450
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1451
1451
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1452
1452
  # 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".
1453
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1454
+ # project/exclusions/my-exclusion"
1455
1455
  # @param [String] fields
1456
1456
  # Selector specifying which fields to include in a partial response.
1457
1457
  # @param [String] quota_user
@@ -1527,8 +1527,8 @@ module Google
1527
1527
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1528
1528
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1529
1529
  # 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".
1530
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1531
+ # project/exclusions/my-exclusion"
1532
1532
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1533
1533
  # @param [String] update_mask
1534
1534
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1573,8 +1573,8 @@ module Google
1573
1573
  # @param [String] parent
1574
1574
  # Required. The parent resource in which to create the exclusion: "projects/[
1575
1575
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
1576
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
1577
- # project", "organizations/123456789".
1576
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
1577
+ # project" "organizations/123456789"
1578
1578
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1579
1579
  # @param [String] fields
1580
1580
  # Selector specifying which fields to include in a partial response.
@@ -1610,8 +1610,8 @@ module Google
1610
1610
  # Required. The resource name of an existing exclusion to delete: "projects/[
1611
1611
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
1612
1612
  # 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".
1613
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
1614
+ # projects/my-project/exclusions/my-exclusion"
1615
1615
  # @param [String] fields
1616
1616
  # Selector specifying which fields to include in a partial response.
1617
1617
  # @param [String] quota_user
@@ -1644,8 +1644,8 @@ module Google
1644
1644
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
1645
1645
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1646
1646
  # 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".
1647
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1648
+ # project/exclusions/my-exclusion"
1649
1649
  # @param [String] fields
1650
1650
  # Selector specifying which fields to include in a partial response.
1651
1651
  # @param [String] quota_user
@@ -1721,8 +1721,8 @@ module Google
1721
1721
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
1722
1722
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
1723
1723
  # 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".
1724
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
1725
+ # project/exclusions/my-exclusion"
1726
1726
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
1727
1727
  # @param [String] update_mask
1728
1728
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -1834,12 +1834,12 @@ module Google
1834
1834
  execute_or_queue_command(command, &block)
1835
1835
  end
1836
1836
 
1837
- # Creates a bucket that can be used to store log entries. Once a bucket has been
1838
- # created, the region cannot be changed.
1837
+ # Creates a log bucket that can be used to store log entries. After a bucket has
1838
+ # been created, the bucket's location cannot be changed.
1839
1839
  # @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"
1840
+ # Required. The resource in which to create the log bucket: "projects/[
1841
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
1842
+ # locations/global"
1843
1843
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
1844
1844
  # @param [String] bucket_id
1845
1845
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -1875,16 +1875,16 @@ module Google
1875
1875
  execute_or_queue_command(command, &block)
1876
1876
  end
1877
1877
 
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.
1878
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
1879
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
1880
+ # entries in the bucket will be permanently deleted.
1881
1881
  # @param [String] name
1882
1882
  # Required. The full resource name of the bucket to delete. "projects/[
1883
1883
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
1884
1884
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
1885
1885
  # [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".
1886
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
1887
+ # my-project/locations/global/buckets/my-bucket"
1888
1888
  # @param [String] fields
1889
1889
  # Selector specifying which fields to include in a partial response.
1890
1890
  # @param [String] quota_user
@@ -1912,14 +1912,14 @@ module Google
1912
1912
  execute_or_queue_command(command, &block)
1913
1913
  end
1914
1914
 
1915
- # Gets a bucket.
1915
+ # Gets a log bucket.
1916
1916
  # @param [String] name
1917
1917
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
1918
1918
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
1919
1919
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
1920
1920
  # 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".
1921
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
1922
+ # global/buckets/my-bucket"
1923
1923
  # @param [String] fields
1924
1924
  # Selector specifying which fields to include in a partial response.
1925
1925
  # @param [String] quota_user
@@ -1947,7 +1947,7 @@ module Google
1947
1947
  execute_or_queue_command(command, &block)
1948
1948
  end
1949
1949
 
1950
- # Lists buckets.
1950
+ # Lists log buckets.
1951
1951
  # @param [String] parent
1952
1952
  # Required. The parent resource whose buckets are to be listed: "projects/[
1953
1953
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -1993,27 +1993,27 @@ module Google
1993
1993
  execute_or_queue_command(command, &block)
1994
1994
  end
1995
1995
 
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.
1996
+ # Updates a log bucket. This method replaces the following fields in the
1997
+ # existing bucket with values from the new bucket: retention_periodIf the
1998
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
1999
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
2000
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
2001
+ # bucket's location cannot be changed.
2002
2002
  # @param [String] name
2003
2003
  # Required. The full resource name of the bucket to update. "projects/[
2004
2004
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2005
2005
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2006
2006
  # [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
2007
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2008
+ # my-project/locations/global/buckets/my-bucket"
2010
2009
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2011
2010
  # @param [String] update_mask
2012
2011
  # Required. Field mask that specifies the fields in bucket that need an update.
2013
2012
  # A bucket field will be overwritten if, and only if, it is in the update mask.
2014
2013
  # 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.
2014
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
2015
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2016
+ # retention_days
2017
2017
  # @param [String] fields
2018
2018
  # Selector specifying which fields to include in a partial response.
2019
2019
  # @param [String] quota_user
@@ -2044,15 +2044,15 @@ module Google
2044
2044
  execute_or_queue_command(command, &block)
2045
2045
  end
2046
2046
 
2047
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
2048
- # grace period of 7 days.
2047
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
2048
+ # the grace period of 7 days.
2049
2049
  # @param [String] name
2050
2050
  # Required. The full resource name of the bucket to undelete. "projects/[
2051
2051
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2052
2052
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2053
2053
  # [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".
2054
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2055
+ # my-project/locations/global/buckets/my-bucket"
2056
2056
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
2057
2057
  # @param [String] fields
2058
2058
  # Selector specifying which fields to include in a partial response.
@@ -2083,12 +2083,12 @@ module Google
2083
2083
  execute_or_queue_command(command, &block)
2084
2084
  end
2085
2085
 
2086
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
2087
- # views.
2086
+ # Creates a view over log entries in a log bucket. A bucket may contain a
2087
+ # maximum of 30 views.
2088
2088
  # @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"
2089
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
2090
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
2091
+ # locations/global/buckets/my-bucket"
2092
2092
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2093
2093
  # @param [String] view_id
2094
2094
  # Required. The id to use for this view.
@@ -2122,12 +2122,11 @@ module Google
2122
2122
  execute_or_queue_command(command, &block)
2123
2123
  end
2124
2124
 
2125
- # Deletes a view from a bucket.
2125
+ # Deletes a view on a log bucket.
2126
2126
  # @param [String] name
2127
2127
  # 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".
2128
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
2129
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2131
2130
  # @param [String] fields
2132
2131
  # Selector specifying which fields to include in a partial response.
2133
2132
  # @param [String] quota_user
@@ -2155,11 +2154,11 @@ module Google
2155
2154
  execute_or_queue_command(command, &block)
2156
2155
  end
2157
2156
 
2158
- # Gets a view.
2157
+ # Gets a view on a log bucket..
2159
2158
  # @param [String] name
2160
2159
  # 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".
2160
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
2161
+ # project/locations/global/buckets/my-bucket/views/my-view"
2163
2162
  # @param [String] fields
2164
2163
  # Selector specifying which fields to include in a partial response.
2165
2164
  # @param [String] quota_user
@@ -2187,12 +2186,12 @@ module Google
2187
2186
  execute_or_queue_command(command, &block)
2188
2187
  end
2189
2188
 
2190
- # Lists views on a bucket.
2189
+ # Lists views on a log bucket.
2191
2190
  # @param [String] parent
2192
2191
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
2193
2192
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
2194
2193
  # @param [Fixnum] page_size
2195
- # Optional. The maximum number of results to return from this request. Non-
2194
+ # Optional. The maximum number of results to return from this request.Non-
2196
2195
  # positive values are ignored. The presence of nextPageToken in the response
2197
2196
  # indicates that more results might be available.
2198
2197
  # @param [String] page_token
@@ -2229,20 +2228,19 @@ module Google
2229
2228
  execute_or_queue_command(command, &block)
2230
2229
  end
2231
2230
 
2232
- # Updates a view. This method replaces the following fields in the existing view
2233
- # with values from the new view: filter.
2231
+ # Updates a view on a log bucket. This method replaces the following fields in
2232
+ # the existing view with values from the new view: filter.
2234
2233
  # @param [String] name
2235
2234
  # 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".
2235
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
2236
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
2239
2237
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
2240
2238
  # @param [String] update_mask
2241
2239
  # Optional. Field mask that specifies the fields in view that need an update. A
2242
2240
  # field will be overwritten if, and only if, it is in the update mask. name and
2243
2241
  # output only fields cannot be updated.For a detailed FieldMask definition, see
2244
2242
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
2245
- # google.protobuf.FieldMaskExample: updateMask=filter.
2243
+ # google.protobuf.FieldMaskFor example: updateMask=filter
2246
2244
  # @param [String] fields
2247
2245
  # Selector specifying which fields to include in a partial response.
2248
2246
  # @param [String] quota_user
@@ -2489,14 +2487,14 @@ module Google
2489
2487
  # @param [String] parent
2490
2488
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
2491
2489
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
2492
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
2493
- # 123456789".
2490
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
2491
+ # 123456789"
2494
2492
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2495
2493
  # @param [Boolean] unique_writer_identity
2496
2494
  # Optional. Determines the kind of IAM identity returned as writer_identity in
2497
2495
  # the new sink. If this value is omitted or set to false, and if the sink's
2498
2496
  # 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
2497
+ # group or service account used by Cloud Logging before the addition of writer
2500
2498
  # identities to this API. The sink's destination must be in the same project as
2501
2499
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
2502
2500
  # project resource such as an organization, then the value of writer_identity
@@ -2538,8 +2536,8 @@ module Google
2538
2536
  # Required. The full resource name of the sink to delete, including the parent
2539
2537
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2540
2538
  # 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".
2539
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2540
+ # example:"projects/my-project/sinks/my-sink"
2543
2541
  # @param [String] fields
2544
2542
  # Selector specifying which fields to include in a partial response.
2545
2543
  # @param [String] quota_user
@@ -2571,8 +2569,8 @@ module Google
2571
2569
  # @param [String] sink_name
2572
2570
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
2573
2571
  # " "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".
2572
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2573
+ # example:"projects/my-project/sinks/my-sink"
2576
2574
  # @param [String] fields
2577
2575
  # Selector specifying which fields to include in a partial response.
2578
2576
  # @param [String] quota_user
@@ -2650,8 +2648,8 @@ module Google
2650
2648
  # Required. The full resource name of the sink to update, including the parent
2651
2649
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2652
2650
  # 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".
2651
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2652
+ # example:"projects/my-project/sinks/my-sink"
2655
2653
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2656
2654
  # @param [Boolean] unique_writer_identity
2657
2655
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2667,10 +2665,11 @@ module Google
2667
2665
  # sink field will be overwritten if, and only if, it is in the update mask. name
2668
2666
  # and output only fields cannot be updated.An empty updateMask is temporarily
2669
2667
  # treated as using the following mask for backwards compatibility purposes:
2670
- # destination,filter,includeChildren At some point in the future, behavior will
2668
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2671
2669
  # be removed and specifying an empty updateMask will be an error.For a detailed
2672
2670
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2673
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2671
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2672
+ # filter
2674
2673
  # @param [String] fields
2675
2674
  # Selector specifying which fields to include in a partial response.
2676
2675
  # @param [String] quota_user
@@ -2709,8 +2708,8 @@ module Google
2709
2708
  # Required. The full resource name of the sink to update, including the parent
2710
2709
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
2711
2710
  # 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".
2711
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
2712
+ # example:"projects/my-project/sinks/my-sink"
2714
2713
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
2715
2714
  # @param [Boolean] unique_writer_identity
2716
2715
  # Optional. See sinks.create for a description of this field. When updating a
@@ -2726,10 +2725,11 @@ module Google
2726
2725
  # sink field will be overwritten if, and only if, it is in the update mask. name
2727
2726
  # and output only fields cannot be updated.An empty updateMask is temporarily
2728
2727
  # treated as using the following mask for backwards compatibility purposes:
2729
- # destination,filter,includeChildren At some point in the future, behavior will
2728
+ # destination,filter,includeChildrenAt some point in the future, behavior will
2730
2729
  # be removed and specifying an empty updateMask will be an error.For a detailed
2731
2730
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
2732
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
2731
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
2732
+ # filter
2733
2733
  # @param [String] fields
2734
2734
  # Selector specifying which fields to include in a partial response.
2735
2735
  # @param [String] quota_user
@@ -2834,12 +2834,12 @@ module Google
2834
2834
  execute_or_queue_command(command, &block)
2835
2835
  end
2836
2836
 
2837
- # Creates a bucket that can be used to store log entries. Once a bucket has been
2838
- # created, the region cannot be changed.
2837
+ # Creates a log bucket that can be used to store log entries. After a bucket has
2838
+ # been created, the bucket's location cannot be changed.
2839
2839
  # @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"
2840
+ # Required. The resource in which to create the log bucket: "projects/[
2841
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
2842
+ # locations/global"
2843
2843
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
2844
2844
  # @param [String] bucket_id
2845
2845
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -2875,16 +2875,16 @@ module Google
2875
2875
  execute_or_queue_command(command, &block)
2876
2876
  end
2877
2877
 
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.
2878
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
2879
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
2880
+ # entries in the bucket will be permanently deleted.
2881
2881
  # @param [String] name
2882
2882
  # Required. The full resource name of the bucket to delete. "projects/[
2883
2883
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
2884
2884
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
2885
2885
  # [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".
2886
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
2887
+ # my-project/locations/global/buckets/my-bucket"
2888
2888
  # @param [String] fields
2889
2889
  # Selector specifying which fields to include in a partial response.
2890
2890
  # @param [String] quota_user
@@ -2912,14 +2912,14 @@ module Google
2912
2912
  execute_or_queue_command(command, &block)
2913
2913
  end
2914
2914
 
2915
- # Gets a bucket.
2915
+ # Gets a log bucket.
2916
2916
  # @param [String] name
2917
2917
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
2918
2918
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
2919
2919
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
2920
2920
  # 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".
2921
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
2922
+ # global/buckets/my-bucket"
2923
2923
  # @param [String] fields
2924
2924
  # Selector specifying which fields to include in a partial response.
2925
2925
  # @param [String] quota_user
@@ -2947,7 +2947,7 @@ module Google
2947
2947
  execute_or_queue_command(command, &block)
2948
2948
  end
2949
2949
 
2950
- # Lists buckets.
2950
+ # Lists log buckets.
2951
2951
  # @param [String] parent
2952
2952
  # Required. The parent resource whose buckets are to be listed: "projects/[
2953
2953
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -2993,27 +2993,27 @@ module Google
2993
2993
  execute_or_queue_command(command, &block)
2994
2994
  end
2995
2995
 
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.
2996
+ # Updates a log bucket. This method replaces the following fields in the
2997
+ # existing bucket with values from the new bucket: retention_periodIf the
2998
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
2999
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
3000
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
3001
+ # bucket's location cannot be changed.
3002
3002
  # @param [String] name
3003
3003
  # Required. The full resource name of the bucket to update. "projects/[
3004
3004
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3005
3005
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3006
3006
  # [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
3007
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3008
+ # my-project/locations/global/buckets/my-bucket"
3010
3009
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3011
3010
  # @param [String] update_mask
3012
3011
  # Required. Field mask that specifies the fields in bucket that need an update.
3013
3012
  # A bucket field will be overwritten if, and only if, it is in the update mask.
3014
3013
  # 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.
3014
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
3015
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
3016
+ # retention_days
3017
3017
  # @param [String] fields
3018
3018
  # Selector specifying which fields to include in a partial response.
3019
3019
  # @param [String] quota_user
@@ -3044,15 +3044,15 @@ module Google
3044
3044
  execute_or_queue_command(command, &block)
3045
3045
  end
3046
3046
 
3047
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
3048
- # grace period of 7 days.
3047
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
3048
+ # the grace period of 7 days.
3049
3049
  # @param [String] name
3050
3050
  # Required. The full resource name of the bucket to undelete. "projects/[
3051
3051
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3052
3052
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3053
3053
  # [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".
3054
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3055
+ # my-project/locations/global/buckets/my-bucket"
3056
3056
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
3057
3057
  # @param [String] fields
3058
3058
  # Selector specifying which fields to include in a partial response.
@@ -3083,12 +3083,12 @@ module Google
3083
3083
  execute_or_queue_command(command, &block)
3084
3084
  end
3085
3085
 
3086
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
3087
- # views.
3086
+ # Creates a view over log entries in a log bucket. A bucket may contain a
3087
+ # maximum of 30 views.
3088
3088
  # @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"
3089
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
3090
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
3091
+ # locations/global/buckets/my-bucket"
3092
3092
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3093
3093
  # @param [String] view_id
3094
3094
  # Required. The id to use for this view.
@@ -3122,12 +3122,11 @@ module Google
3122
3122
  execute_or_queue_command(command, &block)
3123
3123
  end
3124
3124
 
3125
- # Deletes a view from a bucket.
3125
+ # Deletes a view on a log bucket.
3126
3126
  # @param [String] name
3127
3127
  # 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".
3128
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3129
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3131
3130
  # @param [String] fields
3132
3131
  # Selector specifying which fields to include in a partial response.
3133
3132
  # @param [String] quota_user
@@ -3155,11 +3154,11 @@ module Google
3155
3154
  execute_or_queue_command(command, &block)
3156
3155
  end
3157
3156
 
3158
- # Gets a view.
3157
+ # Gets a view on a log bucket..
3159
3158
  # @param [String] name
3160
3159
  # 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".
3160
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
3161
+ # project/locations/global/buckets/my-bucket/views/my-view"
3163
3162
  # @param [String] fields
3164
3163
  # Selector specifying which fields to include in a partial response.
3165
3164
  # @param [String] quota_user
@@ -3187,12 +3186,12 @@ module Google
3187
3186
  execute_or_queue_command(command, &block)
3188
3187
  end
3189
3188
 
3190
- # Lists views on a bucket.
3189
+ # Lists views on a log bucket.
3191
3190
  # @param [String] parent
3192
3191
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
3193
3192
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
3194
3193
  # @param [Fixnum] page_size
3195
- # Optional. The maximum number of results to return from this request. Non-
3194
+ # Optional. The maximum number of results to return from this request.Non-
3196
3195
  # positive values are ignored. The presence of nextPageToken in the response
3197
3196
  # indicates that more results might be available.
3198
3197
  # @param [String] page_token
@@ -3229,20 +3228,19 @@ module Google
3229
3228
  execute_or_queue_command(command, &block)
3230
3229
  end
3231
3230
 
3232
- # Updates a view. This method replaces the following fields in the existing view
3233
- # with values from the new view: filter.
3231
+ # Updates a view on a log bucket. This method replaces the following fields in
3232
+ # the existing view with values from the new view: filter.
3234
3233
  # @param [String] name
3235
3234
  # 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".
3235
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
3236
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
3239
3237
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
3240
3238
  # @param [String] update_mask
3241
3239
  # Optional. Field mask that specifies the fields in view that need an update. A
3242
3240
  # field will be overwritten if, and only if, it is in the update mask. name and
3243
3241
  # output only fields cannot be updated.For a detailed FieldMask definition, see
3244
3242
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
3245
- # google.protobuf.FieldMaskExample: updateMask=filter.
3243
+ # google.protobuf.FieldMaskFor example: updateMask=filter
3246
3244
  # @param [String] fields
3247
3245
  # Selector specifying which fields to include in a partial response.
3248
3246
  # @param [String] quota_user
@@ -3529,7 +3527,7 @@ module Google
3529
3527
  # Required. The resource for which to retrieve CMEK settings. "projects/[
3530
3528
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3531
3529
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3532
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3530
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3533
3531
  # Logs Router can currently only be configured for GCP organizations. Once
3534
3532
  # configured, it applies to all projects and folders in the GCP organization.
3535
3533
  # @param [String] fields
@@ -3571,15 +3569,15 @@ module Google
3571
3569
  # Required. The resource name for the CMEK settings to update. "projects/[
3572
3570
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
3573
3571
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
3574
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
3572
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
3575
3573
  # Logs Router can currently only be configured for GCP organizations. Once
3576
3574
  # configured, it applies to all projects and folders in the GCP organization.
3577
3575
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
3578
3576
  # @param [String] update_mask
3579
3577
  # Optional. Field mask identifying which fields from cmek_settings should be
3580
3578
  # 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"
3579
+ # Output only fields cannot be updated.See FieldMask for more information.For
3580
+ # example: "updateMask=kmsKeyName"
3583
3581
  # @param [String] fields
3584
3582
  # Selector specifying which fields to include in a partial response.
3585
3583
  # @param [String] quota_user
@@ -3616,8 +3614,8 @@ module Google
3616
3614
  # @param [String] parent
3617
3615
  # Required. The parent resource in which to create the exclusion: "projects/[
3618
3616
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
3619
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
3620
- # project", "organizations/123456789".
3617
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
3618
+ # project" "organizations/123456789"
3621
3619
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3622
3620
  # @param [String] fields
3623
3621
  # Selector specifying which fields to include in a partial response.
@@ -3653,8 +3651,8 @@ module Google
3653
3651
  # Required. The resource name of an existing exclusion to delete: "projects/[
3654
3652
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
3655
3653
  # 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".
3654
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
3655
+ # projects/my-project/exclusions/my-exclusion"
3658
3656
  # @param [String] fields
3659
3657
  # Selector specifying which fields to include in a partial response.
3660
3658
  # @param [String] quota_user
@@ -3687,8 +3685,8 @@ module Google
3687
3685
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
3688
3686
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3689
3687
  # 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".
3688
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3689
+ # project/exclusions/my-exclusion"
3692
3690
  # @param [String] fields
3693
3691
  # Selector specifying which fields to include in a partial response.
3694
3692
  # @param [String] quota_user
@@ -3764,8 +3762,8 @@ module Google
3764
3762
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
3765
3763
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
3766
3764
  # 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".
3765
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
3766
+ # project/exclusions/my-exclusion"
3769
3767
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
3770
3768
  # @param [String] update_mask
3771
3769
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -3877,12 +3875,12 @@ module Google
3877
3875
  execute_or_queue_command(command, &block)
3878
3876
  end
3879
3877
 
3880
- # Creates a bucket that can be used to store log entries. Once a bucket has been
3881
- # created, the region cannot be changed.
3878
+ # Creates a log bucket that can be used to store log entries. After a bucket has
3879
+ # been created, the bucket's location cannot be changed.
3882
3880
  # @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"
3881
+ # Required. The resource in which to create the log bucket: "projects/[
3882
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
3883
+ # locations/global"
3886
3884
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
3887
3885
  # @param [String] bucket_id
3888
3886
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -3918,16 +3916,16 @@ module Google
3918
3916
  execute_or_queue_command(command, &block)
3919
3917
  end
3920
3918
 
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.
3919
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
3920
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
3921
+ # entries in the bucket will be permanently deleted.
3924
3922
  # @param [String] name
3925
3923
  # Required. The full resource name of the bucket to delete. "projects/[
3926
3924
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
3927
3925
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
3928
3926
  # [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".
3927
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
3928
+ # my-project/locations/global/buckets/my-bucket"
3931
3929
  # @param [String] fields
3932
3930
  # Selector specifying which fields to include in a partial response.
3933
3931
  # @param [String] quota_user
@@ -3955,14 +3953,14 @@ module Google
3955
3953
  execute_or_queue_command(command, &block)
3956
3954
  end
3957
3955
 
3958
- # Gets a bucket.
3956
+ # Gets a log bucket.
3959
3957
  # @param [String] name
3960
3958
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
3961
3959
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
3962
3960
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
3963
3961
  # 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".
3962
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
3963
+ # global/buckets/my-bucket"
3966
3964
  # @param [String] fields
3967
3965
  # Selector specifying which fields to include in a partial response.
3968
3966
  # @param [String] quota_user
@@ -3990,7 +3988,7 @@ module Google
3990
3988
  execute_or_queue_command(command, &block)
3991
3989
  end
3992
3990
 
3993
- # Lists buckets.
3991
+ # Lists log buckets.
3994
3992
  # @param [String] parent
3995
3993
  # Required. The parent resource whose buckets are to be listed: "projects/[
3996
3994
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -4036,27 +4034,27 @@ module Google
4036
4034
  execute_or_queue_command(command, &block)
4037
4035
  end
4038
4036
 
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.
4037
+ # Updates a log bucket. This method replaces the following fields in the
4038
+ # existing bucket with values from the new bucket: retention_periodIf the
4039
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
4040
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
4041
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
4042
+ # bucket's location cannot be changed.
4045
4043
  # @param [String] name
4046
4044
  # Required. The full resource name of the bucket to update. "projects/[
4047
4045
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4048
4046
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4049
4047
  # [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
4048
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4049
+ # my-project/locations/global/buckets/my-bucket"
4053
4050
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
4054
4051
  # @param [String] update_mask
4055
4052
  # Required. Field mask that specifies the fields in bucket that need an update.
4056
4053
  # A bucket field will be overwritten if, and only if, it is in the update mask.
4057
4054
  # 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.
4055
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
4056
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4057
+ # retention_days
4060
4058
  # @param [String] fields
4061
4059
  # Selector specifying which fields to include in a partial response.
4062
4060
  # @param [String] quota_user
@@ -4087,15 +4085,15 @@ module Google
4087
4085
  execute_or_queue_command(command, &block)
4088
4086
  end
4089
4087
 
4090
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
4091
- # grace period of 7 days.
4088
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
4089
+ # the grace period of 7 days.
4092
4090
  # @param [String] name
4093
4091
  # Required. The full resource name of the bucket to undelete. "projects/[
4094
4092
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
4095
4093
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
4096
4094
  # [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".
4095
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
4096
+ # my-project/locations/global/buckets/my-bucket"
4099
4097
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
4100
4098
  # @param [String] fields
4101
4099
  # Selector specifying which fields to include in a partial response.
@@ -4126,12 +4124,12 @@ module Google
4126
4124
  execute_or_queue_command(command, &block)
4127
4125
  end
4128
4126
 
4129
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
4130
- # views.
4127
+ # Creates a view over log entries in a log bucket. A bucket may contain a
4128
+ # maximum of 30 views.
4131
4129
  # @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"
4130
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
4131
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
4132
+ # locations/global/buckets/my-bucket"
4135
4133
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4136
4134
  # @param [String] view_id
4137
4135
  # Required. The id to use for this view.
@@ -4165,12 +4163,11 @@ module Google
4165
4163
  execute_or_queue_command(command, &block)
4166
4164
  end
4167
4165
 
4168
- # Deletes a view from a bucket.
4166
+ # Deletes a view on a log bucket.
4169
4167
  # @param [String] name
4170
4168
  # 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".
4169
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4170
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4174
4171
  # @param [String] fields
4175
4172
  # Selector specifying which fields to include in a partial response.
4176
4173
  # @param [String] quota_user
@@ -4198,11 +4195,11 @@ module Google
4198
4195
  execute_or_queue_command(command, &block)
4199
4196
  end
4200
4197
 
4201
- # Gets a view.
4198
+ # Gets a view on a log bucket..
4202
4199
  # @param [String] name
4203
4200
  # 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".
4201
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
4202
+ # project/locations/global/buckets/my-bucket/views/my-view"
4206
4203
  # @param [String] fields
4207
4204
  # Selector specifying which fields to include in a partial response.
4208
4205
  # @param [String] quota_user
@@ -4230,12 +4227,12 @@ module Google
4230
4227
  execute_or_queue_command(command, &block)
4231
4228
  end
4232
4229
 
4233
- # Lists views on a bucket.
4230
+ # Lists views on a log bucket.
4234
4231
  # @param [String] parent
4235
4232
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
4236
4233
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
4237
4234
  # @param [Fixnum] page_size
4238
- # Optional. The maximum number of results to return from this request. Non-
4235
+ # Optional. The maximum number of results to return from this request.Non-
4239
4236
  # positive values are ignored. The presence of nextPageToken in the response
4240
4237
  # indicates that more results might be available.
4241
4238
  # @param [String] page_token
@@ -4272,20 +4269,19 @@ module Google
4272
4269
  execute_or_queue_command(command, &block)
4273
4270
  end
4274
4271
 
4275
- # Updates a view. This method replaces the following fields in the existing view
4276
- # with values from the new view: filter.
4272
+ # Updates a view on a log bucket. This method replaces the following fields in
4273
+ # the existing view with values from the new view: filter.
4277
4274
  # @param [String] name
4278
4275
  # 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".
4276
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
4277
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
4282
4278
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
4283
4279
  # @param [String] update_mask
4284
4280
  # Optional. Field mask that specifies the fields in view that need an update. A
4285
4281
  # field will be overwritten if, and only if, it is in the update mask. name and
4286
4282
  # output only fields cannot be updated.For a detailed FieldMask definition, see
4287
4283
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
4288
- # google.protobuf.FieldMaskExample: updateMask=filter.
4284
+ # google.protobuf.FieldMaskFor example: updateMask=filter
4289
4285
  # @param [String] fields
4290
4286
  # Selector specifying which fields to include in a partial response.
4291
4287
  # @param [String] quota_user
@@ -4532,14 +4528,14 @@ module Google
4532
4528
  # @param [String] parent
4533
4529
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
4534
4530
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
4535
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
4536
- # 123456789".
4531
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
4532
+ # 123456789"
4537
4533
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4538
4534
  # @param [Boolean] unique_writer_identity
4539
4535
  # Optional. Determines the kind of IAM identity returned as writer_identity in
4540
4536
  # the new sink. If this value is omitted or set to false, and if the sink's
4541
4537
  # 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
4538
+ # group or service account used by Cloud Logging before the addition of writer
4543
4539
  # identities to this API. The sink's destination must be in the same project as
4544
4540
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
4545
4541
  # project resource such as an organization, then the value of writer_identity
@@ -4581,8 +4577,8 @@ module Google
4581
4577
  # Required. The full resource name of the sink to delete, including the parent
4582
4578
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4583
4579
  # 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".
4580
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4581
+ # example:"projects/my-project/sinks/my-sink"
4586
4582
  # @param [String] fields
4587
4583
  # Selector specifying which fields to include in a partial response.
4588
4584
  # @param [String] quota_user
@@ -4614,8 +4610,8 @@ module Google
4614
4610
  # @param [String] sink_name
4615
4611
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
4616
4612
  # " "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".
4613
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4614
+ # example:"projects/my-project/sinks/my-sink"
4619
4615
  # @param [String] fields
4620
4616
  # Selector specifying which fields to include in a partial response.
4621
4617
  # @param [String] quota_user
@@ -4693,8 +4689,8 @@ module Google
4693
4689
  # Required. The full resource name of the sink to update, including the parent
4694
4690
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4695
4691
  # 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".
4692
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4693
+ # example:"projects/my-project/sinks/my-sink"
4698
4694
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4699
4695
  # @param [Boolean] unique_writer_identity
4700
4696
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4710,10 +4706,11 @@ module Google
4710
4706
  # sink field will be overwritten if, and only if, it is in the update mask. name
4711
4707
  # and output only fields cannot be updated.An empty updateMask is temporarily
4712
4708
  # treated as using the following mask for backwards compatibility purposes:
4713
- # destination,filter,includeChildren At some point in the future, behavior will
4709
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4714
4710
  # be removed and specifying an empty updateMask will be an error.For a detailed
4715
4711
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4716
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4712
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4713
+ # filter
4717
4714
  # @param [String] fields
4718
4715
  # Selector specifying which fields to include in a partial response.
4719
4716
  # @param [String] quota_user
@@ -4752,8 +4749,8 @@ module Google
4752
4749
  # Required. The full resource name of the sink to update, including the parent
4753
4750
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
4754
4751
  # 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".
4752
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
4753
+ # example:"projects/my-project/sinks/my-sink"
4757
4754
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
4758
4755
  # @param [Boolean] unique_writer_identity
4759
4756
  # Optional. See sinks.create for a description of this field. When updating a
@@ -4769,10 +4766,11 @@ module Google
4769
4766
  # sink field will be overwritten if, and only if, it is in the update mask. name
4770
4767
  # and output only fields cannot be updated.An empty updateMask is temporarily
4771
4768
  # treated as using the following mask for backwards compatibility purposes:
4772
- # destination,filter,includeChildren At some point in the future, behavior will
4769
+ # destination,filter,includeChildrenAt some point in the future, behavior will
4773
4770
  # be removed and specifying an empty updateMask will be an error.For a detailed
4774
4771
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
4775
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
4772
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
4773
+ # filter
4776
4774
  # @param [String] fields
4777
4775
  # Selector specifying which fields to include in a partial response.
4778
4776
  # @param [String] quota_user
@@ -4810,8 +4808,8 @@ module Google
4810
4808
  # @param [String] parent
4811
4809
  # Required. The parent resource in which to create the exclusion: "projects/[
4812
4810
  # PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[
4813
- # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: "projects/my-logging-
4814
- # project", "organizations/123456789".
4811
+ # BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" For examples:"projects/my-logging-
4812
+ # project" "organizations/123456789"
4815
4813
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4816
4814
  # @param [String] fields
4817
4815
  # Selector specifying which fields to include in a partial response.
@@ -4847,8 +4845,8 @@ module Google
4847
4845
  # Required. The resource name of an existing exclusion to delete: "projects/[
4848
4846
  # PROJECT_ID]/exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/
4849
4847
  # 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".
4848
+ # EXCLUSION_ID]" "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"
4849
+ # projects/my-project/exclusions/my-exclusion"
4852
4850
  # @param [String] fields
4853
4851
  # Selector specifying which fields to include in a partial response.
4854
4852
  # @param [String] quota_user
@@ -4881,8 +4879,8 @@ module Google
4881
4879
  # Required. The resource name of an existing exclusion: "projects/[PROJECT_ID]/
4882
4880
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4883
4881
  # 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".
4882
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4883
+ # project/exclusions/my-exclusion"
4886
4884
  # @param [String] fields
4887
4885
  # Selector specifying which fields to include in a partial response.
4888
4886
  # @param [String] quota_user
@@ -4958,8 +4956,8 @@ module Google
4958
4956
  # Required. The resource name of the exclusion to update: "projects/[PROJECT_ID]/
4959
4957
  # exclusions/[EXCLUSION_ID]" "organizations/[ORGANIZATION_ID]/exclusions/[
4960
4958
  # 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".
4959
+ # "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" For example:"projects/my-
4960
+ # project/exclusions/my-exclusion"
4963
4961
  # @param [Google::Apis::LoggingV2::LogExclusion] log_exclusion_object
4964
4962
  # @param [String] update_mask
4965
4963
  # Required. A non-empty list of fields to change in the existing exclusion. New
@@ -5071,12 +5069,12 @@ module Google
5071
5069
  execute_or_queue_command(command, &block)
5072
5070
  end
5073
5071
 
5074
- # Creates a bucket that can be used to store log entries. Once a bucket has been
5075
- # created, the region cannot be changed.
5072
+ # Creates a log bucket that can be used to store log entries. After a bucket has
5073
+ # been created, the bucket's location cannot be changed.
5076
5074
  # @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"
5075
+ # Required. The resource in which to create the log bucket: "projects/[
5076
+ # PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/
5077
+ # locations/global"
5080
5078
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5081
5079
  # @param [String] bucket_id
5082
5080
  # Required. A client-assigned identifier such as "my-bucket". Identifiers are
@@ -5112,16 +5110,16 @@ module Google
5112
5110
  execute_or_queue_command(command, &block)
5113
5111
  end
5114
5112
 
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.
5113
+ # Deletes a log bucket.Changes the bucket's lifecycle_state to the
5114
+ # DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log
5115
+ # entries in the bucket will be permanently deleted.
5118
5116
  # @param [String] name
5119
5117
  # Required. The full resource name of the bucket to delete. "projects/[
5120
5118
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5121
5119
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5122
5120
  # [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".
5121
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5122
+ # my-project/locations/global/buckets/my-bucket"
5125
5123
  # @param [String] fields
5126
5124
  # Selector specifying which fields to include in a partial response.
5127
5125
  # @param [String] quota_user
@@ -5149,14 +5147,14 @@ module Google
5149
5147
  execute_or_queue_command(command, &block)
5150
5148
  end
5151
5149
 
5152
- # Gets a bucket.
5150
+ # Gets a log bucket.
5153
5151
  # @param [String] name
5154
5152
  # Required. The resource name of the bucket: "projects/[PROJECT_ID]/locations/[
5155
5153
  # LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[ORGANIZATION_ID]/locations/[
5156
5154
  # LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]/
5157
5155
  # 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".
5156
+ # LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/my-project/locations/
5157
+ # global/buckets/my-bucket"
5160
5158
  # @param [String] fields
5161
5159
  # Selector specifying which fields to include in a partial response.
5162
5160
  # @param [String] quota_user
@@ -5184,7 +5182,7 @@ module Google
5184
5182
  execute_or_queue_command(command, &block)
5185
5183
  end
5186
5184
 
5187
- # Lists buckets.
5185
+ # Lists log buckets.
5188
5186
  # @param [String] parent
5189
5187
  # Required. The parent resource whose buckets are to be listed: "projects/[
5190
5188
  # PROJECT_ID]/locations/[LOCATION_ID]" "organizations/[ORGANIZATION_ID]/
@@ -5230,27 +5228,27 @@ module Google
5230
5228
  execute_or_queue_command(command, &block)
5231
5229
  end
5232
5230
 
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.
5231
+ # Updates a log bucket. This method replaces the following fields in the
5232
+ # existing bucket with values from the new bucket: retention_periodIf the
5233
+ # retention period is decreased and the bucket is locked, FAILED_PRECONDITION
5234
+ # will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then
5235
+ # FAILED_PRECONDITION will be returned.After a bucket has been created, the
5236
+ # bucket's location cannot be changed.
5239
5237
  # @param [String] name
5240
5238
  # Required. The full resource name of the bucket to update. "projects/[
5241
5239
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5242
5240
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5243
5241
  # [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
5242
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5243
+ # my-project/locations/global/buckets/my-bucket"
5247
5244
  # @param [Google::Apis::LoggingV2::LogBucket] log_bucket_object
5248
5245
  # @param [String] update_mask
5249
5246
  # Required. Field mask that specifies the fields in bucket that need an update.
5250
5247
  # A bucket field will be overwritten if, and only if, it is in the update mask.
5251
5248
  # 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.
5249
+ # definition, see: https://developers.google.com/protocol-buffers/docs/reference/
5250
+ # google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
5251
+ # retention_days
5254
5252
  # @param [String] fields
5255
5253
  # Selector specifying which fields to include in a partial response.
5256
5254
  # @param [String] quota_user
@@ -5281,15 +5279,15 @@ module Google
5281
5279
  execute_or_queue_command(command, &block)
5282
5280
  end
5283
5281
 
5284
- # Undeletes a bucket. A bucket that has been deleted may be undeleted within the
5285
- # grace period of 7 days.
5282
+ # Undeletes a log bucket. A bucket that has been deleted can be undeleted within
5283
+ # the grace period of 7 days.
5286
5284
  # @param [String] name
5287
5285
  # Required. The full resource name of the bucket to undelete. "projects/[
5288
5286
  # PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "organizations/[
5289
5287
  # ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" "billingAccounts/
5290
5288
  # [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".
5289
+ # FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]" For example:"projects/
5290
+ # my-project/locations/global/buckets/my-bucket"
5293
5291
  # @param [Google::Apis::LoggingV2::UndeleteBucketRequest] undelete_bucket_request_object
5294
5292
  # @param [String] fields
5295
5293
  # Selector specifying which fields to include in a partial response.
@@ -5320,12 +5318,12 @@ module Google
5320
5318
  execute_or_queue_command(command, &block)
5321
5319
  end
5322
5320
 
5323
- # Creates a view over logs in a bucket. A bucket may contain a maximum of 50
5324
- # views.
5321
+ # Creates a view over log entries in a log bucket. A bucket may contain a
5322
+ # maximum of 30 views.
5325
5323
  # @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"
5324
+ # Required. The bucket in which to create the view `"projects/[PROJECT_ID]/
5325
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"` For example:"projects/my-project/
5326
+ # locations/global/buckets/my-bucket"
5329
5327
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
5330
5328
  # @param [String] view_id
5331
5329
  # Required. The id to use for this view.
@@ -5359,12 +5357,11 @@ module Google
5359
5357
  execute_or_queue_command(command, &block)
5360
5358
  end
5361
5359
 
5362
- # Deletes a view from a bucket.
5360
+ # Deletes a view on a log bucket.
5363
5361
  # @param [String] name
5364
5362
  # 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".
5363
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5364
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
5368
5365
  # @param [String] fields
5369
5366
  # Selector specifying which fields to include in a partial response.
5370
5367
  # @param [String] quota_user
@@ -5392,11 +5389,11 @@ module Google
5392
5389
  execute_or_queue_command(command, &block)
5393
5390
  end
5394
5391
 
5395
- # Gets a view.
5392
+ # Gets a view on a log bucket..
5396
5393
  # @param [String] name
5397
5394
  # 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".
5395
+ # LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"projects/my-
5396
+ # project/locations/global/buckets/my-bucket/views/my-view"
5400
5397
  # @param [String] fields
5401
5398
  # Selector specifying which fields to include in a partial response.
5402
5399
  # @param [String] quota_user
@@ -5424,12 +5421,12 @@ module Google
5424
5421
  execute_or_queue_command(command, &block)
5425
5422
  end
5426
5423
 
5427
- # Lists views on a bucket.
5424
+ # Lists views on a log bucket.
5428
5425
  # @param [String] parent
5429
5426
  # Required. The bucket whose views are to be listed: "projects/[PROJECT_ID]/
5430
5427
  # locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
5431
5428
  # @param [Fixnum] page_size
5432
- # Optional. The maximum number of results to return from this request. Non-
5429
+ # Optional. The maximum number of results to return from this request.Non-
5433
5430
  # positive values are ignored. The presence of nextPageToken in the response
5434
5431
  # indicates that more results might be available.
5435
5432
  # @param [String] page_token
@@ -5466,20 +5463,19 @@ module Google
5466
5463
  execute_or_queue_command(command, &block)
5467
5464
  end
5468
5465
 
5469
- # Updates a view. This method replaces the following fields in the existing view
5470
- # with values from the new view: filter.
5466
+ # Updates a view on a log bucket. This method replaces the following fields in
5467
+ # the existing view with values from the new view: filter.
5471
5468
  # @param [String] name
5472
5469
  # 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".
5470
+ # locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]" For example:"
5471
+ # projects/my-project/locations/global/buckets/my-bucket/views/my-view"
5476
5472
  # @param [Google::Apis::LoggingV2::LogView] log_view_object
5477
5473
  # @param [String] update_mask
5478
5474
  # Optional. Field mask that specifies the fields in view that need an update. A
5479
5475
  # field will be overwritten if, and only if, it is in the update mask. name and
5480
5476
  # output only fields cannot be updated.For a detailed FieldMask definition, see
5481
5477
  # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
5482
- # google.protobuf.FieldMaskExample: updateMask=filter.
5478
+ # google.protobuf.FieldMaskFor example: updateMask=filter
5483
5479
  # @param [String] fields
5484
5480
  # Selector specifying which fields to include in a partial response.
5485
5481
  # @param [String] quota_user
@@ -5900,14 +5896,14 @@ module Google
5900
5896
  # @param [String] parent
5901
5897
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
5902
5898
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
5903
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
5904
- # 123456789".
5899
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
5900
+ # 123456789"
5905
5901
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
5906
5902
  # @param [Boolean] unique_writer_identity
5907
5903
  # Optional. Determines the kind of IAM identity returned as writer_identity in
5908
5904
  # the new sink. If this value is omitted or set to false, and if the sink's
5909
5905
  # 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
5906
+ # group or service account used by Cloud Logging before the addition of writer
5911
5907
  # identities to this API. The sink's destination must be in the same project as
5912
5908
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
5913
5909
  # project resource such as an organization, then the value of writer_identity
@@ -5949,8 +5945,8 @@ module Google
5949
5945
  # Required. The full resource name of the sink to delete, including the parent
5950
5946
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
5951
5947
  # 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".
5948
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
5949
+ # example:"projects/my-project/sinks/my-sink"
5954
5950
  # @param [String] fields
5955
5951
  # Selector specifying which fields to include in a partial response.
5956
5952
  # @param [String] quota_user
@@ -5982,8 +5978,8 @@ module Google
5982
5978
  # @param [String] sink_name
5983
5979
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
5984
5980
  # " "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".
5981
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
5982
+ # example:"projects/my-project/sinks/my-sink"
5987
5983
  # @param [String] fields
5988
5984
  # Selector specifying which fields to include in a partial response.
5989
5985
  # @param [String] quota_user
@@ -6061,8 +6057,8 @@ module Google
6061
6057
  # Required. The full resource name of the sink to update, including the parent
6062
6058
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6063
6059
  # 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".
6060
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6061
+ # example:"projects/my-project/sinks/my-sink"
6066
6062
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6067
6063
  # @param [Boolean] unique_writer_identity
6068
6064
  # Optional. See sinks.create for a description of this field. When updating a
@@ -6078,10 +6074,11 @@ module Google
6078
6074
  # sink field will be overwritten if, and only if, it is in the update mask. name
6079
6075
  # and output only fields cannot be updated.An empty updateMask is temporarily
6080
6076
  # treated as using the following mask for backwards compatibility purposes:
6081
- # destination,filter,includeChildren At some point in the future, behavior will
6077
+ # destination,filter,includeChildrenAt some point in the future, behavior will
6082
6078
  # be removed and specifying an empty updateMask will be an error.For a detailed
6083
6079
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
6084
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6080
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6081
+ # filter
6085
6082
  # @param [String] fields
6086
6083
  # Selector specifying which fields to include in a partial response.
6087
6084
  # @param [String] quota_user
@@ -6120,8 +6117,8 @@ module Google
6120
6117
  # Required. The full resource name of the sink to update, including the parent
6121
6118
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6122
6119
  # 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".
6120
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6121
+ # example:"projects/my-project/sinks/my-sink"
6125
6122
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6126
6123
  # @param [Boolean] unique_writer_identity
6127
6124
  # Optional. See sinks.create for a description of this field. When updating a
@@ -6137,10 +6134,11 @@ module Google
6137
6134
  # sink field will be overwritten if, and only if, it is in the update mask. name
6138
6135
  # and output only fields cannot be updated.An empty updateMask is temporarily
6139
6136
  # treated as using the following mask for backwards compatibility purposes:
6140
- # destination,filter,includeChildren At some point in the future, behavior will
6137
+ # destination,filter,includeChildrenAt some point in the future, behavior will
6141
6138
  # be removed and specifying an empty updateMask will be an error.For a detailed
6142
6139
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
6143
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6140
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6141
+ # filter
6144
6142
  # @param [String] fields
6145
6143
  # Selector specifying which fields to include in a partial response.
6146
6144
  # @param [String] quota_user
@@ -6179,14 +6177,14 @@ module Google
6179
6177
  # @param [String] parent
6180
6178
  # Required. The resource in which to create the sink: "projects/[PROJECT_ID]" "
6181
6179
  # organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "
6182
- # folders/[FOLDER_ID]" Examples: "projects/my-logging-project", "organizations/
6183
- # 123456789".
6180
+ # folders/[FOLDER_ID]" For examples:"projects/my-project" "organizations/
6181
+ # 123456789"
6184
6182
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6185
6183
  # @param [Boolean] unique_writer_identity
6186
6184
  # Optional. Determines the kind of IAM identity returned as writer_identity in
6187
6185
  # the new sink. If this value is omitted or set to false, and if the sink's
6188
6186
  # 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
6187
+ # group or service account used by Cloud Logging before the addition of writer
6190
6188
  # identities to this API. The sink's destination must be in the same project as
6191
6189
  # the sink itself.If this field is set to true, or if the sink is owned by a non-
6192
6190
  # project resource such as an organization, then the value of writer_identity
@@ -6228,8 +6226,8 @@ module Google
6228
6226
  # Required. The full resource name of the sink to delete, including the parent
6229
6227
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6230
6228
  # 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".
6229
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6230
+ # example:"projects/my-project/sinks/my-sink"
6233
6231
  # @param [String] fields
6234
6232
  # Selector specifying which fields to include in a partial response.
6235
6233
  # @param [String] quota_user
@@ -6261,8 +6259,8 @@ module Google
6261
6259
  # @param [String] sink_name
6262
6260
  # Required. The resource name of the sink: "projects/[PROJECT_ID]/sinks/[SINK_ID]
6263
6261
  # " "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".
6262
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6263
+ # example:"projects/my-project/sinks/my-sink"
6266
6264
  # @param [String] fields
6267
6265
  # Selector specifying which fields to include in a partial response.
6268
6266
  # @param [String] quota_user
@@ -6340,8 +6338,8 @@ module Google
6340
6338
  # Required. The full resource name of the sink to update, including the parent
6341
6339
  # resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" "
6342
6340
  # 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".
6341
+ # BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" "folders/[FOLDER_ID]/sinks/[SINK_ID]" For
6342
+ # example:"projects/my-project/sinks/my-sink"
6345
6343
  # @param [Google::Apis::LoggingV2::LogSink] log_sink_object
6346
6344
  # @param [Boolean] unique_writer_identity
6347
6345
  # Optional. See sinks.create for a description of this field. When updating a
@@ -6357,10 +6355,11 @@ module Google
6357
6355
  # sink field will be overwritten if, and only if, it is in the update mask. name
6358
6356
  # and output only fields cannot be updated.An empty updateMask is temporarily
6359
6357
  # treated as using the following mask for backwards compatibility purposes:
6360
- # destination,filter,includeChildren At some point in the future, behavior will
6358
+ # destination,filter,includeChildrenAt some point in the future, behavior will
6361
6359
  # be removed and specifying an empty updateMask will be an error.For a detailed
6362
6360
  # FieldMask definition, see https://developers.google.com/protocol-buffers/docs/
6363
- # reference/google.protobuf#google.protobuf.FieldMaskExample: updateMask=filter.
6361
+ # reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=
6362
+ # filter
6364
6363
  # @param [String] fields
6365
6364
  # Selector specifying which fields to include in a partial response.
6366
6365
  # @param [String] quota_user
@@ -6401,7 +6400,7 @@ module Google
6401
6400
  # Required. The resource for which to retrieve CMEK settings. "projects/[
6402
6401
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6403
6402
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6404
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6403
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6405
6404
  # Logs Router can currently only be configured for GCP organizations. Once
6406
6405
  # configured, it applies to all projects and folders in the GCP organization.
6407
6406
  # @param [String] fields
@@ -6443,15 +6442,15 @@ module Google
6443
6442
  # Required. The resource name for the CMEK settings to update. "projects/[
6444
6443
  # PROJECT_ID]/cmekSettings" "organizations/[ORGANIZATION_ID]/cmekSettings" "
6445
6444
  # billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings" "folders/[FOLDER_ID]/
6446
- # cmekSettings" Example: "organizations/12345/cmekSettings".Note: CMEK for the
6445
+ # cmekSettings" For example:"organizations/12345/cmekSettings"Note: CMEK for the
6447
6446
  # Logs Router can currently only be configured for GCP organizations. Once
6448
6447
  # configured, it applies to all projects and folders in the GCP organization.
6449
6448
  # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
6450
6449
  # @param [String] update_mask
6451
6450
  # Optional. Field mask identifying which fields from cmek_settings should be
6452
6451
  # 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"
6452
+ # Output only fields cannot be updated.See FieldMask for more information.For
6453
+ # example: "updateMask=kmsKeyName"
6455
6454
  # @param [String] fields
6456
6455
  # Selector specifying which fields to include in a partial response.
6457
6456
  # @param [String] quota_user