google-cloud-logging-v2 0.5.5 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.yardopts +1 -1
- data/AUTHENTICATION.md +13 -31
- data/README.md +4 -4
- data/lib/google/cloud/logging/v2/config_service/client.rb +507 -104
- data/lib/google/cloud/logging/v2/config_service/operations.rb +767 -0
- data/lib/google/cloud/logging/v2/config_service/paths.rb +53 -0
- data/lib/google/cloud/logging/v2/config_service.rb +1 -0
- data/lib/google/cloud/logging/v2/logging_service/client.rb +45 -41
- data/lib/google/cloud/logging/v2/version.rb +1 -1
- data/lib/google/cloud/logging/v2.rb +4 -2
- data/lib/google/logging/v2/log_entry_pb.rb +7 -2
- data/lib/google/logging/v2/logging_config_pb.rb +52 -2
- data/lib/google/logging/v2/logging_config_services_pb.rb +78 -39
- data/lib/google/logging/v2/logging_metrics_pb.rb +2 -3
- data/lib/google/logging/v2/logging_pb.rb +1 -4
- data/lib/google/logging/v2/logging_services_pb.rb +4 -4
- data/proto_docs/google/api/resource.rb +10 -71
- data/proto_docs/google/logging/v2/log_entry.rb +42 -4
- data/proto_docs/google/logging/v2/logging.rb +50 -45
- data/proto_docs/google/logging/v2/logging_config.rb +456 -152
- data/proto_docs/google/logging/v2/logging_metrics.rb +9 -5
- data/proto_docs/google/longrunning/operations.rb +164 -0
- metadata +5 -3
@@ -174,6 +174,12 @@ module Google
|
|
174
174
|
@quota_project_id = @config.quota_project
|
175
175
|
@quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
|
176
176
|
|
177
|
+
@operations_client = Operations.new do |config|
|
178
|
+
config.credentials = credentials
|
179
|
+
config.quota_project = @quota_project_id
|
180
|
+
config.endpoint = @config.endpoint
|
181
|
+
end
|
182
|
+
|
177
183
|
@config_service_stub = ::Gapic::ServiceStub.new(
|
178
184
|
::Google::Cloud::Logging::V2::ConfigServiceV2::Stub,
|
179
185
|
credentials: credentials,
|
@@ -183,10 +189,17 @@ module Google
|
|
183
189
|
)
|
184
190
|
end
|
185
191
|
|
192
|
+
##
|
193
|
+
# Get the associated client for long-running operations.
|
194
|
+
#
|
195
|
+
# @return [::Google::Cloud::Logging::V2::ConfigService::Operations]
|
196
|
+
#
|
197
|
+
attr_reader :operations_client
|
198
|
+
|
186
199
|
# Service calls
|
187
200
|
|
188
201
|
##
|
189
|
-
# Lists buckets.
|
202
|
+
# Lists log buckets.
|
190
203
|
#
|
191
204
|
# @overload list_buckets(request, options = nil)
|
192
205
|
# Pass arguments to `list_buckets` via a request object, either of type
|
@@ -215,14 +228,14 @@ module Google
|
|
215
228
|
# supplying the character `-` in place of [LOCATION_ID] will return all
|
216
229
|
# buckets.
|
217
230
|
# @param page_token [::String]
|
218
|
-
# Optional. If present, then retrieve the next batch of results from the
|
219
|
-
#
|
220
|
-
#
|
221
|
-
#
|
231
|
+
# Optional. If present, then retrieve the next batch of results from the preceding call
|
232
|
+
# to this method. `pageToken` must be the value of `nextPageToken` from the
|
233
|
+
# previous response. The values of other method parameters should be
|
234
|
+
# identical to those in the previous call.
|
222
235
|
# @param page_size [::Integer]
|
223
|
-
# Optional. The maximum number of results to return from this request.
|
224
|
-
#
|
225
|
-
#
|
236
|
+
# Optional. The maximum number of results to return from this request. Non-positive
|
237
|
+
# values are ignored. The presence of `nextPageToken` in the response
|
238
|
+
# indicates that more results might be available.
|
226
239
|
#
|
227
240
|
# @yield [response, operation] Access the result along with the RPC operation
|
228
241
|
# @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Logging::V2::LogBucket>]
|
@@ -296,7 +309,7 @@ module Google
|
|
296
309
|
end
|
297
310
|
|
298
311
|
##
|
299
|
-
# Gets a bucket.
|
312
|
+
# Gets a log bucket.
|
300
313
|
#
|
301
314
|
# @overload get_bucket(request, options = nil)
|
302
315
|
# Pass arguments to `get_bucket` via a request object, either of type
|
@@ -321,8 +334,9 @@ module Google
|
|
321
334
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
322
335
|
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
323
336
|
#
|
324
|
-
#
|
325
|
-
#
|
337
|
+
# For example:
|
338
|
+
#
|
339
|
+
# `"projects/my-project/locations/global/buckets/my-bucket"`
|
326
340
|
#
|
327
341
|
# @yield [response, operation] Access the result along with the RPC operation
|
328
342
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogBucket]
|
@@ -389,8 +403,8 @@ module Google
|
|
389
403
|
end
|
390
404
|
|
391
405
|
##
|
392
|
-
# Creates a bucket that can be used to store log entries.
|
393
|
-
# been created, the
|
406
|
+
# Creates a log bucket that can be used to store log entries. After a bucket
|
407
|
+
# has been created, the bucket's location cannot be changed.
|
394
408
|
#
|
395
409
|
# @overload create_bucket(request, options = nil)
|
396
410
|
# Pass arguments to `create_bucket` via a request object, either of type
|
@@ -408,15 +422,17 @@ module Google
|
|
408
422
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
409
423
|
#
|
410
424
|
# @param parent [::String]
|
411
|
-
# Required. The resource in which to create the bucket:
|
425
|
+
# Required. The resource in which to create the log bucket:
|
412
426
|
#
|
413
427
|
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
|
414
428
|
#
|
415
|
-
#
|
429
|
+
# For example:
|
430
|
+
#
|
431
|
+
# `"projects/my-project/locations/global"`
|
416
432
|
# @param bucket_id [::String]
|
417
|
-
# Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are
|
418
|
-
#
|
419
|
-
#
|
433
|
+
# Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are limited
|
434
|
+
# to 100 characters and can include only letters, digits, underscores,
|
435
|
+
# hyphens, and periods.
|
420
436
|
# @param bucket [::Google::Cloud::Logging::V2::LogBucket, ::Hash]
|
421
437
|
# Required. The new bucket. The region specified in the new bucket must be compliant
|
422
438
|
# with any Location Restriction Org Policy. The name field in the bucket is
|
@@ -487,16 +503,16 @@ module Google
|
|
487
503
|
end
|
488
504
|
|
489
505
|
##
|
490
|
-
# Updates a bucket. This method replaces the following fields in the
|
506
|
+
# Updates a log bucket. This method replaces the following fields in the
|
491
507
|
# existing bucket with values from the new bucket: `retention_period`
|
492
508
|
#
|
493
509
|
# If the retention period is decreased and the bucket is locked,
|
494
|
-
# FAILED_PRECONDITION will be returned.
|
510
|
+
# `FAILED_PRECONDITION` will be returned.
|
495
511
|
#
|
496
|
-
# If the bucket has a
|
497
|
-
# will be returned.
|
512
|
+
# If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then
|
513
|
+
# `FAILED_PRECONDITION` will be returned.
|
498
514
|
#
|
499
|
-
#
|
515
|
+
# After a bucket has been created, the bucket's location cannot be changed.
|
500
516
|
#
|
501
517
|
# @overload update_bucket(request, options = nil)
|
502
518
|
# Pass arguments to `update_bucket` via a request object, either of type
|
@@ -521,21 +537,20 @@ module Google
|
|
521
537
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
522
538
|
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
523
539
|
#
|
524
|
-
#
|
525
|
-
#
|
526
|
-
#
|
527
|
-
# locked property
|
540
|
+
# For example:
|
541
|
+
#
|
542
|
+
# `"projects/my-project/locations/global/buckets/my-bucket"`
|
528
543
|
# @param bucket [::Google::Cloud::Logging::V2::LogBucket, ::Hash]
|
529
544
|
# Required. The updated bucket.
|
530
545
|
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
531
546
|
# Required. Field mask that specifies the fields in `bucket` that need an update. A
|
532
|
-
# bucket field will be overwritten if, and only if, it is in the update
|
533
|
-
#
|
547
|
+
# bucket field will be overwritten if, and only if, it is in the update mask.
|
548
|
+
# `name` and output only fields cannot be updated.
|
534
549
|
#
|
535
|
-
# For a detailed `FieldMask` definition, see
|
550
|
+
# For a detailed `FieldMask` definition, see:
|
536
551
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
|
537
552
|
#
|
538
|
-
#
|
553
|
+
# For example: `updateMask=retention_days`
|
539
554
|
#
|
540
555
|
# @yield [response, operation] Access the result along with the RPC operation
|
541
556
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogBucket]
|
@@ -602,10 +617,11 @@ module Google
|
|
602
617
|
end
|
603
618
|
|
604
619
|
##
|
605
|
-
# Deletes a bucket.
|
606
|
-
#
|
607
|
-
#
|
608
|
-
#
|
620
|
+
# Deletes a log bucket.
|
621
|
+
#
|
622
|
+
# Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state.
|
623
|
+
# After 7 days, the bucket will be purged and all log entries in the bucket
|
624
|
+
# will be permanently deleted.
|
609
625
|
#
|
610
626
|
# @overload delete_bucket(request, options = nil)
|
611
627
|
# Pass arguments to `delete_bucket` via a request object, either of type
|
@@ -630,8 +646,9 @@ module Google
|
|
630
646
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
631
647
|
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
632
648
|
#
|
633
|
-
#
|
634
|
-
#
|
649
|
+
# For example:
|
650
|
+
#
|
651
|
+
# `"projects/my-project/locations/global/buckets/my-bucket"`
|
635
652
|
#
|
636
653
|
# @yield [response, operation] Access the result along with the RPC operation
|
637
654
|
# @yieldparam response [::Google::Protobuf::Empty]
|
@@ -698,8 +715,8 @@ module Google
|
|
698
715
|
end
|
699
716
|
|
700
717
|
##
|
701
|
-
# Undeletes a bucket. A bucket that has been deleted
|
702
|
-
# the grace period of 7 days.
|
718
|
+
# Undeletes a log bucket. A bucket that has been deleted can be undeleted
|
719
|
+
# within the grace period of 7 days.
|
703
720
|
#
|
704
721
|
# @overload undelete_bucket(request, options = nil)
|
705
722
|
# Pass arguments to `undelete_bucket` via a request object, either of type
|
@@ -724,8 +741,9 @@ module Google
|
|
724
741
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
725
742
|
# "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
726
743
|
#
|
727
|
-
#
|
728
|
-
#
|
744
|
+
# For example:
|
745
|
+
#
|
746
|
+
# `"projects/my-project/locations/global/buckets/my-bucket"`
|
729
747
|
#
|
730
748
|
# @yield [response, operation] Access the result along with the RPC operation
|
731
749
|
# @yieldparam response [::Google::Protobuf::Empty]
|
@@ -792,7 +810,7 @@ module Google
|
|
792
810
|
end
|
793
811
|
|
794
812
|
##
|
795
|
-
# Lists views on a bucket.
|
813
|
+
# Lists views on a log bucket.
|
796
814
|
#
|
797
815
|
# @overload list_views(request, options = nil)
|
798
816
|
# Pass arguments to `list_views` via a request object, either of type
|
@@ -814,12 +832,13 @@ module Google
|
|
814
832
|
#
|
815
833
|
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
816
834
|
# @param page_token [::String]
|
817
|
-
# Optional. If present, then retrieve the next batch of results from the
|
818
|
-
#
|
819
|
-
#
|
820
|
-
#
|
835
|
+
# Optional. If present, then retrieve the next batch of results from the preceding call
|
836
|
+
# to this method. `pageToken` must be the value of `nextPageToken` from the
|
837
|
+
# previous response. The values of other method parameters should be
|
838
|
+
# identical to those in the previous call.
|
821
839
|
# @param page_size [::Integer]
|
822
840
|
# Optional. The maximum number of results to return from this request.
|
841
|
+
#
|
823
842
|
# Non-positive values are ignored. The presence of `nextPageToken` in the
|
824
843
|
# response indicates that more results might be available.
|
825
844
|
#
|
@@ -895,7 +914,7 @@ module Google
|
|
895
914
|
end
|
896
915
|
|
897
916
|
##
|
898
|
-
# Gets a view
|
917
|
+
# Gets a view on a log bucket..
|
899
918
|
#
|
900
919
|
# @overload get_view(request, options = nil)
|
901
920
|
# Pass arguments to `get_view` via a request object, either of type
|
@@ -917,8 +936,9 @@ module Google
|
|
917
936
|
#
|
918
937
|
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
919
938
|
#
|
920
|
-
#
|
921
|
-
#
|
939
|
+
# For example:
|
940
|
+
#
|
941
|
+
# `"projects/my-project/locations/global/buckets/my-bucket/views/my-view"`
|
922
942
|
#
|
923
943
|
# @yield [response, operation] Access the result along with the RPC operation
|
924
944
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogView]
|
@@ -985,8 +1005,8 @@ module Google
|
|
985
1005
|
end
|
986
1006
|
|
987
1007
|
##
|
988
|
-
# Creates a view over
|
989
|
-
#
|
1008
|
+
# Creates a view over log entries in a log bucket. A bucket may contain a
|
1009
|
+
# maximum of 30 views.
|
990
1010
|
#
|
991
1011
|
# @overload create_view(request, options = nil)
|
992
1012
|
# Pass arguments to `create_view` via a request object, either of type
|
@@ -1006,10 +1026,11 @@ module Google
|
|
1006
1026
|
# @param parent [::String]
|
1007
1027
|
# Required. The bucket in which to create the view
|
1008
1028
|
#
|
1009
|
-
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
|
1029
|
+
# `"projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"`
|
1030
|
+
#
|
1031
|
+
# For example:
|
1010
1032
|
#
|
1011
|
-
#
|
1012
|
-
# `"projects/my-logging-project/locations/my-location/buckets/my-bucket"`
|
1033
|
+
# `"projects/my-project/locations/global/buckets/my-bucket"`
|
1013
1034
|
# @param view_id [::String]
|
1014
1035
|
# Required. The id to use for this view.
|
1015
1036
|
# @param view [::Google::Cloud::Logging::V2::LogView, ::Hash]
|
@@ -1080,8 +1101,11 @@ module Google
|
|
1080
1101
|
end
|
1081
1102
|
|
1082
1103
|
##
|
1083
|
-
# Updates a view. This method replaces the following fields
|
1084
|
-
# view with values from the new view: `filter`.
|
1104
|
+
# Updates a view on a log bucket. This method replaces the following fields
|
1105
|
+
# in the existing view with values from the new view: `filter`.
|
1106
|
+
# If an `UNAVAILABLE` error is returned, this indicates that system is not in
|
1107
|
+
# a state where it can update the view. If this occurs, please try again in a
|
1108
|
+
# few minutes.
|
1085
1109
|
#
|
1086
1110
|
# @overload update_view(request, options = nil)
|
1087
1111
|
# Pass arguments to `update_view` via a request object, either of type
|
@@ -1103,8 +1127,9 @@ module Google
|
|
1103
1127
|
#
|
1104
1128
|
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
1105
1129
|
#
|
1106
|
-
#
|
1107
|
-
#
|
1130
|
+
# For example:
|
1131
|
+
#
|
1132
|
+
# `"projects/my-project/locations/global/buckets/my-bucket/views/my-view"`
|
1108
1133
|
# @param view [::Google::Cloud::Logging::V2::LogView, ::Hash]
|
1109
1134
|
# Required. The updated view.
|
1110
1135
|
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
@@ -1115,7 +1140,7 @@ module Google
|
|
1115
1140
|
# For a detailed `FieldMask` definition, see
|
1116
1141
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
|
1117
1142
|
#
|
1118
|
-
#
|
1143
|
+
# For example: `updateMask=filter`
|
1119
1144
|
#
|
1120
1145
|
# @yield [response, operation] Access the result along with the RPC operation
|
1121
1146
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogView]
|
@@ -1182,7 +1207,10 @@ module Google
|
|
1182
1207
|
end
|
1183
1208
|
|
1184
1209
|
##
|
1185
|
-
# Deletes a view
|
1210
|
+
# Deletes a view on a log bucket.
|
1211
|
+
# If an `UNAVAILABLE` error is returned, this indicates that system is not in
|
1212
|
+
# a state where it can delete the view. If this occurs, please try again in a
|
1213
|
+
# few minutes.
|
1186
1214
|
#
|
1187
1215
|
# @overload delete_view(request, options = nil)
|
1188
1216
|
# Pass arguments to `delete_view` via a request object, either of type
|
@@ -1204,8 +1232,9 @@ module Google
|
|
1204
1232
|
#
|
1205
1233
|
# "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
|
1206
1234
|
#
|
1207
|
-
#
|
1208
|
-
#
|
1235
|
+
# For example:
|
1236
|
+
#
|
1237
|
+
# `"projects/my-project/locations/global/buckets/my-bucket/views/my-view"`
|
1209
1238
|
#
|
1210
1239
|
# @yield [response, operation] Access the result along with the RPC operation
|
1211
1240
|
# @yieldparam response [::Google::Protobuf::Empty]
|
@@ -1403,7 +1432,9 @@ module Google
|
|
1403
1432
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
|
1404
1433
|
# "folders/[FOLDER_ID]/sinks/[SINK_ID]"
|
1405
1434
|
#
|
1406
|
-
#
|
1435
|
+
# For example:
|
1436
|
+
#
|
1437
|
+
# `"projects/my-project/sinks/my-sink"`
|
1407
1438
|
#
|
1408
1439
|
# @yield [response, operation] Access the result along with the RPC operation
|
1409
1440
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogSink]
|
@@ -1498,7 +1529,10 @@ module Google
|
|
1498
1529
|
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
1499
1530
|
# "folders/[FOLDER_ID]"
|
1500
1531
|
#
|
1501
|
-
#
|
1532
|
+
# For examples:
|
1533
|
+
#
|
1534
|
+
# `"projects/my-project"`
|
1535
|
+
# `"organizations/123456789"`
|
1502
1536
|
# @param sink [::Google::Cloud::Logging::V2::LogSink, ::Hash]
|
1503
1537
|
# Required. The new sink, whose `name` parameter is a sink identifier that
|
1504
1538
|
# is not already in use.
|
@@ -1506,9 +1540,9 @@ module Google
|
|
1506
1540
|
# Optional. Determines the kind of IAM identity returned as `writer_identity`
|
1507
1541
|
# in the new sink. If this value is omitted or set to false, and if the
|
1508
1542
|
# sink's parent is a project, then the value returned as `writer_identity` is
|
1509
|
-
# the same group or service account used by Logging before the addition
|
1510
|
-
# writer identities to this API. The sink's destination must be in the
|
1511
|
-
# project as the sink itself.
|
1543
|
+
# the same group or service account used by Cloud Logging before the addition
|
1544
|
+
# of writer identities to this API. The sink's destination must be in the
|
1545
|
+
# same project as the sink itself.
|
1512
1546
|
#
|
1513
1547
|
# If this field is set to true, or if the sink is owned by a non-project
|
1514
1548
|
# resource such as an organization, then the value of `writer_identity` will
|
@@ -1610,7 +1644,9 @@ module Google
|
|
1610
1644
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
|
1611
1645
|
# "folders/[FOLDER_ID]/sinks/[SINK_ID]"
|
1612
1646
|
#
|
1613
|
-
#
|
1647
|
+
# For example:
|
1648
|
+
#
|
1649
|
+
# `"projects/my-project/sinks/my-sink"`
|
1614
1650
|
# @param sink [::Google::Cloud::Logging::V2::LogSink, ::Hash]
|
1615
1651
|
# Required. The updated sink, whose name is the same identifier that appears as part
|
1616
1652
|
# of `sink_name`.
|
@@ -1631,16 +1667,18 @@ module Google
|
|
1631
1667
|
# an update. A sink field will be overwritten if, and only if, it is
|
1632
1668
|
# in the update mask. `name` and output only fields cannot be updated.
|
1633
1669
|
#
|
1634
|
-
# An empty updateMask is temporarily treated as using the following mask
|
1670
|
+
# An empty `updateMask` is temporarily treated as using the following mask
|
1635
1671
|
# for backwards compatibility purposes:
|
1636
|
-
#
|
1672
|
+
#
|
1673
|
+
# `destination,filter,includeChildren`
|
1674
|
+
#
|
1637
1675
|
# At some point in the future, behavior will be removed and specifying an
|
1638
|
-
# empty updateMask will be an error.
|
1676
|
+
# empty `updateMask` will be an error.
|
1639
1677
|
#
|
1640
1678
|
# For a detailed `FieldMask` definition, see
|
1641
1679
|
# https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
|
1642
1680
|
#
|
1643
|
-
#
|
1681
|
+
# For example: `updateMask=filter`
|
1644
1682
|
#
|
1645
1683
|
# @yield [response, operation] Access the result along with the RPC operation
|
1646
1684
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogSink]
|
@@ -1734,7 +1772,9 @@ module Google
|
|
1734
1772
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
|
1735
1773
|
# "folders/[FOLDER_ID]/sinks/[SINK_ID]"
|
1736
1774
|
#
|
1737
|
-
#
|
1775
|
+
# For example:
|
1776
|
+
#
|
1777
|
+
# `"projects/my-project/sinks/my-sink"`
|
1738
1778
|
#
|
1739
1779
|
# @yield [response, operation] Access the result along with the RPC operation
|
1740
1780
|
# @yieldparam response [::Google::Protobuf::Empty]
|
@@ -1801,7 +1841,7 @@ module Google
|
|
1801
1841
|
end
|
1802
1842
|
|
1803
1843
|
##
|
1804
|
-
# Lists all the exclusions in a parent resource.
|
1844
|
+
# Lists all the exclusions on the _Default sink in a parent resource.
|
1805
1845
|
#
|
1806
1846
|
# @overload list_exclusions(request, options = nil)
|
1807
1847
|
# Pass arguments to `list_exclusions` via a request object, either of type
|
@@ -1907,7 +1947,7 @@ module Google
|
|
1907
1947
|
end
|
1908
1948
|
|
1909
1949
|
##
|
1910
|
-
# Gets the description of an exclusion.
|
1950
|
+
# Gets the description of an exclusion in the _Default sink.
|
1911
1951
|
#
|
1912
1952
|
# @overload get_exclusion(request, options = nil)
|
1913
1953
|
# Pass arguments to `get_exclusion` via a request object, either of type
|
@@ -1932,7 +1972,9 @@ module Google
|
|
1932
1972
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
1933
1973
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
|
1934
1974
|
#
|
1935
|
-
#
|
1975
|
+
# For example:
|
1976
|
+
#
|
1977
|
+
# `"projects/my-project/exclusions/my-exclusion"`
|
1936
1978
|
#
|
1937
1979
|
# @yield [response, operation] Access the result along with the RPC operation
|
1938
1980
|
# @yieldparam response [::Google::Cloud::Logging::V2::LogExclusion]
|
@@ -1999,9 +2041,9 @@ module Google
|
|
1999
2041
|
end
|
2000
2042
|
|
2001
2043
|
##
|
2002
|
-
# Creates a new exclusion in a specified parent
|
2003
|
-
# Only log entries belonging to that resource can be excluded.
|
2004
|
-
#
|
2044
|
+
# Creates a new exclusion in the _Default sink in a specified parent
|
2045
|
+
# resource. Only log entries belonging to that resource can be excluded. You
|
2046
|
+
# can have up to 10 exclusions in a resource.
|
2005
2047
|
#
|
2006
2048
|
# @overload create_exclusion(request, options = nil)
|
2007
2049
|
# Pass arguments to `create_exclusion` via a request object, either of type
|
@@ -2026,7 +2068,10 @@ module Google
|
|
2026
2068
|
# "billingAccounts/[BILLING_ACCOUNT_ID]"
|
2027
2069
|
# "folders/[FOLDER_ID]"
|
2028
2070
|
#
|
2029
|
-
#
|
2071
|
+
# For examples:
|
2072
|
+
#
|
2073
|
+
# `"projects/my-logging-project"`
|
2074
|
+
# `"organizations/123456789"`
|
2030
2075
|
# @param exclusion [::Google::Cloud::Logging::V2::LogExclusion, ::Hash]
|
2031
2076
|
# Required. The new exclusion, whose `name` parameter is an exclusion name
|
2032
2077
|
# that is not already used in the parent resource.
|
@@ -2096,7 +2141,8 @@ module Google
|
|
2096
2141
|
end
|
2097
2142
|
|
2098
2143
|
##
|
2099
|
-
# Changes one or more properties of an existing exclusion
|
2144
|
+
# Changes one or more properties of an existing exclusion in the _Default
|
2145
|
+
# sink.
|
2100
2146
|
#
|
2101
2147
|
# @overload update_exclusion(request, options = nil)
|
2102
2148
|
# Pass arguments to `update_exclusion` via a request object, either of type
|
@@ -2121,7 +2167,9 @@ module Google
|
|
2121
2167
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
2122
2168
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
|
2123
2169
|
#
|
2124
|
-
#
|
2170
|
+
# For example:
|
2171
|
+
#
|
2172
|
+
# `"projects/my-project/exclusions/my-exclusion"`
|
2125
2173
|
# @param exclusion [::Google::Cloud::Logging::V2::LogExclusion, ::Hash]
|
2126
2174
|
# Required. New values for the existing exclusion. Only the fields specified in
|
2127
2175
|
# `update_mask` are relevant.
|
@@ -2199,7 +2247,7 @@ module Google
|
|
2199
2247
|
end
|
2200
2248
|
|
2201
2249
|
##
|
2202
|
-
# Deletes an exclusion.
|
2250
|
+
# Deletes an exclusion in the _Default sink.
|
2203
2251
|
#
|
2204
2252
|
# @overload delete_exclusion(request, options = nil)
|
2205
2253
|
# Pass arguments to `delete_exclusion` via a request object, either of type
|
@@ -2224,7 +2272,9 @@ module Google
|
|
2224
2272
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
|
2225
2273
|
# "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
|
2226
2274
|
#
|
2227
|
-
#
|
2275
|
+
# For example:
|
2276
|
+
#
|
2277
|
+
# `"projects/my-project/exclusions/my-exclusion"`
|
2228
2278
|
#
|
2229
2279
|
# @yield [response, operation] Access the result along with the RPC operation
|
2230
2280
|
# @yieldparam response [::Google::Protobuf::Empty]
|
@@ -2291,13 +2341,14 @@ module Google
|
|
2291
2341
|
end
|
2292
2342
|
|
2293
2343
|
##
|
2294
|
-
# Gets the
|
2344
|
+
# Gets the Logging CMEK settings for the given resource.
|
2295
2345
|
#
|
2296
|
-
# Note: CMEK for the
|
2297
|
-
#
|
2298
|
-
# the
|
2346
|
+
# Note: CMEK for the Log Router can be configured for Google Cloud projects,
|
2347
|
+
# folders, organizations and billing accounts. Once configured for an
|
2348
|
+
# organization, it applies to all projects and folders in the Google Cloud
|
2349
|
+
# organization.
|
2299
2350
|
#
|
2300
|
-
# See [Enabling CMEK for
|
2351
|
+
# See [Enabling CMEK for Log
|
2301
2352
|
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
2302
2353
|
# for more information.
|
2303
2354
|
#
|
@@ -2324,11 +2375,14 @@ module Google
|
|
2324
2375
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
|
2325
2376
|
# "folders/[FOLDER_ID]/cmekSettings"
|
2326
2377
|
#
|
2327
|
-
#
|
2378
|
+
# For example:
|
2379
|
+
#
|
2380
|
+
# `"organizations/12345/cmekSettings"`
|
2328
2381
|
#
|
2329
|
-
# Note: CMEK for the
|
2330
|
-
#
|
2331
|
-
# the
|
2382
|
+
# Note: CMEK for the Log Router can be configured for Google Cloud projects,
|
2383
|
+
# folders, organizations and billing accounts. Once configured for an
|
2384
|
+
# organization, it applies to all projects and folders in the Google Cloud
|
2385
|
+
# organization.
|
2332
2386
|
#
|
2333
2387
|
# @yield [response, operation] Access the result along with the RPC operation
|
2334
2388
|
# @yieldparam response [::Google::Cloud::Logging::V2::CmekSettings]
|
@@ -2395,11 +2449,11 @@ module Google
|
|
2395
2449
|
end
|
2396
2450
|
|
2397
2451
|
##
|
2398
|
-
# Updates the
|
2452
|
+
# Updates the Log Router CMEK settings for the given resource.
|
2399
2453
|
#
|
2400
|
-
# Note: CMEK for the
|
2401
|
-
# organizations. Once configured, it applies to all projects and
|
2402
|
-
# the
|
2454
|
+
# Note: CMEK for the Log Router can currently only be configured for Google
|
2455
|
+
# Cloud organizations. Once configured, it applies to all projects and
|
2456
|
+
# folders in the Google Cloud organization.
|
2403
2457
|
#
|
2404
2458
|
# {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_cmek_settings UpdateCmekSettings}
|
2405
2459
|
# will fail if 1) `kms_key_name` is invalid, or 2) the associated service
|
@@ -2407,7 +2461,7 @@ module Google
|
|
2407
2461
|
# `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or
|
2408
2462
|
# 3) access to the key is disabled.
|
2409
2463
|
#
|
2410
|
-
# See [Enabling CMEK for
|
2464
|
+
# See [Enabling CMEK for Log
|
2411
2465
|
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
2412
2466
|
# for more information.
|
2413
2467
|
#
|
@@ -2434,15 +2488,17 @@ module Google
|
|
2434
2488
|
# "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
|
2435
2489
|
# "folders/[FOLDER_ID]/cmekSettings"
|
2436
2490
|
#
|
2437
|
-
#
|
2491
|
+
# For example:
|
2438
2492
|
#
|
2439
|
-
#
|
2440
|
-
#
|
2441
|
-
# the
|
2493
|
+
# `"organizations/12345/cmekSettings"`
|
2494
|
+
#
|
2495
|
+
# Note: CMEK for the Log Router can currently only be configured for Google
|
2496
|
+
# Cloud organizations. Once configured, it applies to all projects and
|
2497
|
+
# folders in the Google Cloud organization.
|
2442
2498
|
# @param cmek_settings [::Google::Cloud::Logging::V2::CmekSettings, ::Hash]
|
2443
2499
|
# Required. The CMEK settings to update.
|
2444
2500
|
#
|
2445
|
-
# See [Enabling CMEK for
|
2501
|
+
# See [Enabling CMEK for Log
|
2446
2502
|
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
2447
2503
|
# for more information.
|
2448
2504
|
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
@@ -2452,7 +2508,7 @@ module Google
|
|
2452
2508
|
#
|
2453
2509
|
# See {::Google::Protobuf::FieldMask FieldMask} for more information.
|
2454
2510
|
#
|
2455
|
-
#
|
2511
|
+
# For example: `"updateMask=kmsKeyName"`
|
2456
2512
|
#
|
2457
2513
|
# @yield [response, operation] Access the result along with the RPC operation
|
2458
2514
|
# @yieldparam response [::Google::Cloud::Logging::V2::CmekSettings]
|
@@ -2518,6 +2574,332 @@ module Google
|
|
2518
2574
|
raise ::Google::Cloud::Error.from_error(e)
|
2519
2575
|
end
|
2520
2576
|
|
2577
|
+
##
|
2578
|
+
# Gets the Log Router settings for the given resource.
|
2579
|
+
#
|
2580
|
+
# Note: Settings for the Log Router can be get for Google Cloud projects,
|
2581
|
+
# folders, organizations and billing accounts. Currently it can only be
|
2582
|
+
# configured for organizations. Once configured for an organization, it
|
2583
|
+
# applies to all projects and folders in the Google Cloud organization.
|
2584
|
+
#
|
2585
|
+
# See [Enabling CMEK for Log
|
2586
|
+
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
2587
|
+
# for more information.
|
2588
|
+
#
|
2589
|
+
# @overload get_settings(request, options = nil)
|
2590
|
+
# Pass arguments to `get_settings` via a request object, either of type
|
2591
|
+
# {::Google::Cloud::Logging::V2::GetSettingsRequest} or an equivalent Hash.
|
2592
|
+
#
|
2593
|
+
# @param request [::Google::Cloud::Logging::V2::GetSettingsRequest, ::Hash]
|
2594
|
+
# A request object representing the call parameters. Required. To specify no
|
2595
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
2596
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
2597
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
2598
|
+
#
|
2599
|
+
# @overload get_settings(name: nil)
|
2600
|
+
# Pass arguments to `get_settings` via keyword arguments. Note that at
|
2601
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
2602
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
2603
|
+
#
|
2604
|
+
# @param name [::String]
|
2605
|
+
# Required. The resource for which to retrieve settings.
|
2606
|
+
#
|
2607
|
+
# "projects/[PROJECT_ID]/settings"
|
2608
|
+
# "organizations/[ORGANIZATION_ID]/settings"
|
2609
|
+
# "billingAccounts/[BILLING_ACCOUNT_ID]/settings"
|
2610
|
+
# "folders/[FOLDER_ID]/settings"
|
2611
|
+
#
|
2612
|
+
# For example:
|
2613
|
+
#
|
2614
|
+
# `"organizations/12345/settings"`
|
2615
|
+
#
|
2616
|
+
# Note: Settings for the Log Router can be get for Google Cloud projects,
|
2617
|
+
# folders, organizations and billing accounts. Currently it can only be
|
2618
|
+
# configured for organizations. Once configured for an organization, it
|
2619
|
+
# applies to all projects and folders in the Google Cloud organization.
|
2620
|
+
#
|
2621
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
2622
|
+
# @yieldparam response [::Google::Cloud::Logging::V2::Settings]
|
2623
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
2624
|
+
#
|
2625
|
+
# @return [::Google::Cloud::Logging::V2::Settings]
|
2626
|
+
#
|
2627
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
2628
|
+
#
|
2629
|
+
# @example Basic example
|
2630
|
+
# require "google/cloud/logging/v2"
|
2631
|
+
#
|
2632
|
+
# # Create a client object. The client can be reused for multiple calls.
|
2633
|
+
# client = Google::Cloud::Logging::V2::ConfigService::Client.new
|
2634
|
+
#
|
2635
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
2636
|
+
# request = Google::Cloud::Logging::V2::GetSettingsRequest.new
|
2637
|
+
#
|
2638
|
+
# # Call the get_settings method.
|
2639
|
+
# result = client.get_settings request
|
2640
|
+
#
|
2641
|
+
# # The returned object is of type Google::Cloud::Logging::V2::Settings.
|
2642
|
+
# p result
|
2643
|
+
#
|
2644
|
+
def get_settings request, options = nil
|
2645
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
2646
|
+
|
2647
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::GetSettingsRequest
|
2648
|
+
|
2649
|
+
# Converts hash and nil to an options object
|
2650
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
2651
|
+
|
2652
|
+
# Customize the options with defaults
|
2653
|
+
metadata = @config.rpcs.get_settings.metadata.to_h
|
2654
|
+
|
2655
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
2656
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
2657
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
2658
|
+
gapic_version: ::Google::Cloud::Logging::V2::VERSION
|
2659
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
2660
|
+
|
2661
|
+
header_params = {}
|
2662
|
+
if request.name
|
2663
|
+
header_params["name"] = request.name
|
2664
|
+
end
|
2665
|
+
|
2666
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
2667
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
2668
|
+
|
2669
|
+
options.apply_defaults timeout: @config.rpcs.get_settings.timeout,
|
2670
|
+
metadata: metadata,
|
2671
|
+
retry_policy: @config.rpcs.get_settings.retry_policy
|
2672
|
+
|
2673
|
+
options.apply_defaults timeout: @config.timeout,
|
2674
|
+
metadata: @config.metadata,
|
2675
|
+
retry_policy: @config.retry_policy
|
2676
|
+
|
2677
|
+
@config_service_stub.call_rpc :get_settings, request, options: options do |response, operation|
|
2678
|
+
yield response, operation if block_given?
|
2679
|
+
return response
|
2680
|
+
end
|
2681
|
+
rescue ::GRPC::BadStatus => e
|
2682
|
+
raise ::Google::Cloud::Error.from_error(e)
|
2683
|
+
end
|
2684
|
+
|
2685
|
+
##
|
2686
|
+
# Updates the Log Router settings for the given resource.
|
2687
|
+
#
|
2688
|
+
# Note: Settings for the Log Router can currently only be configured for
|
2689
|
+
# Google Cloud organizations. Once configured, it applies to all projects and
|
2690
|
+
# folders in the Google Cloud organization.
|
2691
|
+
#
|
2692
|
+
# {::Google::Cloud::Logging::V2::ConfigServiceV2::Client#update_settings UpdateSettings}
|
2693
|
+
# will fail if 1) `kms_key_name` is invalid, or 2) the associated service
|
2694
|
+
# account does not have the required
|
2695
|
+
# `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or
|
2696
|
+
# 3) access to the key is disabled. 4) `location_id` is not supported by
|
2697
|
+
# Logging. 5) `location_id` violate OrgPolicy.
|
2698
|
+
#
|
2699
|
+
# See [Enabling CMEK for Log
|
2700
|
+
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
2701
|
+
# for more information.
|
2702
|
+
#
|
2703
|
+
# @overload update_settings(request, options = nil)
|
2704
|
+
# Pass arguments to `update_settings` via a request object, either of type
|
2705
|
+
# {::Google::Cloud::Logging::V2::UpdateSettingsRequest} or an equivalent Hash.
|
2706
|
+
#
|
2707
|
+
# @param request [::Google::Cloud::Logging::V2::UpdateSettingsRequest, ::Hash]
|
2708
|
+
# A request object representing the call parameters. Required. To specify no
|
2709
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
2710
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
2711
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
2712
|
+
#
|
2713
|
+
# @overload update_settings(name: nil, settings: nil, update_mask: nil)
|
2714
|
+
# Pass arguments to `update_settings` via keyword arguments. Note that at
|
2715
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
2716
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
2717
|
+
#
|
2718
|
+
# @param name [::String]
|
2719
|
+
# Required. The resource name for the settings to update.
|
2720
|
+
#
|
2721
|
+
# "organizations/[ORGANIZATION_ID]/settings"
|
2722
|
+
#
|
2723
|
+
# For example:
|
2724
|
+
#
|
2725
|
+
# `"organizations/12345/settings"`
|
2726
|
+
#
|
2727
|
+
# Note: Settings for the Log Router can currently only be configured for
|
2728
|
+
# Google Cloud organizations. Once configured, it applies to all projects and
|
2729
|
+
# folders in the Google Cloud organization.
|
2730
|
+
# @param settings [::Google::Cloud::Logging::V2::Settings, ::Hash]
|
2731
|
+
# Required. The settings to update.
|
2732
|
+
#
|
2733
|
+
# See [Enabling CMEK for Log
|
2734
|
+
# Router](https://cloud.google.com/logging/docs/routing/managed-encryption)
|
2735
|
+
# for more information.
|
2736
|
+
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
2737
|
+
# Optional. Field mask identifying which fields from `settings` should
|
2738
|
+
# be updated. A field will be overwritten if and only if it is in the update
|
2739
|
+
# mask. Output only fields cannot be updated.
|
2740
|
+
#
|
2741
|
+
# See {::Google::Protobuf::FieldMask FieldMask} for more information.
|
2742
|
+
#
|
2743
|
+
# For example: `"updateMask=kmsKeyName"`
|
2744
|
+
#
|
2745
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
2746
|
+
# @yieldparam response [::Google::Cloud::Logging::V2::Settings]
|
2747
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
2748
|
+
#
|
2749
|
+
# @return [::Google::Cloud::Logging::V2::Settings]
|
2750
|
+
#
|
2751
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
2752
|
+
#
|
2753
|
+
# @example Basic example
|
2754
|
+
# require "google/cloud/logging/v2"
|
2755
|
+
#
|
2756
|
+
# # Create a client object. The client can be reused for multiple calls.
|
2757
|
+
# client = Google::Cloud::Logging::V2::ConfigService::Client.new
|
2758
|
+
#
|
2759
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
2760
|
+
# request = Google::Cloud::Logging::V2::UpdateSettingsRequest.new
|
2761
|
+
#
|
2762
|
+
# # Call the update_settings method.
|
2763
|
+
# result = client.update_settings request
|
2764
|
+
#
|
2765
|
+
# # The returned object is of type Google::Cloud::Logging::V2::Settings.
|
2766
|
+
# p result
|
2767
|
+
#
|
2768
|
+
def update_settings request, options = nil
|
2769
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
2770
|
+
|
2771
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::UpdateSettingsRequest
|
2772
|
+
|
2773
|
+
# Converts hash and nil to an options object
|
2774
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
2775
|
+
|
2776
|
+
# Customize the options with defaults
|
2777
|
+
metadata = @config.rpcs.update_settings.metadata.to_h
|
2778
|
+
|
2779
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
2780
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
2781
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
2782
|
+
gapic_version: ::Google::Cloud::Logging::V2::VERSION
|
2783
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
2784
|
+
|
2785
|
+
header_params = {}
|
2786
|
+
if request.name
|
2787
|
+
header_params["name"] = request.name
|
2788
|
+
end
|
2789
|
+
|
2790
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
2791
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
2792
|
+
|
2793
|
+
options.apply_defaults timeout: @config.rpcs.update_settings.timeout,
|
2794
|
+
metadata: metadata,
|
2795
|
+
retry_policy: @config.rpcs.update_settings.retry_policy
|
2796
|
+
|
2797
|
+
options.apply_defaults timeout: @config.timeout,
|
2798
|
+
metadata: @config.metadata,
|
2799
|
+
retry_policy: @config.retry_policy
|
2800
|
+
|
2801
|
+
@config_service_stub.call_rpc :update_settings, request, options: options do |response, operation|
|
2802
|
+
yield response, operation if block_given?
|
2803
|
+
return response
|
2804
|
+
end
|
2805
|
+
rescue ::GRPC::BadStatus => e
|
2806
|
+
raise ::Google::Cloud::Error.from_error(e)
|
2807
|
+
end
|
2808
|
+
|
2809
|
+
##
|
2810
|
+
# Copies a set of log entries from a log bucket to a Cloud Storage bucket.
|
2811
|
+
#
|
2812
|
+
# @overload copy_log_entries(request, options = nil)
|
2813
|
+
# Pass arguments to `copy_log_entries` via a request object, either of type
|
2814
|
+
# {::Google::Cloud::Logging::V2::CopyLogEntriesRequest} or an equivalent Hash.
|
2815
|
+
#
|
2816
|
+
# @param request [::Google::Cloud::Logging::V2::CopyLogEntriesRequest, ::Hash]
|
2817
|
+
# A request object representing the call parameters. Required. To specify no
|
2818
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
2819
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
2820
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
2821
|
+
#
|
2822
|
+
# @overload copy_log_entries(name: nil, filter: nil, destination: nil)
|
2823
|
+
# Pass arguments to `copy_log_entries` via keyword arguments. Note that at
|
2824
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
2825
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
2826
|
+
#
|
2827
|
+
# @param name [::String]
|
2828
|
+
# Required. Log bucket from which to copy log entries.
|
2829
|
+
#
|
2830
|
+
# For example:
|
2831
|
+
#
|
2832
|
+
# `"projects/my-project/locations/global/buckets/my-source-bucket"`
|
2833
|
+
# @param filter [::String]
|
2834
|
+
# Optional. A filter specifying which log entries to copy. The filter must be no more
|
2835
|
+
# than 20k characters. An empty filter matches all log entries.
|
2836
|
+
# @param destination [::String]
|
2837
|
+
# Required. Destination to which to copy log entries.
|
2838
|
+
#
|
2839
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
2840
|
+
# @yieldparam response [::Gapic::Operation]
|
2841
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
2842
|
+
#
|
2843
|
+
# @return [::Gapic::Operation]
|
2844
|
+
#
|
2845
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
2846
|
+
#
|
2847
|
+
# @example Basic example
|
2848
|
+
# require "google/cloud/logging/v2"
|
2849
|
+
#
|
2850
|
+
# # Create a client object. The client can be reused for multiple calls.
|
2851
|
+
# client = Google::Cloud::Logging::V2::ConfigService::Client.new
|
2852
|
+
#
|
2853
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
2854
|
+
# request = Google::Cloud::Logging::V2::CopyLogEntriesRequest.new
|
2855
|
+
#
|
2856
|
+
# # Call the copy_log_entries method.
|
2857
|
+
# result = client.copy_log_entries request
|
2858
|
+
#
|
2859
|
+
# # The returned object is of type Gapic::Operation. You can use this
|
2860
|
+
# # object to check the status of an operation, cancel it, or wait
|
2861
|
+
# # for results. Here is how to block until completion:
|
2862
|
+
# result.wait_until_done! timeout: 60
|
2863
|
+
# if result.response?
|
2864
|
+
# p result.response
|
2865
|
+
# else
|
2866
|
+
# puts "Error!"
|
2867
|
+
# end
|
2868
|
+
#
|
2869
|
+
def copy_log_entries request, options = nil
|
2870
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
2871
|
+
|
2872
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::CopyLogEntriesRequest
|
2873
|
+
|
2874
|
+
# Converts hash and nil to an options object
|
2875
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
2876
|
+
|
2877
|
+
# Customize the options with defaults
|
2878
|
+
metadata = @config.rpcs.copy_log_entries.metadata.to_h
|
2879
|
+
|
2880
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
2881
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
2882
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
2883
|
+
gapic_version: ::Google::Cloud::Logging::V2::VERSION
|
2884
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
2885
|
+
|
2886
|
+
options.apply_defaults timeout: @config.rpcs.copy_log_entries.timeout,
|
2887
|
+
metadata: metadata,
|
2888
|
+
retry_policy: @config.rpcs.copy_log_entries.retry_policy
|
2889
|
+
|
2890
|
+
options.apply_defaults timeout: @config.timeout,
|
2891
|
+
metadata: @config.metadata,
|
2892
|
+
retry_policy: @config.retry_policy
|
2893
|
+
|
2894
|
+
@config_service_stub.call_rpc :copy_log_entries, request, options: options do |response, operation|
|
2895
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
2896
|
+
yield response, operation if block_given?
|
2897
|
+
return response
|
2898
|
+
end
|
2899
|
+
rescue ::GRPC::BadStatus => e
|
2900
|
+
raise ::Google::Cloud::Error.from_error(e)
|
2901
|
+
end
|
2902
|
+
|
2521
2903
|
##
|
2522
2904
|
# Configuration class for the ConfigService API.
|
2523
2905
|
#
|
@@ -2768,6 +3150,21 @@ module Google
|
|
2768
3150
|
# @return [::Gapic::Config::Method]
|
2769
3151
|
#
|
2770
3152
|
attr_reader :update_cmek_settings
|
3153
|
+
##
|
3154
|
+
# RPC-specific configuration for `get_settings`
|
3155
|
+
# @return [::Gapic::Config::Method]
|
3156
|
+
#
|
3157
|
+
attr_reader :get_settings
|
3158
|
+
##
|
3159
|
+
# RPC-specific configuration for `update_settings`
|
3160
|
+
# @return [::Gapic::Config::Method]
|
3161
|
+
#
|
3162
|
+
attr_reader :update_settings
|
3163
|
+
##
|
3164
|
+
# RPC-specific configuration for `copy_log_entries`
|
3165
|
+
# @return [::Gapic::Config::Method]
|
3166
|
+
#
|
3167
|
+
attr_reader :copy_log_entries
|
2771
3168
|
|
2772
3169
|
# @private
|
2773
3170
|
def initialize parent_rpcs = nil
|
@@ -2817,6 +3214,12 @@ module Google
|
|
2817
3214
|
@get_cmek_settings = ::Gapic::Config::Method.new get_cmek_settings_config
|
2818
3215
|
update_cmek_settings_config = parent_rpcs.update_cmek_settings if parent_rpcs.respond_to? :update_cmek_settings
|
2819
3216
|
@update_cmek_settings = ::Gapic::Config::Method.new update_cmek_settings_config
|
3217
|
+
get_settings_config = parent_rpcs.get_settings if parent_rpcs.respond_to? :get_settings
|
3218
|
+
@get_settings = ::Gapic::Config::Method.new get_settings_config
|
3219
|
+
update_settings_config = parent_rpcs.update_settings if parent_rpcs.respond_to? :update_settings
|
3220
|
+
@update_settings = ::Gapic::Config::Method.new update_settings_config
|
3221
|
+
copy_log_entries_config = parent_rpcs.copy_log_entries if parent_rpcs.respond_to? :copy_log_entries
|
3222
|
+
@copy_log_entries = ::Gapic::Config::Method.new copy_log_entries_config
|
2820
3223
|
|
2821
3224
|
yield self if block_given?
|
2822
3225
|
end
|