google-cloud-config_service-v1 0.3.1 → 0.5.0

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.
@@ -225,8 +225,8 @@ module Google
225
225
  # 'projects/\\{project_id}/locations/\\{location}'.
226
226
  # @param page_size [::Integer]
227
227
  # When requesting a page of resources, 'page_size' specifies number of
228
- # resources to return. If unspecified or set to 0, all resources will be
229
- # returned.
228
+ # resources to return. If unspecified, at most 500 will be returned. The
229
+ # maximum value is 1000.
230
230
  # @param page_token [::String]
231
231
  # Token returned by previous call to 'ListDeployments' which specifies the
232
232
  # position in the list from where to continue listing the resources.
@@ -745,8 +745,8 @@ module Google
745
745
  # 'projects/\\{project_id}/locations/\\{location}/deployments/\\{deployment}'.
746
746
  # @param page_size [::Integer]
747
747
  # When requesting a page of resources, `page_size` specifies number of
748
- # resources to return. If unspecified or set to 0, all resources will be
749
- # returned.
748
+ # resources to return. If unspecified, at most 500 will be returned. The
749
+ # maximum value is 1000.
750
750
  # @param page_token [::String]
751
751
  # Token returned by previous call to 'ListRevisions' which specifies the
752
752
  # position in the list from where to continue listing the resources.
@@ -1019,8 +1019,8 @@ module Google
1019
1019
  # 'projects/\\{project_id}/locations/\\{location}/deployments/\\{deployment}/revisions/\\{revision}'.
1020
1020
  # @param page_size [::Integer]
1021
1021
  # When requesting a page of resources, 'page_size' specifies number of
1022
- # resources to return. If unspecified or set to 0, all resources will be
1023
- # returned.
1022
+ # resources to return. If unspecified, at most 500 will be returned. The
1023
+ # maximum value is 1000.
1024
1024
  # @param page_token [::String]
1025
1025
  # Token returned by previous call to 'ListResources' which specifies the
1026
1026
  # position in the list from where to continue listing the resources.
@@ -1897,8 +1897,8 @@ module Google
1897
1897
  # value is in the format: 'projects/\\{project_id}/locations/\\{location}'.
1898
1898
  # @param page_size [::Integer]
1899
1899
  # Optional. When requesting a page of resources, 'page_size' specifies number
1900
- # of resources to return. If unspecified or set to 0, all resources will be
1901
- # returned.
1900
+ # of resources to return. If unspecified, at most 500 will be returned. The
1901
+ # maximum value is 1000.
1902
1902
  # @param page_token [::String]
1903
1903
  # Optional. Token returned by previous call to 'ListDeployments' which
1904
1904
  # specifies the position in the list from where to continue listing the
@@ -2170,6 +2170,190 @@ module Google
2170
2170
  raise ::Google::Cloud::Error.from_error(e)
2171
2171
  end
2172
2172
 
2173
+ ##
2174
+ # Lists {::Google::Cloud::ConfigService::V1::TerraformVersion TerraformVersion}s in a
2175
+ # given project and location.
2176
+ #
2177
+ # @overload list_terraform_versions(request, options = nil)
2178
+ # Pass arguments to `list_terraform_versions` via a request object, either of type
2179
+ # {::Google::Cloud::ConfigService::V1::ListTerraformVersionsRequest} or an equivalent Hash.
2180
+ #
2181
+ # @param request [::Google::Cloud::ConfigService::V1::ListTerraformVersionsRequest, ::Hash]
2182
+ # A request object representing the call parameters. Required. To specify no
2183
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2184
+ # @param options [::Gapic::CallOptions, ::Hash]
2185
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2186
+ #
2187
+ # @overload list_terraform_versions(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
2188
+ # Pass arguments to `list_terraform_versions` via keyword arguments. Note that at
2189
+ # least one keyword argument is required. To specify no parameters, or to keep all
2190
+ # the default parameter values, pass an empty Hash as a request object (see above).
2191
+ #
2192
+ # @param parent [::String]
2193
+ # Required. The parent in whose context the TerraformVersions are listed. The
2194
+ # parent value is in the format:
2195
+ # 'projects/\\{project_id}/locations/\\{location}'.
2196
+ # @param page_size [::Integer]
2197
+ # Optional. When requesting a page of resources, 'page_size' specifies number
2198
+ # of resources to return. If unspecified, at most 500 will be returned. The
2199
+ # maximum value is 1000.
2200
+ # @param page_token [::String]
2201
+ # Optional. Token returned by previous call to 'ListTerraformVersions' which
2202
+ # specifies the position in the list from where to continue listing the
2203
+ # resources.
2204
+ # @param filter [::String]
2205
+ # Optional. Lists the TerraformVersions that match the filter expression. A
2206
+ # filter expression filters the resources listed in the response. The
2207
+ # expression must be of the form '\\{field} \\{operator} \\{value}' where
2208
+ # operators: '<', '>',
2209
+ # '<=', '>=', '!=', '=', ':' are supported (colon ':' represents a HAS
2210
+ # operator which is roughly synonymous with equality). \\{field} can refer to a
2211
+ # proto or JSON field, or a synthetic field. Field names can be camelCase or
2212
+ # snake_case.
2213
+ # @param order_by [::String]
2214
+ # Optional. Field to use to sort the list.
2215
+ # @yield [result, operation] Access the result along with the TransportOperation object
2216
+ # @yieldparam result [::Google::Cloud::ConfigService::V1::ListTerraformVersionsResponse]
2217
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2218
+ #
2219
+ # @return [::Google::Cloud::ConfigService::V1::ListTerraformVersionsResponse]
2220
+ #
2221
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2222
+ #
2223
+ # @example Basic example
2224
+ # require "google/cloud/config_service/v1"
2225
+ #
2226
+ # # Create a client object. The client can be reused for multiple calls.
2227
+ # client = Google::Cloud::ConfigService::V1::Config::Rest::Client.new
2228
+ #
2229
+ # # Create a request. To set request fields, pass in keyword arguments.
2230
+ # request = Google::Cloud::ConfigService::V1::ListTerraformVersionsRequest.new
2231
+ #
2232
+ # # Call the list_terraform_versions method.
2233
+ # result = client.list_terraform_versions request
2234
+ #
2235
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2236
+ # # over elements, and API calls will be issued to fetch pages as needed.
2237
+ # result.each do |item|
2238
+ # # Each element is of type ::Google::Cloud::ConfigService::V1::TerraformVersion.
2239
+ # p item
2240
+ # end
2241
+ #
2242
+ def list_terraform_versions request, options = nil
2243
+ raise ::ArgumentError, "request must be provided" if request.nil?
2244
+
2245
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ConfigService::V1::ListTerraformVersionsRequest
2246
+
2247
+ # Converts hash and nil to an options object
2248
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2249
+
2250
+ # Customize the options with defaults
2251
+ call_metadata = @config.rpcs.list_terraform_versions.metadata.to_h
2252
+
2253
+ # Set x-goog-api-client and x-goog-user-project headers
2254
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2255
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2256
+ gapic_version: ::Google::Cloud::ConfigService::V1::VERSION,
2257
+ transports_version_send: [:rest]
2258
+
2259
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2260
+
2261
+ options.apply_defaults timeout: @config.rpcs.list_terraform_versions.timeout,
2262
+ metadata: call_metadata,
2263
+ retry_policy: @config.rpcs.list_terraform_versions.retry_policy
2264
+
2265
+ options.apply_defaults timeout: @config.timeout,
2266
+ metadata: @config.metadata,
2267
+ retry_policy: @config.retry_policy
2268
+
2269
+ @config_stub.list_terraform_versions request, options do |result, operation|
2270
+ yield result, operation if block_given?
2271
+ return result
2272
+ end
2273
+ rescue ::Gapic::Rest::Error => e
2274
+ raise ::Google::Cloud::Error.from_error(e)
2275
+ end
2276
+
2277
+ ##
2278
+ # Gets details about a
2279
+ # {::Google::Cloud::ConfigService::V1::TerraformVersion TerraformVersion}.
2280
+ #
2281
+ # @overload get_terraform_version(request, options = nil)
2282
+ # Pass arguments to `get_terraform_version` via a request object, either of type
2283
+ # {::Google::Cloud::ConfigService::V1::GetTerraformVersionRequest} or an equivalent Hash.
2284
+ #
2285
+ # @param request [::Google::Cloud::ConfigService::V1::GetTerraformVersionRequest, ::Hash]
2286
+ # A request object representing the call parameters. Required. To specify no
2287
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2288
+ # @param options [::Gapic::CallOptions, ::Hash]
2289
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2290
+ #
2291
+ # @overload get_terraform_version(name: nil)
2292
+ # Pass arguments to `get_terraform_version` via keyword arguments. Note that at
2293
+ # least one keyword argument is required. To specify no parameters, or to keep all
2294
+ # the default parameter values, pass an empty Hash as a request object (see above).
2295
+ #
2296
+ # @param name [::String]
2297
+ # Required. The name of the TerraformVersion. Format:
2298
+ # 'projects/\\{project_id}/locations/\\{location}/terraformVersions/\\{terraform_version}'
2299
+ # @yield [result, operation] Access the result along with the TransportOperation object
2300
+ # @yieldparam result [::Google::Cloud::ConfigService::V1::TerraformVersion]
2301
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2302
+ #
2303
+ # @return [::Google::Cloud::ConfigService::V1::TerraformVersion]
2304
+ #
2305
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2306
+ #
2307
+ # @example Basic example
2308
+ # require "google/cloud/config_service/v1"
2309
+ #
2310
+ # # Create a client object. The client can be reused for multiple calls.
2311
+ # client = Google::Cloud::ConfigService::V1::Config::Rest::Client.new
2312
+ #
2313
+ # # Create a request. To set request fields, pass in keyword arguments.
2314
+ # request = Google::Cloud::ConfigService::V1::GetTerraformVersionRequest.new
2315
+ #
2316
+ # # Call the get_terraform_version method.
2317
+ # result = client.get_terraform_version request
2318
+ #
2319
+ # # The returned object is of type Google::Cloud::ConfigService::V1::TerraformVersion.
2320
+ # p result
2321
+ #
2322
+ def get_terraform_version request, options = nil
2323
+ raise ::ArgumentError, "request must be provided" if request.nil?
2324
+
2325
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ConfigService::V1::GetTerraformVersionRequest
2326
+
2327
+ # Converts hash and nil to an options object
2328
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2329
+
2330
+ # Customize the options with defaults
2331
+ call_metadata = @config.rpcs.get_terraform_version.metadata.to_h
2332
+
2333
+ # Set x-goog-api-client and x-goog-user-project headers
2334
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2335
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2336
+ gapic_version: ::Google::Cloud::ConfigService::V1::VERSION,
2337
+ transports_version_send: [:rest]
2338
+
2339
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2340
+
2341
+ options.apply_defaults timeout: @config.rpcs.get_terraform_version.timeout,
2342
+ metadata: call_metadata,
2343
+ retry_policy: @config.rpcs.get_terraform_version.retry_policy
2344
+
2345
+ options.apply_defaults timeout: @config.timeout,
2346
+ metadata: @config.metadata,
2347
+ retry_policy: @config.retry_policy
2348
+
2349
+ @config_stub.get_terraform_version request, options do |result, operation|
2350
+ yield result, operation if block_given?
2351
+ return result
2352
+ end
2353
+ rescue ::Gapic::Rest::Error => e
2354
+ raise ::Google::Cloud::Error.from_error(e)
2355
+ end
2356
+
2173
2357
  ##
2174
2358
  # Configuration class for the Config REST API.
2175
2359
  #
@@ -2415,6 +2599,16 @@ module Google
2415
2599
  # @return [::Gapic::Config::Method]
2416
2600
  #
2417
2601
  attr_reader :export_preview_result
2602
+ ##
2603
+ # RPC-specific configuration for `list_terraform_versions`
2604
+ # @return [::Gapic::Config::Method]
2605
+ #
2606
+ attr_reader :list_terraform_versions
2607
+ ##
2608
+ # RPC-specific configuration for `get_terraform_version`
2609
+ # @return [::Gapic::Config::Method]
2610
+ #
2611
+ attr_reader :get_terraform_version
2418
2612
 
2419
2613
  # @private
2420
2614
  def initialize parent_rpcs = nil
@@ -2460,6 +2654,10 @@ module Google
2460
2654
  @delete_preview = ::Gapic::Config::Method.new delete_preview_config
2461
2655
  export_preview_result_config = parent_rpcs.export_preview_result if parent_rpcs.respond_to? :export_preview_result
2462
2656
  @export_preview_result = ::Gapic::Config::Method.new export_preview_result_config
2657
+ list_terraform_versions_config = parent_rpcs.list_terraform_versions if parent_rpcs.respond_to? :list_terraform_versions
2658
+ @list_terraform_versions = ::Gapic::Config::Method.new list_terraform_versions_config
2659
+ get_terraform_version_config = parent_rpcs.get_terraform_version if parent_rpcs.respond_to? :get_terraform_version
2660
+ @get_terraform_version = ::Gapic::Config::Method.new get_terraform_version_config
2463
2661
 
2464
2662
  yield self if block_given?
2465
2663
  end
@@ -859,6 +859,82 @@ module Google
859
859
  result
860
860
  end
861
861
 
862
+ ##
863
+ # Baseline implementation for the list_terraform_versions REST call
864
+ #
865
+ # @param request_pb [::Google::Cloud::ConfigService::V1::ListTerraformVersionsRequest]
866
+ # A request object representing the call parameters. Required.
867
+ # @param options [::Gapic::CallOptions]
868
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
869
+ #
870
+ # @yield [result, operation] Access the result along with the TransportOperation object
871
+ # @yieldparam result [::Google::Cloud::ConfigService::V1::ListTerraformVersionsResponse]
872
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
873
+ #
874
+ # @return [::Google::Cloud::ConfigService::V1::ListTerraformVersionsResponse]
875
+ # A result object deserialized from the server's reply
876
+ def list_terraform_versions request_pb, options = nil
877
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
878
+
879
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_terraform_versions_request request_pb
880
+ query_string_params = if query_string_params.any?
881
+ query_string_params.to_h { |p| p.split "=", 2 }
882
+ else
883
+ {}
884
+ end
885
+
886
+ response = @client_stub.make_http_request(
887
+ verb,
888
+ uri: uri,
889
+ body: body || "",
890
+ params: query_string_params,
891
+ options: options
892
+ )
893
+ operation = ::Gapic::Rest::TransportOperation.new response
894
+ result = ::Google::Cloud::ConfigService::V1::ListTerraformVersionsResponse.decode_json response.body, ignore_unknown_fields: true
895
+
896
+ yield result, operation if block_given?
897
+ result
898
+ end
899
+
900
+ ##
901
+ # Baseline implementation for the get_terraform_version REST call
902
+ #
903
+ # @param request_pb [::Google::Cloud::ConfigService::V1::GetTerraformVersionRequest]
904
+ # A request object representing the call parameters. Required.
905
+ # @param options [::Gapic::CallOptions]
906
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
907
+ #
908
+ # @yield [result, operation] Access the result along with the TransportOperation object
909
+ # @yieldparam result [::Google::Cloud::ConfigService::V1::TerraformVersion]
910
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
911
+ #
912
+ # @return [::Google::Cloud::ConfigService::V1::TerraformVersion]
913
+ # A result object deserialized from the server's reply
914
+ def get_terraform_version request_pb, options = nil
915
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
916
+
917
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_terraform_version_request request_pb
918
+ query_string_params = if query_string_params.any?
919
+ query_string_params.to_h { |p| p.split "=", 2 }
920
+ else
921
+ {}
922
+ end
923
+
924
+ response = @client_stub.make_http_request(
925
+ verb,
926
+ uri: uri,
927
+ body: body || "",
928
+ params: query_string_params,
929
+ options: options
930
+ )
931
+ operation = ::Gapic::Rest::TransportOperation.new response
932
+ result = ::Google::Cloud::ConfigService::V1::TerraformVersion.decode_json response.body, ignore_unknown_fields: true
933
+
934
+ yield result, operation if block_given?
935
+ result
936
+ end
937
+
862
938
  ##
863
939
  # @private
864
940
  #
@@ -1309,6 +1385,48 @@ module Google
1309
1385
  )
1310
1386
  transcoder.transcode request_pb
1311
1387
  end
1388
+
1389
+ ##
1390
+ # @private
1391
+ #
1392
+ # GRPC transcoding helper method for the list_terraform_versions REST call
1393
+ #
1394
+ # @param request_pb [::Google::Cloud::ConfigService::V1::ListTerraformVersionsRequest]
1395
+ # A request object representing the call parameters. Required.
1396
+ # @return [Array(String, [String, nil], Hash{String => String})]
1397
+ # Uri, Body, Query string parameters
1398
+ def self.transcode_list_terraform_versions_request request_pb
1399
+ transcoder = Gapic::Rest::GrpcTranscoder.new
1400
+ .with_bindings(
1401
+ uri_method: :get,
1402
+ uri_template: "/v1/{parent}/terraformVersions",
1403
+ matches: [
1404
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
1405
+ ]
1406
+ )
1407
+ transcoder.transcode request_pb
1408
+ end
1409
+
1410
+ ##
1411
+ # @private
1412
+ #
1413
+ # GRPC transcoding helper method for the get_terraform_version REST call
1414
+ #
1415
+ # @param request_pb [::Google::Cloud::ConfigService::V1::GetTerraformVersionRequest]
1416
+ # A request object representing the call parameters. Required.
1417
+ # @return [Array(String, [String, nil], Hash{String => String})]
1418
+ # Uri, Body, Query string parameters
1419
+ def self.transcode_get_terraform_version_request request_pb
1420
+ transcoder = Gapic::Rest::GrpcTranscoder.new
1421
+ .with_bindings(
1422
+ uri_method: :get,
1423
+ uri_template: "/v1/{name}",
1424
+ matches: [
1425
+ ["name", %r{^projects/[^/]+/locations/[^/]+/terraformVersions/[^/]+/?$}, false]
1426
+ ]
1427
+ )
1428
+ transcoder.transcode request_pb
1429
+ end
1312
1430
  end
1313
1431
  end
1314
1432
  end
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module ConfigService
23
23
  module V1
24
- VERSION = "0.3.1"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -118,6 +118,10 @@ module Google
118
118
  # @return [::String]
119
119
  # Optional link to proto reference documentation. Example:
120
120
  # https://cloud.google.com/pubsub/lite/docs/reference/rpc
121
+ # @!attribute [rw] rest_reference_documentation_uri
122
+ # @return [::String]
123
+ # Optional link to REST reference documentation. Example:
124
+ # https://cloud.google.com/pubsub/lite/docs/reference/rest
121
125
  class Publishing
122
126
  include ::Google::Protobuf::MessageExts
123
127
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -50,9 +50,9 @@ module Google
50
50
 
51
51
  # Internet Protocol v6 value as defined by [RFC
52
52
  # 2460](https://datatracker.ietf.org/doc/html/rfc2460). The value may be
53
- # normalized to entirely lowercase letters, and zero-padded partial and
54
- # empty octets. For example, the value `2001:DB8::` would be normalized to
55
- # `2001:0db8:0:0`.
53
+ # normalized to entirely lowercase letters with zeros compressed, following
54
+ # [RFC 5952](https://datatracker.ietf.org/doc/html/rfc5952). For example,
55
+ # the value `2001:0DB8:0::0` would be normalized to `2001:db8::`.
56
56
  IPV6 = 3
57
57
 
58
58
  # An IP address in either v4 or v6 format as described by the individual