google-iam-v2 0.10.0 → 0.11.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: a8b974a85be067a0461fda914a67fb10ce43703a7de9e481217b674f03e3fd42
4
- data.tar.gz: '091c53d7078c3c811e6c7dac77ca389def8598da0ffe298796b7d340eaa15e12'
3
+ metadata.gz: 4b6da90e20ffdab0edb3ad0428c63d7b08a9e0c17d45e700e1106603501f5c2c
4
+ data.tar.gz: 87764a5265b3b6ef400babb8ce9760f9740581fec9a57aad060a04d90b774f11
5
5
  SHA512:
6
- metadata.gz: 0f7dbb2d78cdfabf023c15a063437366ea15357864498de6a7bce8e123a240f20f4b63807257c544bd8f039e26105d5f2d69dffad6f36e445ce54bd4e4a16270
7
- data.tar.gz: d6d27fd5a8200ffc816e0ec858b3622de10879a1adb97c7ad10bfd9139fccd2fe5b14479e826d705c5353922c194f01b1e52c0bebb256cf8fe94eb37ed602c17
6
+ metadata.gz: 6e208dd119c6f75719567d67a275abf60ef3dfc854fc6f9c39a0a208e62112b4f353b479a19ce00857376fc41c15bfc18b81d178f84cf2649e3a318e76e7c535
7
+ data.tar.gz: 675f36cad49b7dfda09cbb7842a25b5cde41bde6ea8ad37666e53caa6d24badc5a9d8d8c65c6d118a33b04e55185f62e7693c499640984efca822ec9cc779082
@@ -789,8 +789,6 @@ module Google
789
789
  # @return [::String,nil]
790
790
  # @!attribute [rw] credentials
791
791
  # Credentials to send with calls. You may provide any of the following types:
792
- # * (`String`) The path to a service account key file in JSON format
793
- # * (`Hash`) A service account key as a Hash
794
792
  # * (`Google::Auth::Credentials`) A googleauth credentials object
795
793
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
796
794
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -799,7 +797,26 @@ module Google
799
797
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
800
798
  # * (`nil`) indicating no credentials
801
799
  #
802
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
800
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
801
+ # is deprecated. Providing an unvalidated credential configuration to
802
+ # Google APIs can compromise the security of your systems and data.
803
+ #
804
+ # @example
805
+ #
806
+ # # The recommended way to provide credentials is to use the `make_creds` method
807
+ # # on the appropriate credentials class for your environment.
808
+ #
809
+ # require "googleauth"
810
+ #
811
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
812
+ # json_key_io: ::File.open("/path/to/keyfile.json")
813
+ # )
814
+ #
815
+ # client = ::Google::Iam::V2::Policies::Client.new do |config|
816
+ # config.credentials = credentials
817
+ # end
818
+ #
819
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
803
820
  # external source for authentication to Google Cloud, you must validate it before
804
821
  # providing it to a Google API client library. Providing an unvalidated credential
805
822
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -133,7 +133,7 @@ module Google
133
133
  # @param options [::Gapic::CallOptions, ::Hash]
134
134
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
135
135
  #
136
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
136
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
137
137
  # Pass arguments to `list_operations` via keyword arguments. Note that at
138
138
  # least one keyword argument is required. To specify no parameters, or to keep all
139
139
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -146,6 +146,17 @@ module Google
146
146
  # The standard list page size.
147
147
  # @param page_token [::String]
148
148
  # The standard list page token.
149
+ # @param return_partial_success [::Boolean]
150
+ # When set to `true`, operations that are reachable are returned as normal,
151
+ # and those that are unreachable are returned in the
152
+ # [ListOperationsResponse.unreachable] field.
153
+ #
154
+ # This can only be `true` when reading across collections e.g. when `parent`
155
+ # is set to `"projects/example/locations/-"`.
156
+ #
157
+ # This field is not by default supported and will result in an
158
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
159
+ # service or product specific documentation.
149
160
  #
150
161
  # @yield [response, operation] Access the result along with the RPC operation
151
162
  # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -630,8 +641,6 @@ module Google
630
641
  # @return [::String,nil]
631
642
  # @!attribute [rw] credentials
632
643
  # Credentials to send with calls. You may provide any of the following types:
633
- # * (`String`) The path to a service account key file in JSON format
634
- # * (`Hash`) A service account key as a Hash
635
644
  # * (`Google::Auth::Credentials`) A googleauth credentials object
636
645
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
637
646
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -640,7 +649,26 @@ module Google
640
649
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
641
650
  # * (`nil`) indicating no credentials
642
651
  #
643
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
652
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
653
+ # is deprecated. Providing an unvalidated credential configuration to
654
+ # Google APIs can compromise the security of your systems and data.
655
+ #
656
+ # @example
657
+ #
658
+ # # The recommended way to provide credentials is to use the `make_creds` method
659
+ # # on the appropriate credentials class for your environment.
660
+ #
661
+ # require "googleauth"
662
+ #
663
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
664
+ # json_key_io: ::File.open("/path/to/keyfile.json")
665
+ # )
666
+ #
667
+ # client = ::Google::Longrunning::Operations::Client.new do |config|
668
+ # config.credentials = credentials
669
+ # end
670
+ #
671
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
644
672
  # external source for authentication to Google Cloud, you must validate it before
645
673
  # providing it to a Google API client library. Providing an unvalidated credential
646
674
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -124,7 +124,7 @@ module Google
124
124
  # @param options [::Gapic::CallOptions, ::Hash]
125
125
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
126
126
  #
127
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
127
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
128
128
  # Pass arguments to `list_operations` via keyword arguments. Note that at
129
129
  # least one keyword argument is required. To specify no parameters, or to keep all
130
130
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -137,6 +137,17 @@ module Google
137
137
  # The standard list page size.
138
138
  # @param page_token [::String]
139
139
  # The standard list page token.
140
+ # @param return_partial_success [::Boolean]
141
+ # When set to `true`, operations that are reachable are returned as normal,
142
+ # and those that are unreachable are returned in the
143
+ # [ListOperationsResponse.unreachable] field.
144
+ #
145
+ # This can only be `true` when reading across collections e.g. when `parent`
146
+ # is set to `"projects/example/locations/-"`.
147
+ #
148
+ # This field is not by default supported and will result in an
149
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
150
+ # service or product specific documentation.
140
151
  # @yield [result, operation] Access the result along with the TransportOperation object
141
152
  # @yieldparam result [::Gapic::Operation]
142
153
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -20,7 +20,7 @@
20
20
  module Google
21
21
  module Iam
22
22
  module V2
23
- VERSION = "0.10.0"
23
+ VERSION = "0.11.1"
24
24
  end
25
25
  end
26
26
  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-iam-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.10.0
4
+ version: 0.11.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC