google-cloud-network_connectivity-v1 1.9.0 → 1.10.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: d5a7adc21ace2ae71dc0db83c73a1fe9f77fb2f6b328f2ee5bffc4f626868c35
4
- data.tar.gz: b3073775dee3983a5fdaa5818619ecf4e6dca06ba4cbca9e1557a3102cc3d265
3
+ metadata.gz: 722f77d4ef506424b902b61c74c45da45a7ee053c5b211ca3637339c1519e488
4
+ data.tar.gz: d284c0d86e90094e44b3e49e8365ee77a8d9e85d1b6de7b60fb5b8689d475809
5
5
  SHA512:
6
- metadata.gz: e206de82b60132d048a1031754fad92e64898bc975aa7f3b518fc8d118e74d57a3ddd58c69b38e09866f91b3e6c7562bb04a9dc0c3151583c10b6ec5e140d53c
7
- data.tar.gz: a0d1b62dc883a8891d6ff3ab59b32fdf7951650f80bfe14756f0f0f11fe1aabf3e219a58765740ceeb245acfbb6d7ac1bfeb23f6df7d0da6206390af9ac5a7f0
6
+ metadata.gz: b73d321e043e8199c8cef1915f92ddba2640c66cb16c43276a2f5cfb75a530f06a9f8c8f06ff90672f76cdd801e5ce90987646cf59a6a567ebaea693622cea3e
7
+ data.tar.gz: c61d987de166f6c7e623dba5f11ba107dcb460853ac6fc4ebc8dd5e5b610570438dbae4c42c23b8f401596f21771132a0714ac2be063aa4ae3c8ea12e8014856
@@ -2140,8 +2140,6 @@ module Google
2140
2140
  # @return [::String,nil]
2141
2141
  # @!attribute [rw] credentials
2142
2142
  # Credentials to send with calls. You may provide any of the following types:
2143
- # * (`String`) The path to a service account key file in JSON format
2144
- # * (`Hash`) A service account key as a Hash
2145
2143
  # * (`Google::Auth::Credentials`) A googleauth credentials object
2146
2144
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2147
2145
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -2150,7 +2148,26 @@ module Google
2150
2148
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2151
2149
  # * (`nil`) indicating no credentials
2152
2150
  #
2153
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
2151
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
2152
+ # is deprecated. Providing an unvalidated credential configuration to
2153
+ # Google APIs can compromise the security of your systems and data.
2154
+ #
2155
+ # @example
2156
+ #
2157
+ # # The recommended way to provide credentials is to use the `make_creds` method
2158
+ # # on the appropriate credentials class for your environment.
2159
+ #
2160
+ # require "googleauth"
2161
+ #
2162
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
2163
+ # json_key_io: ::File.open("/path/to/keyfile.json")
2164
+ # )
2165
+ #
2166
+ # client = ::Google::Cloud::NetworkConnectivity::V1::CrossNetworkAutomationService::Client.new do |config|
2167
+ # config.credentials = credentials
2168
+ # end
2169
+ #
2170
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
2154
2171
  # external source for authentication to Google Cloud, you must validate it before
2155
2172
  # providing it to a Google API client library. Providing an unvalidated credential
2156
2173
  # 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.
@@ -1534,8 +1534,6 @@ module Google
1534
1534
  # @return [::String,nil]
1535
1535
  # @!attribute [rw] credentials
1536
1536
  # Credentials to send with calls. You may provide any of the following types:
1537
- # * (`String`) The path to a service account key file in JSON format
1538
- # * (`Hash`) A service account key as a Hash
1539
1537
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1540
1538
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1541
1539
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -1544,7 +1542,26 @@ module Google
1544
1542
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1545
1543
  # * (`nil`) indicating no credentials
1546
1544
  #
1547
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
1545
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
1546
+ # is deprecated. Providing an unvalidated credential configuration to
1547
+ # Google APIs can compromise the security of your systems and data.
1548
+ #
1549
+ # @example
1550
+ #
1551
+ # # The recommended way to provide credentials is to use the `make_creds` method
1552
+ # # on the appropriate credentials class for your environment.
1553
+ #
1554
+ # require "googleauth"
1555
+ #
1556
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
1557
+ # json_key_io: ::File.open("/path/to/keyfile.json")
1558
+ # )
1559
+ #
1560
+ # client = ::Google::Cloud::NetworkConnectivity::V1::DataTransferService::Client.new do |config|
1561
+ # config.credentials = credentials
1562
+ # end
1563
+ #
1564
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
1548
1565
  # external source for authentication to Google Cloud, you must validate it before
1549
1566
  # providing it to a Google API client library. Providing an unvalidated credential
1550
1567
  # 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.
@@ -2690,8 +2690,6 @@ module Google
2690
2690
  # @return [::String,nil]
2691
2691
  # @!attribute [rw] credentials
2692
2692
  # Credentials to send with calls. You may provide any of the following types:
2693
- # * (`String`) The path to a service account key file in JSON format
2694
- # * (`Hash`) A service account key as a Hash
2695
2693
  # * (`Google::Auth::Credentials`) A googleauth credentials object
2696
2694
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2697
2695
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -2700,7 +2698,26 @@ module Google
2700
2698
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2701
2699
  # * (`nil`) indicating no credentials
2702
2700
  #
2703
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
2701
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
2702
+ # is deprecated. Providing an unvalidated credential configuration to
2703
+ # Google APIs can compromise the security of your systems and data.
2704
+ #
2705
+ # @example
2706
+ #
2707
+ # # The recommended way to provide credentials is to use the `make_creds` method
2708
+ # # on the appropriate credentials class for your environment.
2709
+ #
2710
+ # require "googleauth"
2711
+ #
2712
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
2713
+ # json_key_io: ::File.open("/path/to/keyfile.json")
2714
+ # )
2715
+ #
2716
+ # client = ::Google::Cloud::NetworkConnectivity::V1::HubService::Client.new do |config|
2717
+ # config.credentials = credentials
2718
+ # end
2719
+ #
2720
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
2704
2721
  # external source for authentication to Google Cloud, you must validate it before
2705
2722
  # providing it to a Google API client library. Providing an unvalidated credential
2706
2723
  # 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.
@@ -801,8 +801,6 @@ module Google
801
801
  # @return [::String,nil]
802
802
  # @!attribute [rw] credentials
803
803
  # Credentials to send with calls. You may provide any of the following types:
804
- # * (`String`) The path to a service account key file in JSON format
805
- # * (`Hash`) A service account key as a Hash
806
804
  # * (`Google::Auth::Credentials`) A googleauth credentials object
807
805
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
808
806
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -811,7 +809,26 @@ module Google
811
809
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
812
810
  # * (`nil`) indicating no credentials
813
811
  #
814
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
812
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
813
+ # is deprecated. Providing an unvalidated credential configuration to
814
+ # Google APIs can compromise the security of your systems and data.
815
+ #
816
+ # @example
817
+ #
818
+ # # The recommended way to provide credentials is to use the `make_creds` method
819
+ # # on the appropriate credentials class for your environment.
820
+ #
821
+ # require "googleauth"
822
+ #
823
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
824
+ # json_key_io: ::File.open("/path/to/keyfile.json")
825
+ # )
826
+ #
827
+ # client = ::Google::Cloud::NetworkConnectivity::V1::InternalRangeService::Client.new do |config|
828
+ # config.credentials = credentials
829
+ # end
830
+ #
831
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
815
832
  # external source for authentication to Google Cloud, you must validate it before
816
833
  # providing it to a Google API client library. Providing an unvalidated credential
817
834
  # 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.
@@ -685,8 +685,6 @@ module Google
685
685
  # @return [::String,nil]
686
686
  # @!attribute [rw] credentials
687
687
  # Credentials to send with calls. You may provide any of the following types:
688
- # * (`String`) The path to a service account key file in JSON format
689
- # * (`Hash`) A service account key as a Hash
690
688
  # * (`Google::Auth::Credentials`) A googleauth credentials object
691
689
  # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
692
690
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -695,7 +693,26 @@ module Google
695
693
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
696
694
  # * (`nil`) indicating no credentials
697
695
  #
698
- # Warning: If you accept a credential configuration (JSON file or Hash) from an
696
+ # @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
697
+ # is deprecated. Providing an unvalidated credential configuration to
698
+ # Google APIs can compromise the security of your systems and data.
699
+ #
700
+ # @example
701
+ #
702
+ # # The recommended way to provide credentials is to use the `make_creds` method
703
+ # # on the appropriate credentials class for your environment.
704
+ #
705
+ # require "googleauth"
706
+ #
707
+ # credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
708
+ # json_key_io: ::File.open("/path/to/keyfile.json")
709
+ # )
710
+ #
711
+ # client = ::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoutingService::Client.new do |config|
712
+ # config.credentials = credentials
713
+ # end
714
+ #
715
+ # @note Warning: If you accept a credential configuration (JSON file or Hash) from an
699
716
  # external source for authentication to Google Cloud, you must validate it before
700
717
  # providing it to a Google API client library. Providing an unvalidated credential
701
718
  # 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.
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module NetworkConnectivity
23
23
  module V1
24
- VERSION = "1.9.0"
24
+ VERSION = "1.10.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-network_connectivity-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.9.0
4
+ version: 1.10.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC