google-cloud-logging-v2 1.4.0 → 1.5.1

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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ffbdc0e43c5536e0856e57fdf34bf686345e6972f47b7d08ccfa6b07460f876f
4
- data.tar.gz: a3ef82573270b77fc8c481ff192b7001f9d9d8d596b7a6930ec375e78e8d13e5
3
+ metadata.gz: 7eabbd62de19027d0d133ad3c5b03b0fc9276987d22ec7f6305b2f03216f031a
4
+ data.tar.gz: cec2d4189d8a04a9521559dfde32849996cf3ba430acc9ebec3a53e0dfe9de0a
5
5
  SHA512:
6
- metadata.gz: 69b2e1a366f7d8c1d56ae0d55c877432d0f8348a8aecf9970697d8b42950932a665d6e74f014f66ce4f0ceebff1f1a66cbbec1cbcc7e73fc86c54519af4b51ca
7
- data.tar.gz: 95d265af055a2673a2874a034cdbaa4ebd7ecb643f6450430182aa10569b859c4dabd310f40f8ea21607e1eb07e5d4836b2822167753715f428ca8e3ad5e8a24
6
+ metadata.gz: 7aeeabbbd3512bf431e0a93d1cd713277714c8a3ff59d799bdd42556cf5709eddd39452e935a6a74c4cd11a2dd4895d45714a3e98f9a3fc19c9253d09ad42224
7
+ data.tar.gz: 3edf20d9a91660d054a8ebcf8a1c436ad05ebf15ad5ced975204c878aa4f801e8dbe201d34193e94965fe5174112c2dfe71c7640dfa1248306d1398bf58ec132
@@ -3600,8 +3600,6 @@ module Google
3600
3600
  # @return [::String,nil]
3601
3601
  # @!attribute [rw] credentials
3602
3602
  # Credentials to send with calls. You may provide any of the following types:
3603
- # * (`String`) The path to a service account key file in JSON format
3604
- # * (`Hash`) A service account key as a Hash
3605
3603
  # * (`Google::Auth::Credentials`) A googleauth credentials object
3606
3604
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
3607
3605
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -3610,7 +3608,26 @@ module Google
3610
3608
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
3611
3609
  # * (`nil`) indicating no credentials
3612
3610
  #
3613
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
3611
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
3612
+ # is deprecated. Providing an unvalidated credential configuration to
3613
+ # Google APIs can compromise the security of your systems and data.
3614
+ #
3615
+ # @example
3616
+ #
3617
+ # # The recommended way to provide credentials is to use the `make_creds` method
3618
+ # # on the appropriate credentials class for your environment.
3619
+ #
3620
+ # require "googleauth"
3621
+ #
3622
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
3623
+ # json_key_io: ::File.open("/path/to/keyfile.json")
3624
+ # )
3625
+ #
3626
+ # client = ::Google::Cloud::Logging::V2::ConfigService::Client.new do |config|
3627
+ # config.credentials = credentials
3628
+ # end
3629
+ #
3630
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
3614
3631
  # external source for authentication to Google Cloud, you must validate it before
3615
3632
  # providing it to a Google API client library. Providing an unvalidated credential
3616
3633
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -134,7 +134,7 @@ module Google
134
134
  # @param options [::Gapic::CallOptions, ::Hash]
135
135
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
136
136
  #
137
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
137
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
138
138
  # Pass arguments to `list_operations` via keyword arguments. Note that at
139
139
  # least one keyword argument is required. To specify no parameters, or to keep all
140
140
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -147,6 +147,17 @@ module Google
147
147
  # The standard list page size.
148
148
  # @param page_token [::String]
149
149
  # The standard list page token.
150
+ # @param return_partial_success [::Boolean]
151
+ # When set to `true`, operations that are reachable are returned as normal,
152
+ # and those that are unreachable are returned in the
153
+ # [ListOperationsResponse.unreachable] field.
154
+ #
155
+ # This can only be `true` when reading across collections e.g. when `parent`
156
+ # is set to `"projects/example/locations/-"`.
157
+ #
158
+ # This field is not by default supported and will result in an
159
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
160
+ # service or product specific documentation.
150
161
  #
151
162
  # @yield [response, operation] Access the result along with the RPC operation
152
163
  # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -631,8 +642,6 @@ module Google
631
642
  # @return [::String,nil]
632
643
  # @!attribute [rw] credentials
633
644
  # Credentials to send with calls. You may provide any of the following types:
634
- # * (`String`) The path to a service account key file in JSON format
635
- # * (`Hash`) A service account key as a Hash
636
645
  # * (`Google::Auth::Credentials`) A googleauth credentials object
637
646
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
638
647
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -641,7 +650,26 @@ module Google
641
650
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
651
  # * (`nil`) indicating no credentials
643
652
  #
644
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
653
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
654
+ # is deprecated. Providing an unvalidated credential configuration to
655
+ # Google APIs can compromise the security of your systems and data.
656
+ #
657
+ # @example
658
+ #
659
+ # # The recommended way to provide credentials is to use the `make_creds` method
660
+ # # on the appropriate credentials class for your environment.
661
+ #
662
+ # require "googleauth"
663
+ #
664
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
665
+ # json_key_io: ::File.open("/path/to/keyfile.json")
666
+ # )
667
+ #
668
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
669
+ # config.credentials = credentials
670
+ # end
671
+ #
672
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
645
673
  # external source for authentication to Google Cloud, you must validate it before
646
674
  # providing it to a Google API client library. Providing an unvalidated credential
647
675
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -908,8 +908,6 @@ module Google
908
908
  # @return [::String,nil]
909
909
  # @!attribute [rw] credentials
910
910
  # Credentials to send with calls. You may provide any of the following types:
911
- # * (`String`) The path to a service account key file in JSON format
912
- # * (`Hash`) A service account key as a Hash
913
911
  # * (`Google::Auth::Credentials`) A googleauth credentials object
914
912
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
915
913
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -918,7 +916,26 @@ module Google
918
916
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
919
917
  # * (`nil`) indicating no credentials
920
918
  #
921
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
919
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
920
+ # is deprecated. Providing an unvalidated credential configuration to
921
+ # Google APIs can compromise the security of your systems and data.
922
+ #
923
+ # @example
924
+ #
925
+ # # The recommended way to provide credentials is to use the `make_creds` method
926
+ # # on the appropriate credentials class for your environment.
927
+ #
928
+ # require "googleauth"
929
+ #
930
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
931
+ # json_key_io: ::File.open("/path/to/keyfile.json")
932
+ # )
933
+ #
934
+ # client = ::Google::Cloud::Logging::V2::LoggingService::Client.new do |config|
935
+ # config.credentials = credentials
936
+ # end
937
+ #
938
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
922
939
  # external source for authentication to Google Cloud, you must validate it before
923
940
  # providing it to a Google API client library. Providing an unvalidated credential
924
941
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -701,8 +701,6 @@ module Google
701
701
  # @return [::String,nil]
702
702
  # @!attribute [rw] credentials
703
703
  # Credentials to send with calls. You may provide any of the following types:
704
- # * (`String`) The path to a service account key file in JSON format
705
- # * (`Hash`) A service account key as a Hash
706
704
  # * (`Google::Auth::Credentials`) A googleauth credentials object
707
705
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
708
706
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -711,7 +709,26 @@ module Google
711
709
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
712
710
  # * (`nil`) indicating no credentials
713
711
  #
714
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
712
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
713
+ # is deprecated. Providing an unvalidated credential configuration to
714
+ # Google APIs can compromise the security of your systems and data.
715
+ #
716
+ # @example
717
+ #
718
+ # # The recommended way to provide credentials is to use the `make_creds` method
719
+ # # on the appropriate credentials class for your environment.
720
+ #
721
+ # require "googleauth"
722
+ #
723
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
724
+ # json_key_io: ::File.open("/path/to/keyfile.json")
725
+ # )
726
+ #
727
+ # client = ::Google::Cloud::Logging::V2::MetricsService::Client.new do |config|
728
+ # config.credentials = credentials
729
+ # end
730
+ #
731
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
715
732
  # external source for authentication to Google Cloud, you must validate it before
716
733
  # providing it to a Google API client library. Providing an unvalidated credential
717
734
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Logging
23
23
  module V2
24
- VERSION = "1.4.0"
24
+ VERSION = "1.5.1"
25
25
  end
26
26
  end
27
27
  end
@@ -83,6 +83,18 @@ module Google
83
83
  # @!attribute [rw] page_token
84
84
  # @return [::String]
85
85
  # The standard list page token.
86
+ # @!attribute [rw] return_partial_success
87
+ # @return [::Boolean]
88
+ # When set to `true`, operations that are reachable are returned as normal,
89
+ # and those that are unreachable are returned in the
90
+ # [ListOperationsResponse.unreachable] field.
91
+ #
92
+ # This can only be `true` when reading across collections e.g. when `parent`
93
+ # is set to `"projects/example/locations/-"`.
94
+ #
95
+ # This field is not by default supported and will result in an
96
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
97
+ # service or product specific documentation.
86
98
  class ListOperationsRequest
87
99
  include ::Google::Protobuf::MessageExts
88
100
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -96,6 +108,12 @@ module Google
96
108
  # @!attribute [rw] next_page_token
97
109
  # @return [::String]
98
110
  # The standard List next-page token.
111
+ # @!attribute [rw] unreachable
112
+ # @return [::Array<::String>]
113
+ # Unordered list. Unreachable resources. Populated when the request sets
114
+ # `ListOperationsRequest.return_partial_success` and reads across
115
+ # collections e.g. when attempting to list all resources across all supported
116
+ # locations.
99
117
  class ListOperationsResponse
100
118
  include ::Google::Protobuf::MessageExts
101
119
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-logging-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.4.0
4
+ version: 1.5.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC