google-apis-logging_v2 0.13.0 → 0.14.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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