class Google::Cloud::Compute::V1::RegionInstanceGroups::Rest::ServiceStub

REST service stub for the RegionInstanceGroups service. Service stub contains baseline method implementations including transcoding, making the REST call, and deserialing the response.

Public Class Methods

new(endpoint:, credentials: require "gapic/rest") click to toggle source
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 33
def initialize endpoint:, credentials:
  # These require statements are intentionally placed here to initialize
  # the REST modules only when it's required.
  require "gapic/rest"

  @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials, numeric_enums: false
end

Public Instance Methods

get(request_pb, options = nil) { |result, response| ... } click to toggle source

Baseline implementation for the get REST call

@param request_pb [::Google::Cloud::Compute::V1::GetRegionInstanceGroupRequest]

A request object representing the call parameters. Required.

@param options [::Gapic::CallOptions]

Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

@yield [result, response] Access the result along with the Faraday response object @yieldparam result [::Google::Cloud::Compute::V1::InstanceGroup] @yieldparam response [::Faraday::Response]

@return [::Google::Cloud::Compute::V1::InstanceGroup]

A result object deserialized from the server's reply
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 55
def get request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_get_request request_pb
  query_string_params = if query_string_params.any?
                          query_string_params.to_h { |p| p.split("=", 2) }
                        else
                          {}
                        end

  response = @client_stub.make_http_request(
    verb,
    uri:     uri,
    body:    body || "",
    params:  query_string_params,
    options: options
  )
  result = ::Google::Cloud::Compute::V1::InstanceGroup.decode_json response.body, ignore_unknown_fields: true

  yield result, response if block_given?
  result
end
list(request_pb, options = nil) { |result, response| ... } click to toggle source

Baseline implementation for the list REST call

@param request_pb [::Google::Cloud::Compute::V1::ListRegionInstanceGroupsRequest]

A request object representing the call parameters. Required.

@param options [::Gapic::CallOptions]

Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

@yield [result, response] Access the result along with the Faraday response object @yieldparam result [::Google::Cloud::Compute::V1::RegionInstanceGroupList] @yieldparam response [::Faraday::Response]

@return [::Google::Cloud::Compute::V1::RegionInstanceGroupList]

A result object deserialized from the server's reply
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 92
def list request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_list_request request_pb
  query_string_params = if query_string_params.any?
                          query_string_params.to_h { |p| p.split("=", 2) }
                        else
                          {}
                        end

  response = @client_stub.make_http_request(
    verb,
    uri:     uri,
    body:    body || "",
    params:  query_string_params,
    options: options
  )
  result = ::Google::Cloud::Compute::V1::RegionInstanceGroupList.decode_json response.body, ignore_unknown_fields: true

  yield result, response if block_given?
  result
end
list_instances(request_pb, options = nil) { |result, response| ... } click to toggle source

Baseline implementation for the list_instances REST call

@param request_pb [::Google::Cloud::Compute::V1::ListInstancesRegionInstanceGroupsRequest]

A request object representing the call parameters. Required.

@param options [::Gapic::CallOptions]

Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

@yield [result, response] Access the result along with the Faraday response object @yieldparam result [::Google::Cloud::Compute::V1::RegionInstanceGroupsListInstances] @yieldparam response [::Faraday::Response]

@return [::Google::Cloud::Compute::V1::RegionInstanceGroupsListInstances]

A result object deserialized from the server's reply
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 129
def list_instances request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_list_instances_request request_pb
  query_string_params = if query_string_params.any?
                          query_string_params.to_h { |p| p.split("=", 2) }
                        else
                          {}
                        end

  response = @client_stub.make_http_request(
    verb,
    uri:     uri,
    body:    body || "",
    params:  query_string_params,
    options: options
  )
  result = ::Google::Cloud::Compute::V1::RegionInstanceGroupsListInstances.decode_json response.body, ignore_unknown_fields: true

  yield result, response if block_given?
  result
end
set_named_ports(request_pb, options = nil) { |result, response| ... } click to toggle source

Baseline implementation for the set_named_ports REST call

@param request_pb [::Google::Cloud::Compute::V1::SetNamedPortsRegionInstanceGroupRequest]

A request object representing the call parameters. Required.

@param options [::Gapic::CallOptions]

Overrides the default settings for this call, e.g, timeout, retries etc. Optional.

@yield [result, response] Access the result along with the Faraday response object @yieldparam result [::Google::Cloud::Compute::V1::Operation] @yieldparam response [::Faraday::Response]

@return [::Google::Cloud::Compute::V1::Operation]

A result object deserialized from the server's reply
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 166
def set_named_ports request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_set_named_ports_request request_pb
  query_string_params = if query_string_params.any?
                          query_string_params.to_h { |p| p.split("=", 2) }
                        else
                          {}
                        end

  response = @client_stub.make_http_request(
    verb,
    uri:     uri,
    body:    body || "",
    params:  query_string_params,
    options: options
  )
  result = ::Google::Cloud::Compute::V1::Operation.decode_json response.body, ignore_unknown_fields: true

  yield result, response if block_given?
  result
end

Private Instance Methods

transcode_get_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the get REST call

@param request_pb [::Google::Cloud::Compute::V1::GetRegionInstanceGroupRequest]

A request object representing the call parameters. Required.

@return [Array(String, [String, nil], Hash{String => String})]

Uri, Body, Query string parameters
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 201
def transcode_get_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :get,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/instanceGroups/{instance_group}",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["instance_group", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_list_instances_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the list_instances REST call

@param request_pb [::Google::Cloud::Compute::V1::ListInstancesRegionInstanceGroupsRequest]

A request object representing the call parameters. Required.

@return [Array(String, [String, nil], Hash{String => String})]

Uri, Body, Query string parameters
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 246
def transcode_list_instances_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :post,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/instanceGroups/{instance_group}/listInstances",
                                            body: "region_instance_groups_list_instances_request_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["instance_group", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_list_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the list REST call

@param request_pb [::Google::Cloud::Compute::V1::ListRegionInstanceGroupsRequest]

A request object representing the call parameters. Required.

@return [Array(String, [String, nil], Hash{String => String})]

Uri, Body, Query string parameters
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 224
def transcode_list_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :get,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/instanceGroups",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_set_named_ports_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the set_named_ports REST call

@param request_pb [::Google::Cloud::Compute::V1::SetNamedPortsRegionInstanceGroupRequest]

A request object representing the call parameters. Required.

@return [Array(String, [String, nil], Hash{String => String})]

Uri, Body, Query string parameters
# File lib/google/cloud/compute/v1/region_instance_groups/rest/service_stub.rb, line 270
def transcode_set_named_ports_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :post,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/instanceGroups/{instance_group}/setNamedPorts",
                                            body: "region_instance_groups_set_named_ports_request_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["instance_group", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end