google-cloud-logging-v2 0.1.1 → 0.3.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 498f09fb4cd2d54347941d5fde690bf578ca2c036b921373defa6acacdb9608b
4
- data.tar.gz: 57e5714fbd2b621afac3b527ec9d3180c52f611aae6b60fcac38851b2268a4d0
3
+ metadata.gz: cec696718da2e399c1d53d2b1da764dda4d759ca703f5e5a6177c46604fa7a0f
4
+ data.tar.gz: '05794f4fb216825976bf7882b0d6477263e4beb85db015799adeb560fd417805'
5
5
  SHA512:
6
- metadata.gz: abb75172cddca98f90398141ce7e82e94afdca3577bdc98c92d4374cc811226ea9a2bfc8422ce21aaa8254c2768dad32f092b885958c7f0754eceb32683f0213
7
- data.tar.gz: 8442e3081fa1bf2577b069789c88f2458f0463b080e4b240753d81f1c3c0e28f7d349316bb5691b8fd162b0b7f1fc5916f8d27a4892dba3f0f269774de303804
6
+ metadata.gz: f7d3861b2ca7929559980e0c4a2d8dee846b23cccd1671ef1a57baf9404507e5cee4a01f524949fa68039d638b84f77b7bec242366af1b139881f395a4799156
7
+ data.tar.gz: a6e5fcafcfd5376a91f4ea83db9c4149b290f28028f7386618315528ecdaef8e7c3c4bf4d959b968f5d72d846191f86c3b97937033c140c7dfa5e311db03d55f
@@ -35,3 +35,6 @@ module Google
35
35
  end
36
36
  end
37
37
  end
38
+
39
+ helper_path = ::File.join __dir__, "v2", "_helpers.rb"
40
+ require "google/cloud/logging/v2/_helpers" if ::File.file? helper_path
@@ -70,7 +70,7 @@ module Google
70
70
  initial_delay: 0.1,
71
71
  max_delay: 60.0,
72
72
  multiplier: 1.3,
73
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
73
+ retry_codes: [4, 13, 14]
74
74
  }
75
75
 
76
76
  default_config.rpcs.get_sink.timeout = 60.0
@@ -78,7 +78,7 @@ module Google
78
78
  initial_delay: 0.1,
79
79
  max_delay: 60.0,
80
80
  multiplier: 1.3,
81
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
81
+ retry_codes: [4, 13, 14]
82
82
  }
83
83
 
84
84
  default_config.rpcs.create_sink.timeout = 120.0
@@ -88,7 +88,7 @@ module Google
88
88
  initial_delay: 0.1,
89
89
  max_delay: 60.0,
90
90
  multiplier: 1.3,
91
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
91
+ retry_codes: [4, 13, 14]
92
92
  }
93
93
 
94
94
  default_config.rpcs.delete_sink.timeout = 60.0
@@ -96,7 +96,7 @@ module Google
96
96
  initial_delay: 0.1,
97
97
  max_delay: 60.0,
98
98
  multiplier: 1.3,
99
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
99
+ retry_codes: [4, 13, 14]
100
100
  }
101
101
 
102
102
  default_config.rpcs.list_exclusions.timeout = 60.0
@@ -104,7 +104,7 @@ module Google
104
104
  initial_delay: 0.1,
105
105
  max_delay: 60.0,
106
106
  multiplier: 1.3,
107
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
107
+ retry_codes: [4, 13, 14]
108
108
  }
109
109
 
110
110
  default_config.rpcs.get_exclusion.timeout = 60.0
@@ -112,7 +112,7 @@ module Google
112
112
  initial_delay: 0.1,
113
113
  max_delay: 60.0,
114
114
  multiplier: 1.3,
115
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
115
+ retry_codes: [4, 13, 14]
116
116
  }
117
117
 
118
118
  default_config.rpcs.create_exclusion.timeout = 120.0
@@ -124,7 +124,7 @@ module Google
124
124
  initial_delay: 0.1,
125
125
  max_delay: 60.0,
126
126
  multiplier: 1.3,
127
- retry_codes: ["DEADLINE_EXCEEDED", "INTERNAL", "UNAVAILABLE"]
127
+ retry_codes: [4, 13, 14]
128
128
  }
129
129
 
130
130
  default_config
@@ -207,7 +207,7 @@ module Google
207
207
  # Service calls
208
208
 
209
209
  ##
210
- # Lists buckets (Beta).
210
+ # Lists buckets.
211
211
  #
212
212
  # @overload list_buckets(request, options = nil)
213
213
  # Pass arguments to `list_buckets` via a request object, either of type
@@ -292,7 +292,7 @@ module Google
292
292
  end
293
293
 
294
294
  ##
295
- # Gets a bucket (Beta).
295
+ # Gets a bucket.
296
296
  #
297
297
  # @overload get_bucket(request, options = nil)
298
298
  # Pass arguments to `get_bucket` via a request object, either of type
@@ -365,6 +365,85 @@ module Google
365
365
  raise ::Google::Cloud::Error.from_error(e)
366
366
  end
367
367
 
368
+ ##
369
+ # Creates a bucket that can be used to store log entries. Once a bucket has
370
+ # been created, the region cannot be changed.
371
+ #
372
+ # @overload create_bucket(request, options = nil)
373
+ # Pass arguments to `create_bucket` via a request object, either of type
374
+ # {::Google::Cloud::Logging::V2::CreateBucketRequest} or an equivalent Hash.
375
+ #
376
+ # @param request [::Google::Cloud::Logging::V2::CreateBucketRequest, ::Hash]
377
+ # A request object representing the call parameters. Required. To specify no
378
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
379
+ # @param options [::Gapic::CallOptions, ::Hash]
380
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
381
+ #
382
+ # @overload create_bucket(parent: nil, bucket_id: nil, bucket: nil)
383
+ # Pass arguments to `create_bucket` via keyword arguments. Note that at
384
+ # least one keyword argument is required. To specify no parameters, or to keep all
385
+ # the default parameter values, pass an empty Hash as a request object (see above).
386
+ #
387
+ # @param parent [::String]
388
+ # Required. The resource in which to create the bucket:
389
+ #
390
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
391
+ #
392
+ # Example: `"projects/my-logging-project/locations/global"`
393
+ # @param bucket_id [::String]
394
+ # Required. A client-assigned identifier such as `"my-bucket"`. Identifiers are
395
+ # limited to 100 characters and can include only letters, digits,
396
+ # underscores, hyphens, and periods.
397
+ # @param bucket [::Google::Cloud::Logging::V2::LogBucket, ::Hash]
398
+ # Required. The new bucket. The region specified in the new bucket must be compliant
399
+ # with any Location Restriction Org Policy. The name field in the bucket is
400
+ # ignored.
401
+ #
402
+ # @yield [response, operation] Access the result along with the RPC operation
403
+ # @yieldparam response [::Google::Cloud::Logging::V2::LogBucket]
404
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
405
+ #
406
+ # @return [::Google::Cloud::Logging::V2::LogBucket]
407
+ #
408
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
409
+ #
410
+ def create_bucket request, options = nil
411
+ raise ::ArgumentError, "request must be provided" if request.nil?
412
+
413
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::CreateBucketRequest
414
+
415
+ # Converts hash and nil to an options object
416
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
417
+
418
+ # Customize the options with defaults
419
+ metadata = @config.rpcs.create_bucket.metadata.to_h
420
+
421
+ # Set x-goog-api-client and x-goog-user-project headers
422
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
423
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
424
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
425
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
426
+
427
+ header_params = {
428
+ "parent" => request.parent
429
+ }
430
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
431
+ metadata[:"x-goog-request-params"] ||= request_params_header
432
+
433
+ options.apply_defaults timeout: @config.rpcs.create_bucket.timeout,
434
+ metadata: metadata,
435
+ retry_policy: @config.rpcs.create_bucket.retry_policy
436
+ options.apply_defaults metadata: @config.metadata,
437
+ retry_policy: @config.retry_policy
438
+
439
+ @config_service_stub.call_rpc :create_bucket, request, options: options do |response, operation|
440
+ yield response, operation if block_given?
441
+ return response
442
+ end
443
+ rescue ::GRPC::BadStatus => e
444
+ raise ::Google::Cloud::Error.from_error(e)
445
+ end
446
+
368
447
  ##
369
448
  # Updates a bucket. This method replaces the following fields in the
370
449
  # existing bucket with values from the new bucket: `retention_period`
@@ -376,7 +455,6 @@ module Google
376
455
  # will be returned.
377
456
  #
378
457
  # A buckets region may not be modified after it is created.
379
- # This method is in Beta.
380
458
  #
381
459
  # @overload update_bucket(request, options = nil)
382
460
  # Pass arguments to `update_bucket` via a request object, either of type
@@ -462,6 +540,537 @@ module Google
462
540
  raise ::Google::Cloud::Error.from_error(e)
463
541
  end
464
542
 
543
+ ##
544
+ # Deletes a bucket.
545
+ # Moves the bucket to the DELETE_REQUESTED state. After 7 days, the
546
+ # bucket will be purged and all logs in the bucket will be permanently
547
+ # deleted.
548
+ #
549
+ # @overload delete_bucket(request, options = nil)
550
+ # Pass arguments to `delete_bucket` via a request object, either of type
551
+ # {::Google::Cloud::Logging::V2::DeleteBucketRequest} or an equivalent Hash.
552
+ #
553
+ # @param request [::Google::Cloud::Logging::V2::DeleteBucketRequest, ::Hash]
554
+ # A request object representing the call parameters. Required. To specify no
555
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
556
+ # @param options [::Gapic::CallOptions, ::Hash]
557
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
558
+ #
559
+ # @overload delete_bucket(name: nil)
560
+ # Pass arguments to `delete_bucket` via keyword arguments. Note that at
561
+ # least one keyword argument is required. To specify no parameters, or to keep all
562
+ # the default parameter values, pass an empty Hash as a request object (see above).
563
+ #
564
+ # @param name [::String]
565
+ # Required. The full resource name of the bucket to delete.
566
+ #
567
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
568
+ # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
569
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
570
+ # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
571
+ #
572
+ # Example:
573
+ # `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
574
+ #
575
+ # @yield [response, operation] Access the result along with the RPC operation
576
+ # @yieldparam response [::Google::Protobuf::Empty]
577
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
578
+ #
579
+ # @return [::Google::Protobuf::Empty]
580
+ #
581
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
582
+ #
583
+ def delete_bucket request, options = nil
584
+ raise ::ArgumentError, "request must be provided" if request.nil?
585
+
586
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::DeleteBucketRequest
587
+
588
+ # Converts hash and nil to an options object
589
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
590
+
591
+ # Customize the options with defaults
592
+ metadata = @config.rpcs.delete_bucket.metadata.to_h
593
+
594
+ # Set x-goog-api-client and x-goog-user-project headers
595
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
596
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
597
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
598
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
599
+
600
+ header_params = {
601
+ "name" => request.name
602
+ }
603
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
604
+ metadata[:"x-goog-request-params"] ||= request_params_header
605
+
606
+ options.apply_defaults timeout: @config.rpcs.delete_bucket.timeout,
607
+ metadata: metadata,
608
+ retry_policy: @config.rpcs.delete_bucket.retry_policy
609
+ options.apply_defaults metadata: @config.metadata,
610
+ retry_policy: @config.retry_policy
611
+
612
+ @config_service_stub.call_rpc :delete_bucket, request, options: options do |response, operation|
613
+ yield response, operation if block_given?
614
+ return response
615
+ end
616
+ rescue ::GRPC::BadStatus => e
617
+ raise ::Google::Cloud::Error.from_error(e)
618
+ end
619
+
620
+ ##
621
+ # Undeletes a bucket. A bucket that has been deleted may be undeleted within
622
+ # the grace period of 7 days.
623
+ #
624
+ # @overload undelete_bucket(request, options = nil)
625
+ # Pass arguments to `undelete_bucket` via a request object, either of type
626
+ # {::Google::Cloud::Logging::V2::UndeleteBucketRequest} or an equivalent Hash.
627
+ #
628
+ # @param request [::Google::Cloud::Logging::V2::UndeleteBucketRequest, ::Hash]
629
+ # A request object representing the call parameters. Required. To specify no
630
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
631
+ # @param options [::Gapic::CallOptions, ::Hash]
632
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
633
+ #
634
+ # @overload undelete_bucket(name: nil)
635
+ # Pass arguments to `undelete_bucket` via keyword arguments. Note that at
636
+ # least one keyword argument is required. To specify no parameters, or to keep all
637
+ # the default parameter values, pass an empty Hash as a request object (see above).
638
+ #
639
+ # @param name [::String]
640
+ # Required. The full resource name of the bucket to undelete.
641
+ #
642
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
643
+ # "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
644
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
645
+ # "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
646
+ #
647
+ # Example:
648
+ # `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
649
+ #
650
+ # @yield [response, operation] Access the result along with the RPC operation
651
+ # @yieldparam response [::Google::Protobuf::Empty]
652
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
653
+ #
654
+ # @return [::Google::Protobuf::Empty]
655
+ #
656
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
657
+ #
658
+ def undelete_bucket request, options = nil
659
+ raise ::ArgumentError, "request must be provided" if request.nil?
660
+
661
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::UndeleteBucketRequest
662
+
663
+ # Converts hash and nil to an options object
664
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
665
+
666
+ # Customize the options with defaults
667
+ metadata = @config.rpcs.undelete_bucket.metadata.to_h
668
+
669
+ # Set x-goog-api-client and x-goog-user-project headers
670
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
671
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
672
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
673
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
674
+
675
+ header_params = {
676
+ "name" => request.name
677
+ }
678
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
679
+ metadata[:"x-goog-request-params"] ||= request_params_header
680
+
681
+ options.apply_defaults timeout: @config.rpcs.undelete_bucket.timeout,
682
+ metadata: metadata,
683
+ retry_policy: @config.rpcs.undelete_bucket.retry_policy
684
+ options.apply_defaults metadata: @config.metadata,
685
+ retry_policy: @config.retry_policy
686
+
687
+ @config_service_stub.call_rpc :undelete_bucket, request, options: options do |response, operation|
688
+ yield response, operation if block_given?
689
+ return response
690
+ end
691
+ rescue ::GRPC::BadStatus => e
692
+ raise ::Google::Cloud::Error.from_error(e)
693
+ end
694
+
695
+ ##
696
+ # Lists views on a bucket.
697
+ #
698
+ # @overload list_views(request, options = nil)
699
+ # Pass arguments to `list_views` via a request object, either of type
700
+ # {::Google::Cloud::Logging::V2::ListViewsRequest} or an equivalent Hash.
701
+ #
702
+ # @param request [::Google::Cloud::Logging::V2::ListViewsRequest, ::Hash]
703
+ # A request object representing the call parameters. Required. To specify no
704
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
705
+ # @param options [::Gapic::CallOptions, ::Hash]
706
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
707
+ #
708
+ # @overload list_views(parent: nil, page_token: nil, page_size: nil)
709
+ # Pass arguments to `list_views` via keyword arguments. Note that at
710
+ # least one keyword argument is required. To specify no parameters, or to keep all
711
+ # the default parameter values, pass an empty Hash as a request object (see above).
712
+ #
713
+ # @param parent [::String]
714
+ # Required. The bucket whose views are to be listed:
715
+ #
716
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
717
+ # @param page_token [::String]
718
+ # Optional. If present, then retrieve the next batch of results from the
719
+ # preceding call to this method. `pageToken` must be the value of
720
+ # `nextPageToken` from the previous response. The values of other method
721
+ # parameters should be identical to those in the previous call.
722
+ # @param page_size [::Integer]
723
+ # Optional. The maximum number of results to return from this request.
724
+ # Non-positive values are ignored. The presence of `nextPageToken` in the
725
+ # response indicates that more results might be available.
726
+ #
727
+ # @yield [response, operation] Access the result along with the RPC operation
728
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Logging::V2::LogView>]
729
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
730
+ #
731
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Logging::V2::LogView>]
732
+ #
733
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
734
+ #
735
+ def list_views request, options = nil
736
+ raise ::ArgumentError, "request must be provided" if request.nil?
737
+
738
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::ListViewsRequest
739
+
740
+ # Converts hash and nil to an options object
741
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
742
+
743
+ # Customize the options with defaults
744
+ metadata = @config.rpcs.list_views.metadata.to_h
745
+
746
+ # Set x-goog-api-client and x-goog-user-project headers
747
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
748
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
749
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
750
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
751
+
752
+ header_params = {
753
+ "parent" => request.parent
754
+ }
755
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
756
+ metadata[:"x-goog-request-params"] ||= request_params_header
757
+
758
+ options.apply_defaults timeout: @config.rpcs.list_views.timeout,
759
+ metadata: metadata,
760
+ retry_policy: @config.rpcs.list_views.retry_policy
761
+ options.apply_defaults metadata: @config.metadata,
762
+ retry_policy: @config.retry_policy
763
+
764
+ @config_service_stub.call_rpc :list_views, request, options: options do |response, operation|
765
+ response = ::Gapic::PagedEnumerable.new @config_service_stub, :list_views, request, response, operation, options
766
+ yield response, operation if block_given?
767
+ return response
768
+ end
769
+ rescue ::GRPC::BadStatus => e
770
+ raise ::Google::Cloud::Error.from_error(e)
771
+ end
772
+
773
+ ##
774
+ # Gets a view.
775
+ #
776
+ # @overload get_view(request, options = nil)
777
+ # Pass arguments to `get_view` via a request object, either of type
778
+ # {::Google::Cloud::Logging::V2::GetViewRequest} or an equivalent Hash.
779
+ #
780
+ # @param request [::Google::Cloud::Logging::V2::GetViewRequest, ::Hash]
781
+ # A request object representing the call parameters. Required. To specify no
782
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
783
+ # @param options [::Gapic::CallOptions, ::Hash]
784
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
785
+ #
786
+ # @overload get_view(name: nil)
787
+ # Pass arguments to `get_view` via keyword arguments. Note that at
788
+ # least one keyword argument is required. To specify no parameters, or to keep all
789
+ # the default parameter values, pass an empty Hash as a request object (see above).
790
+ #
791
+ # @param name [::String]
792
+ # Required. The resource name of the policy:
793
+ #
794
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
795
+ #
796
+ # Example:
797
+ # `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
798
+ #
799
+ # @yield [response, operation] Access the result along with the RPC operation
800
+ # @yieldparam response [::Google::Cloud::Logging::V2::LogView]
801
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
802
+ #
803
+ # @return [::Google::Cloud::Logging::V2::LogView]
804
+ #
805
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
806
+ #
807
+ def get_view request, options = nil
808
+ raise ::ArgumentError, "request must be provided" if request.nil?
809
+
810
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::GetViewRequest
811
+
812
+ # Converts hash and nil to an options object
813
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
814
+
815
+ # Customize the options with defaults
816
+ metadata = @config.rpcs.get_view.metadata.to_h
817
+
818
+ # Set x-goog-api-client and x-goog-user-project headers
819
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
820
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
821
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
822
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
823
+
824
+ header_params = {
825
+ "name" => request.name
826
+ }
827
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
828
+ metadata[:"x-goog-request-params"] ||= request_params_header
829
+
830
+ options.apply_defaults timeout: @config.rpcs.get_view.timeout,
831
+ metadata: metadata,
832
+ retry_policy: @config.rpcs.get_view.retry_policy
833
+ options.apply_defaults metadata: @config.metadata,
834
+ retry_policy: @config.retry_policy
835
+
836
+ @config_service_stub.call_rpc :get_view, request, options: options do |response, operation|
837
+ yield response, operation if block_given?
838
+ return response
839
+ end
840
+ rescue ::GRPC::BadStatus => e
841
+ raise ::Google::Cloud::Error.from_error(e)
842
+ end
843
+
844
+ ##
845
+ # Creates a view over logs in a bucket. A bucket may contain a maximum of
846
+ # 50 views.
847
+ #
848
+ # @overload create_view(request, options = nil)
849
+ # Pass arguments to `create_view` via a request object, either of type
850
+ # {::Google::Cloud::Logging::V2::CreateViewRequest} or an equivalent Hash.
851
+ #
852
+ # @param request [::Google::Cloud::Logging::V2::CreateViewRequest, ::Hash]
853
+ # A request object representing the call parameters. Required. To specify no
854
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
855
+ # @param options [::Gapic::CallOptions, ::Hash]
856
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
857
+ #
858
+ # @overload create_view(parent: nil, view_id: nil, view: nil)
859
+ # Pass arguments to `create_view` via keyword arguments. Note that at
860
+ # least one keyword argument is required. To specify no parameters, or to keep all
861
+ # the default parameter values, pass an empty Hash as a request object (see above).
862
+ #
863
+ # @param parent [::String]
864
+ # Required. The bucket in which to create the view
865
+ #
866
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
867
+ #
868
+ # Example:
869
+ # `"projects/my-logging-project/locations/my-location/buckets/my-bucket"`
870
+ # @param view_id [::String]
871
+ # Required. The id to use for this view.
872
+ # @param view [::Google::Cloud::Logging::V2::LogView, ::Hash]
873
+ # Required. The new view.
874
+ #
875
+ # @yield [response, operation] Access the result along with the RPC operation
876
+ # @yieldparam response [::Google::Cloud::Logging::V2::LogView]
877
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
878
+ #
879
+ # @return [::Google::Cloud::Logging::V2::LogView]
880
+ #
881
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
882
+ #
883
+ def create_view request, options = nil
884
+ raise ::ArgumentError, "request must be provided" if request.nil?
885
+
886
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::CreateViewRequest
887
+
888
+ # Converts hash and nil to an options object
889
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
890
+
891
+ # Customize the options with defaults
892
+ metadata = @config.rpcs.create_view.metadata.to_h
893
+
894
+ # Set x-goog-api-client and x-goog-user-project headers
895
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
896
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
897
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
898
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
899
+
900
+ header_params = {
901
+ "parent" => request.parent
902
+ }
903
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
904
+ metadata[:"x-goog-request-params"] ||= request_params_header
905
+
906
+ options.apply_defaults timeout: @config.rpcs.create_view.timeout,
907
+ metadata: metadata,
908
+ retry_policy: @config.rpcs.create_view.retry_policy
909
+ options.apply_defaults metadata: @config.metadata,
910
+ retry_policy: @config.retry_policy
911
+
912
+ @config_service_stub.call_rpc :create_view, request, options: options do |response, operation|
913
+ yield response, operation if block_given?
914
+ return response
915
+ end
916
+ rescue ::GRPC::BadStatus => e
917
+ raise ::Google::Cloud::Error.from_error(e)
918
+ end
919
+
920
+ ##
921
+ # Updates a view. This method replaces the following fields in the existing
922
+ # view with values from the new view: `filter`.
923
+ #
924
+ # @overload update_view(request, options = nil)
925
+ # Pass arguments to `update_view` via a request object, either of type
926
+ # {::Google::Cloud::Logging::V2::UpdateViewRequest} or an equivalent Hash.
927
+ #
928
+ # @param request [::Google::Cloud::Logging::V2::UpdateViewRequest, ::Hash]
929
+ # A request object representing the call parameters. Required. To specify no
930
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
931
+ # @param options [::Gapic::CallOptions, ::Hash]
932
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
933
+ #
934
+ # @overload update_view(name: nil, view: nil, update_mask: nil)
935
+ # Pass arguments to `update_view` via keyword arguments. Note that at
936
+ # least one keyword argument is required. To specify no parameters, or to keep all
937
+ # the default parameter values, pass an empty Hash as a request object (see above).
938
+ #
939
+ # @param name [::String]
940
+ # Required. The full resource name of the view to update
941
+ #
942
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
943
+ #
944
+ # Example:
945
+ # `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
946
+ # @param view [::Google::Cloud::Logging::V2::LogView, ::Hash]
947
+ # Required. The updated view.
948
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
949
+ # Optional. Field mask that specifies the fields in `view` that need
950
+ # an update. A field will be overwritten if, and only if, it is
951
+ # in the update mask. `name` and output only fields cannot be updated.
952
+ #
953
+ # For a detailed `FieldMask` definition, see
954
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
955
+ #
956
+ # Example: `updateMask=filter`.
957
+ #
958
+ # @yield [response, operation] Access the result along with the RPC operation
959
+ # @yieldparam response [::Google::Cloud::Logging::V2::LogView]
960
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
961
+ #
962
+ # @return [::Google::Cloud::Logging::V2::LogView]
963
+ #
964
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
965
+ #
966
+ def update_view request, options = nil
967
+ raise ::ArgumentError, "request must be provided" if request.nil?
968
+
969
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::UpdateViewRequest
970
+
971
+ # Converts hash and nil to an options object
972
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
973
+
974
+ # Customize the options with defaults
975
+ metadata = @config.rpcs.update_view.metadata.to_h
976
+
977
+ # Set x-goog-api-client and x-goog-user-project headers
978
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
979
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
980
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
981
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
982
+
983
+ header_params = {
984
+ "name" => request.name
985
+ }
986
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
987
+ metadata[:"x-goog-request-params"] ||= request_params_header
988
+
989
+ options.apply_defaults timeout: @config.rpcs.update_view.timeout,
990
+ metadata: metadata,
991
+ retry_policy: @config.rpcs.update_view.retry_policy
992
+ options.apply_defaults metadata: @config.metadata,
993
+ retry_policy: @config.retry_policy
994
+
995
+ @config_service_stub.call_rpc :update_view, request, options: options do |response, operation|
996
+ yield response, operation if block_given?
997
+ return response
998
+ end
999
+ rescue ::GRPC::BadStatus => e
1000
+ raise ::Google::Cloud::Error.from_error(e)
1001
+ end
1002
+
1003
+ ##
1004
+ # Deletes a view from a bucket.
1005
+ #
1006
+ # @overload delete_view(request, options = nil)
1007
+ # Pass arguments to `delete_view` via a request object, either of type
1008
+ # {::Google::Cloud::Logging::V2::DeleteViewRequest} or an equivalent Hash.
1009
+ #
1010
+ # @param request [::Google::Cloud::Logging::V2::DeleteViewRequest, ::Hash]
1011
+ # A request object representing the call parameters. Required. To specify no
1012
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1013
+ # @param options [::Gapic::CallOptions, ::Hash]
1014
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1015
+ #
1016
+ # @overload delete_view(name: nil)
1017
+ # Pass arguments to `delete_view` via keyword arguments. Note that at
1018
+ # least one keyword argument is required. To specify no parameters, or to keep all
1019
+ # the default parameter values, pass an empty Hash as a request object (see above).
1020
+ #
1021
+ # @param name [::String]
1022
+ # Required. The full resource name of the view to delete:
1023
+ #
1024
+ # "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]"
1025
+ #
1026
+ # Example:
1027
+ # `"projects/my-project-id/locations/my-location/buckets/my-bucket-id/views/my-view-id"`.
1028
+ #
1029
+ # @yield [response, operation] Access the result along with the RPC operation
1030
+ # @yieldparam response [::Google::Protobuf::Empty]
1031
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1032
+ #
1033
+ # @return [::Google::Protobuf::Empty]
1034
+ #
1035
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1036
+ #
1037
+ def delete_view request, options = nil
1038
+ raise ::ArgumentError, "request must be provided" if request.nil?
1039
+
1040
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Logging::V2::DeleteViewRequest
1041
+
1042
+ # Converts hash and nil to an options object
1043
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1044
+
1045
+ # Customize the options with defaults
1046
+ metadata = @config.rpcs.delete_view.metadata.to_h
1047
+
1048
+ # Set x-goog-api-client and x-goog-user-project headers
1049
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1050
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1051
+ gapic_version: ::Google::Cloud::Logging::V2::VERSION
1052
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1053
+
1054
+ header_params = {
1055
+ "name" => request.name
1056
+ }
1057
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1058
+ metadata[:"x-goog-request-params"] ||= request_params_header
1059
+
1060
+ options.apply_defaults timeout: @config.rpcs.delete_view.timeout,
1061
+ metadata: metadata,
1062
+ retry_policy: @config.rpcs.delete_view.retry_policy
1063
+ options.apply_defaults metadata: @config.metadata,
1064
+ retry_policy: @config.retry_policy
1065
+
1066
+ @config_service_stub.call_rpc :delete_view, request, options: options do |response, operation|
1067
+ yield response, operation if block_given?
1068
+ return response
1069
+ end
1070
+ rescue ::GRPC::BadStatus => e
1071
+ raise ::Google::Cloud::Error.from_error(e)
1072
+ end
1073
+
465
1074
  ##
466
1075
  # Lists sinks.
467
1076
  #
@@ -1554,7 +2163,7 @@ module Google
1554
2163
 
1555
2164
  config_attr :endpoint, "logging.googleapis.com", ::String
1556
2165
  config_attr :credentials, nil do |value|
1557
- allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
2166
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1558
2167
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
1559
2168
  allowed.any? { |klass| klass === value }
1560
2169
  end
@@ -1594,7 +2203,7 @@ module Google
1594
2203
  # Each configuration object is of type `Gapic::Config::Method` and includes
1595
2204
  # the following configuration fields:
1596
2205
  #
1597
- # * `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
2206
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
1598
2207
  # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
1599
2208
  # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
1600
2209
  # include the following keys:
@@ -1616,11 +2225,51 @@ module Google
1616
2225
  #
1617
2226
  attr_reader :get_bucket
1618
2227
  ##
2228
+ # RPC-specific configuration for `create_bucket`
2229
+ # @return [::Gapic::Config::Method]
2230
+ #
2231
+ attr_reader :create_bucket
2232
+ ##
1619
2233
  # RPC-specific configuration for `update_bucket`
1620
2234
  # @return [::Gapic::Config::Method]
1621
2235
  #
1622
2236
  attr_reader :update_bucket
1623
2237
  ##
2238
+ # RPC-specific configuration for `delete_bucket`
2239
+ # @return [::Gapic::Config::Method]
2240
+ #
2241
+ attr_reader :delete_bucket
2242
+ ##
2243
+ # RPC-specific configuration for `undelete_bucket`
2244
+ # @return [::Gapic::Config::Method]
2245
+ #
2246
+ attr_reader :undelete_bucket
2247
+ ##
2248
+ # RPC-specific configuration for `list_views`
2249
+ # @return [::Gapic::Config::Method]
2250
+ #
2251
+ attr_reader :list_views
2252
+ ##
2253
+ # RPC-specific configuration for `get_view`
2254
+ # @return [::Gapic::Config::Method]
2255
+ #
2256
+ attr_reader :get_view
2257
+ ##
2258
+ # RPC-specific configuration for `create_view`
2259
+ # @return [::Gapic::Config::Method]
2260
+ #
2261
+ attr_reader :create_view
2262
+ ##
2263
+ # RPC-specific configuration for `update_view`
2264
+ # @return [::Gapic::Config::Method]
2265
+ #
2266
+ attr_reader :update_view
2267
+ ##
2268
+ # RPC-specific configuration for `delete_view`
2269
+ # @return [::Gapic::Config::Method]
2270
+ #
2271
+ attr_reader :delete_view
2272
+ ##
1624
2273
  # RPC-specific configuration for `list_sinks`
1625
2274
  # @return [::Gapic::Config::Method]
1626
2275
  #
@@ -1687,8 +2336,24 @@ module Google
1687
2336
  @list_buckets = ::Gapic::Config::Method.new list_buckets_config
1688
2337
  get_bucket_config = parent_rpcs&.get_bucket if parent_rpcs&.respond_to? :get_bucket
1689
2338
  @get_bucket = ::Gapic::Config::Method.new get_bucket_config
2339
+ create_bucket_config = parent_rpcs&.create_bucket if parent_rpcs&.respond_to? :create_bucket
2340
+ @create_bucket = ::Gapic::Config::Method.new create_bucket_config
1690
2341
  update_bucket_config = parent_rpcs&.update_bucket if parent_rpcs&.respond_to? :update_bucket
1691
2342
  @update_bucket = ::Gapic::Config::Method.new update_bucket_config
2343
+ delete_bucket_config = parent_rpcs&.delete_bucket if parent_rpcs&.respond_to? :delete_bucket
2344
+ @delete_bucket = ::Gapic::Config::Method.new delete_bucket_config
2345
+ undelete_bucket_config = parent_rpcs&.undelete_bucket if parent_rpcs&.respond_to? :undelete_bucket
2346
+ @undelete_bucket = ::Gapic::Config::Method.new undelete_bucket_config
2347
+ list_views_config = parent_rpcs&.list_views if parent_rpcs&.respond_to? :list_views
2348
+ @list_views = ::Gapic::Config::Method.new list_views_config
2349
+ get_view_config = parent_rpcs&.get_view if parent_rpcs&.respond_to? :get_view
2350
+ @get_view = ::Gapic::Config::Method.new get_view_config
2351
+ create_view_config = parent_rpcs&.create_view if parent_rpcs&.respond_to? :create_view
2352
+ @create_view = ::Gapic::Config::Method.new create_view_config
2353
+ update_view_config = parent_rpcs&.update_view if parent_rpcs&.respond_to? :update_view
2354
+ @update_view = ::Gapic::Config::Method.new update_view_config
2355
+ delete_view_config = parent_rpcs&.delete_view if parent_rpcs&.respond_to? :delete_view
2356
+ @delete_view = ::Gapic::Config::Method.new delete_view_config
1692
2357
  list_sinks_config = parent_rpcs&.list_sinks if parent_rpcs&.respond_to? :list_sinks
1693
2358
  @list_sinks = ::Gapic::Config::Method.new list_sinks_config
1694
2359
  get_sink_config = parent_rpcs&.get_sink if parent_rpcs&.respond_to? :get_sink