google-cloud-app_engine-v1 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: e5504ff4af34988a690bc4bfdadf40c040c049b6d71b35ef61e8f094dd294920
4
- data.tar.gz: 3488e551eb077540dc81b55ef9bc17968840f209cfc27020c2015939f7b6bccc
3
+ metadata.gz: 04b0f29e9a3ad100bdb853ae7292db81b1b35c5460de01d717603414f097c0ef
4
+ data.tar.gz: 223dd14002ec3b9a400f0d3023d97dd41628af45fc489b3900ef19d9c1b128b8
5
5
  SHA512:
6
- metadata.gz: 12cb997cea4186502d5d9d0f3e536e8f1416a2f3118805d421cd576fb0a3f727677cec75e5bcb45a55698eb8cdc111ad684da039b2b73e9662e87c46e3bdfbd8
7
- data.tar.gz: 152fb52a7943a570ccb997977ed1873f0ca08896fbe9ab52afdabc7492eb9617735a9f08ef6afae36dc846d5187ae9c463bfa78de714314b54057597ee3994ff
6
+ metadata.gz: ca0118ba0a0d899722223ece4509eb95169ccec537fd3caafd471af2adda38ef8470eff55bb42a7076e6aa76b594ea4f189eb2839245fb198910ed037a81e9eb
7
+ data.tar.gz: 1fe44afa51e201d4a1a288636df867c152e277bfb62ca1f1551b7ceb211b793c401c764070e99b3f5950a0cf312fd0723f6bec61023c4b34ba65874c7333c1e3
@@ -613,8 +613,6 @@ module Google
613
613
  # @return [::String,nil]
614
614
  # @!attribute [rw] credentials
615
615
  # Credentials to send with calls. You may provide any of the following types:
616
- # * (`String`) The path to a service account key file in JSON format
617
- # * (`Hash`) A service account key as a Hash
618
616
  # * (`Google::Auth::Credentials`) A googleauth credentials object
619
617
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
620
618
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -623,7 +621,26 @@ module Google
623
621
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
624
622
  # * (`nil`) indicating no credentials
625
623
  #
626
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
624
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
625
+ # is deprecated. Providing an unvalidated credential configuration to
626
+ # Google APIs can compromise the security of your systems and data.
627
+ #
628
+ # @example
629
+ #
630
+ # # The recommended way to provide credentials is to use the `make_creds` method
631
+ # # on the appropriate credentials class for your environment.
632
+ #
633
+ # require "googleauth"
634
+ #
635
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
636
+ # json_key_io: ::File.open("/path/to/keyfile.json")
637
+ # )
638
+ #
639
+ # client = ::Google::Cloud::AppEngine::V1::Applications::Client.new do |config|
640
+ # config.credentials = credentials
641
+ # end
642
+ #
643
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
627
644
  # external source for authentication to Google Cloud, you must validate it before
628
645
  # providing it to a Google API client library. Providing an unvalidated credential
629
646
  # 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.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -671,8 +671,6 @@ module Google
671
671
  # @return [::String,nil]
672
672
  # @!attribute [rw] credentials
673
673
  # Credentials to send with calls. You may provide any of the following types:
674
- # * (`String`) The path to a service account key file in JSON format
675
- # * (`Hash`) A service account key as a Hash
676
674
  # * (`Google::Auth::Credentials`) A googleauth credentials object
677
675
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
678
676
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -681,7 +679,26 @@ module Google
681
679
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
682
680
  # * (`nil`) indicating no credentials
683
681
  #
684
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
682
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
683
+ # is deprecated. Providing an unvalidated credential configuration to
684
+ # Google APIs can compromise the security of your systems and data.
685
+ #
686
+ # @example
687
+ #
688
+ # # The recommended way to provide credentials is to use the `make_creds` method
689
+ # # on the appropriate credentials class for your environment.
690
+ #
691
+ # require "googleauth"
692
+ #
693
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
694
+ # json_key_io: ::File.open("/path/to/keyfile.json")
695
+ # )
696
+ #
697
+ # client = ::Google::Cloud::AppEngine::V1::AuthorizedCertificates::Client.new do |config|
698
+ # config.credentials = credentials
699
+ # end
700
+ #
701
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
685
702
  # external source for authentication to Google Cloud, you must validate it before
686
703
  # providing it to a Google API client library. Providing an unvalidated credential
687
704
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -313,8 +313,6 @@ module Google
313
313
  # @return [::String,nil]
314
314
  # @!attribute [rw] credentials
315
315
  # Credentials to send with calls. You may provide any of the following types:
316
- # * (`String`) The path to a service account key file in JSON format
317
- # * (`Hash`) A service account key as a Hash
318
316
  # * (`Google::Auth::Credentials`) A googleauth credentials object
319
317
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
320
318
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -323,7 +321,26 @@ module Google
323
321
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
324
322
  # * (`nil`) indicating no credentials
325
323
  #
326
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
324
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
325
+ # is deprecated. Providing an unvalidated credential configuration to
326
+ # Google APIs can compromise the security of your systems and data.
327
+ #
328
+ # @example
329
+ #
330
+ # # The recommended way to provide credentials is to use the `make_creds` method
331
+ # # on the appropriate credentials class for your environment.
332
+ #
333
+ # require "googleauth"
334
+ #
335
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
336
+ # json_key_io: ::File.open("/path/to/keyfile.json")
337
+ # )
338
+ #
339
+ # client = ::Google::Cloud::AppEngine::V1::AuthorizedDomains::Client.new do |config|
340
+ # config.credentials = credentials
341
+ # end
342
+ #
343
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
327
344
  # external source for authentication to Google Cloud, you must validate it before
328
345
  # providing it to a Google API client library. Providing an unvalidated credential
329
346
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -712,8 +712,6 @@ module Google
712
712
  # @return [::String,nil]
713
713
  # @!attribute [rw] credentials
714
714
  # Credentials to send with calls. You may provide any of the following types:
715
- # * (`String`) The path to a service account key file in JSON format
716
- # * (`Hash`) A service account key as a Hash
717
715
  # * (`Google::Auth::Credentials`) A googleauth credentials object
718
716
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
719
717
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -722,7 +720,26 @@ module Google
722
720
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
723
721
  # * (`nil`) indicating no credentials
724
722
  #
725
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
723
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
724
+ # is deprecated. Providing an unvalidated credential configuration to
725
+ # Google APIs can compromise the security of your systems and data.
726
+ #
727
+ # @example
728
+ #
729
+ # # The recommended way to provide credentials is to use the `make_creds` method
730
+ # # on the appropriate credentials class for your environment.
731
+ #
732
+ # require "googleauth"
733
+ #
734
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
735
+ # json_key_io: ::File.open("/path/to/keyfile.json")
736
+ # )
737
+ #
738
+ # client = ::Google::Cloud::AppEngine::V1::DomainMappings::Client.new do |config|
739
+ # config.credentials = credentials
740
+ # end
741
+ #
742
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
726
743
  # external source for authentication to Google Cloud, you must validate it before
727
744
  # providing it to a Google API client library. Providing an unvalidated credential
728
745
  # 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.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -776,8 +776,6 @@ module Google
776
776
  # @return [::String,nil]
777
777
  # @!attribute [rw] credentials
778
778
  # Credentials to send with calls. You may provide any of the following types:
779
- # * (`String`) The path to a service account key file in JSON format
780
- # * (`Hash`) A service account key as a Hash
781
779
  # * (`Google::Auth::Credentials`) A googleauth credentials object
782
780
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
783
781
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -786,7 +784,26 @@ module Google
786
784
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
787
785
  # * (`nil`) indicating no credentials
788
786
  #
789
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
787
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
788
+ # is deprecated. Providing an unvalidated credential configuration to
789
+ # Google APIs can compromise the security of your systems and data.
790
+ #
791
+ # @example
792
+ #
793
+ # # The recommended way to provide credentials is to use the `make_creds` method
794
+ # # on the appropriate credentials class for your environment.
795
+ #
796
+ # require "googleauth"
797
+ #
798
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
799
+ # json_key_io: ::File.open("/path/to/keyfile.json")
800
+ # )
801
+ #
802
+ # client = ::Google::Cloud::AppEngine::V1::Firewall::Client.new do |config|
803
+ # config.credentials = credentials
804
+ # end
805
+ #
806
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
790
807
  # external source for authentication to Google Cloud, you must validate it before
791
808
  # providing it to a Google API client library. Providing an unvalidated credential
792
809
  # configuration to Google APIs can compromise the security of your systems and data.
@@ -631,8 +631,6 @@ module Google
631
631
  # @return [::String,nil]
632
632
  # @!attribute [rw] credentials
633
633
  # 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
634
  # * (`Google::Auth::Credentials`) A googleauth credentials object
637
635
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
638
636
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -641,7 +639,26 @@ module Google
641
639
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
642
640
  # * (`nil`) indicating no credentials
643
641
  #
644
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
642
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
643
+ # is deprecated. Providing an unvalidated credential configuration to
644
+ # Google APIs can compromise the security of your systems and data.
645
+ #
646
+ # @example
647
+ #
648
+ # # The recommended way to provide credentials is to use the `make_creds` method
649
+ # # on the appropriate credentials class for your environment.
650
+ #
651
+ # require "googleauth"
652
+ #
653
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
654
+ # json_key_io: ::File.open("/path/to/keyfile.json")
655
+ # )
656
+ #
657
+ # client = ::Google::Cloud::AppEngine::V1::Instances::Client.new do |config|
658
+ # config.credentials = credentials
659
+ # end
660
+ #
661
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
645
662
  # external source for authentication to Google Cloud, you must validate it before
646
663
  # providing it to a Google API client library. Providing an unvalidated credential
647
664
  # 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.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -616,8 +616,6 @@ module Google
616
616
  # @return [::String,nil]
617
617
  # @!attribute [rw] credentials
618
618
  # Credentials to send with calls. You may provide any of the following types:
619
- # * (`String`) The path to a service account key file in JSON format
620
- # * (`Hash`) A service account key as a Hash
621
619
  # * (`Google::Auth::Credentials`) A googleauth credentials object
622
620
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
623
621
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -626,7 +624,26 @@ module Google
626
624
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
627
625
  # * (`nil`) indicating no credentials
628
626
  #
629
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
627
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
628
+ # is deprecated. Providing an unvalidated credential configuration to
629
+ # Google APIs can compromise the security of your systems and data.
630
+ #
631
+ # @example
632
+ #
633
+ # # The recommended way to provide credentials is to use the `make_creds` method
634
+ # # on the appropriate credentials class for your environment.
635
+ #
636
+ # require "googleauth"
637
+ #
638
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
639
+ # json_key_io: ::File.open("/path/to/keyfile.json")
640
+ # )
641
+ #
642
+ # client = ::Google::Cloud::AppEngine::V1::Services::Client.new do |config|
643
+ # config.credentials = credentials
644
+ # end
645
+ #
646
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
630
647
  # external source for authentication to Google Cloud, you must validate it before
631
648
  # providing it to a Google API client library. Providing an unvalidated credential
632
649
  # 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.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module AppEngine
23
23
  module V1
24
- VERSION = "1.4.0"
24
+ VERSION = "1.5.1"
25
25
  end
26
26
  end
27
27
  end
@@ -745,8 +745,6 @@ module Google
745
745
  # @return [::String,nil]
746
746
  # @!attribute [rw] credentials
747
747
  # Credentials to send with calls. You may provide any of the following types:
748
- # * (`String`) The path to a service account key file in JSON format
749
- # * (`Hash`) A service account key as a Hash
750
748
  # * (`Google::Auth::Credentials`) A googleauth credentials object
751
749
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
752
750
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -755,7 +753,26 @@ module Google
755
753
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
756
754
  # * (`nil`) indicating no credentials
757
755
  #
758
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
756
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
757
+ # is deprecated. Providing an unvalidated credential configuration to
758
+ # Google APIs can compromise the security of your systems and data.
759
+ #
760
+ # @example
761
+ #
762
+ # # The recommended way to provide credentials is to use the `make_creds` method
763
+ # # on the appropriate credentials class for your environment.
764
+ #
765
+ # require "googleauth"
766
+ #
767
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
768
+ # json_key_io: ::File.open("/path/to/keyfile.json")
769
+ # )
770
+ #
771
+ # client = ::Google::Cloud::AppEngine::V1::Versions::Client.new do |config|
772
+ # config.credentials = credentials
773
+ # end
774
+ #
775
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
759
776
  # external source for authentication to Google Cloud, you must validate it before
760
777
  # providing it to a Google API client library. Providing an unvalidated credential
761
778
  # 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.
@@ -125,7 +125,7 @@ module Google
125
125
  # @param options [::Gapic::CallOptions, ::Hash]
126
126
  # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
127
127
  #
128
- # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
128
+ # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
129
129
  # Pass arguments to `list_operations` via keyword arguments. Note that at
130
130
  # least one keyword argument is required. To specify no parameters, or to keep all
131
131
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
138
138
  # The standard list page size.
139
139
  # @param page_token [::String]
140
140
  # The standard list page token.
141
+ # @param return_partial_success [::Boolean]
142
+ # When set to `true`, operations that are reachable are returned as normal,
143
+ # and those that are unreachable are returned in the
144
+ # [ListOperationsResponse.unreachable] field.
145
+ #
146
+ # This can only be `true` when reading across collections e.g. when `parent`
147
+ # is set to `"projects/example/locations/-"`.
148
+ #
149
+ # This field is not by default supported and will result in an
150
+ # `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
151
+ # service or product specific documentation.
141
152
  # @yield [result, operation] Access the result along with the TransportOperation object
142
153
  # @yieldparam result [::Gapic::Operation]
143
154
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -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-app_engine-v1
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