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

REST service stub for the RegionBackendServices 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_backend_services/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

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

Baseline implementation for the delete REST call

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

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_backend_services/rest/service_stub.rb, line 55
def delete request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_delete_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
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::GetRegionBackendServiceRequest]

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::BackendService] @yieldparam response [::Faraday::Response]

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

A result object deserialized from the server's reply
# File lib/google/cloud/compute/v1/region_backend_services/rest/service_stub.rb, line 92
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::BackendService.decode_json response.body, ignore_unknown_fields: true

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

Baseline implementation for the get_health REST call

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

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::BackendServiceGroupHealth] @yieldparam response [::Faraday::Response]

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

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

  verb, uri, query_string_params, body = transcode_get_health_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::BackendServiceGroupHealth.decode_json response.body, ignore_unknown_fields: true

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

Baseline implementation for the get_iam_policy REST call

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

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::Policy] @yieldparam response [::Faraday::Response]

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

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

  verb, uri, query_string_params, body = transcode_get_iam_policy_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::Policy.decode_json response.body, ignore_unknown_fields: true

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

Baseline implementation for the insert REST call

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

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_backend_services/rest/service_stub.rb, line 203
def insert request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_insert_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
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::ListRegionBackendServicesRequest]

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::BackendServiceList] @yieldparam response [::Faraday::Response]

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

A result object deserialized from the server's reply
# File lib/google/cloud/compute/v1/region_backend_services/rest/service_stub.rb, line 240
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::BackendServiceList.decode_json response.body, ignore_unknown_fields: true

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

Baseline implementation for the patch REST call

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

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_backend_services/rest/service_stub.rb, line 277
def patch request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_patch_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
set_iam_policy(request_pb, options = nil) { |result, response| ... } click to toggle source

Baseline implementation for the set_iam_policy REST call

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

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::Policy] @yieldparam response [::Faraday::Response]

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

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

  verb, uri, query_string_params, body = transcode_set_iam_policy_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::Policy.decode_json response.body, ignore_unknown_fields: true

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

Baseline implementation for the update REST call

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

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_backend_services/rest/service_stub.rb, line 351
def update request_pb, options = nil
  raise ::ArgumentError, "request must be provided" if request_pb.nil?

  verb, uri, query_string_params, body = transcode_update_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_delete_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the delete REST call

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

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_backend_services/rest/service_stub.rb, line 386
def transcode_delete_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :delete,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{backend_service}",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["backend_service", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_get_health_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the get_health REST call

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

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_backend_services/rest/service_stub.rb, line 432
def transcode_get_health_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :post,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{backend_service}/getHealth",
                                            body: "resource_group_reference_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["backend_service", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_get_iam_policy_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the get_iam_policy REST call

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

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_backend_services/rest/service_stub.rb, line 456
def transcode_get_iam_policy_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :get,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["resource", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
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::GetRegionBackendServiceRequest]

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_backend_services/rest/service_stub.rb, line 409
def transcode_get_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :get,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{backend_service}",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["backend_service", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_insert_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the insert REST call

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

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_backend_services/rest/service_stub.rb, line 479
def transcode_insert_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :post,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices",
                                            body: "backend_service_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %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::ListRegionBackendServicesRequest]

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_backend_services/rest/service_stub.rb, line 502
def transcode_list_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :get,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_patch_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the patch REST call

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

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_backend_services/rest/service_stub.rb, line 524
def transcode_patch_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :patch,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{backend_service}",
                                            body: "backend_service_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["backend_service", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_set_iam_policy_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the set_iam_policy REST call

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

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_backend_services/rest/service_stub.rb, line 548
def transcode_set_iam_policy_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :post,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy",
                                            body: "region_set_policy_request_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["resource", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end
transcode_update_request(request_pb) click to toggle source

@private

GRPC transcoding helper method for the update REST call

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

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_backend_services/rest/service_stub.rb, line 572
def transcode_update_request request_pb
  transcoder = Gapic::Rest::GrpcTranscoder.new
                                          .with_bindings(
                                            uri_method: :put,
                                            uri_template: "/compute/v1/projects/{project}/regions/{region}/backendServices/{backend_service}",
                                            body: "backend_service_resource",
                                            matches: [
                                              ["project", %r{^[^/]+/?$}, false],
                                              ["region", %r{^[^/]+/?$}, false],
                                              ["backend_service", %r{^[^/]+/?$}, false]
                                            ]
                                          )
  transcoder.transcode request_pb
end