Vertex AI V1 API - Class Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client (v1.17.0)

Reference documentation and code samples for the Vertex AI V1 API class Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client.

REST client for the ModelGardenService service.

The interface of Model Garden Service.

Inherits

  • Object

Includes

Methods

.configure

def self.configure() { |config| ... } -> Client::Configuration

Configure the ModelGardenService Client class.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Returns
Example 
# Modify the configuration for all ModelGardenService clients
::Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client.configure do |config|
  config.timeout = 10.0
end

#configure

def configure() { |config| ... } -> Client::Configuration

Configure the ModelGardenService Client instance.

The configuration is set to the derived mode, meaning that values can be changed, but structural changes (adding new fields, etc.) are not allowed. Structural changes should be made on Client.configure.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Returns

#deploy

def deploy(request, options = nil) -> ::Gapic::Operation
def deploy(publisher_model_name: nil, hugging_face_model_id: nil, destination: nil, model_config: nil, endpoint_config: nil, deploy_config: nil) -> ::Gapic::Operation

Deploys a model to a new endpoint.

Overloads 
def deploy(request, options = nil) -> ::Gapic::Operation
Pass arguments to deploy via a request object, either of type DeployRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::AIPlatform::V1::DeployRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def deploy(publisher_model_name: nil, hugging_face_model_id: nil, destination: nil, model_config: nil, endpoint_config: nil, deploy_config: nil) -> ::Gapic::Operation
Pass arguments to deploy via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • publisher_model_name (::String) — The Model Garden model to deploy. Format: publishers/{publisher}/models/{publisher_model}@{version_id}, or publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001.

    Note: The following fields are mutually exclusive: publisher_model_name, hugging_face_model_id. If a field in that set is populated, all other fields in the set will automatically be cleared.

  • hugging_face_model_id (::String) — The Hugging Face model to deploy. Format: Hugging Face model ID like google/gemma-2-2b-it.

    Note: The following fields are mutually exclusive: hugging_face_model_id, publisher_model_name. If a field in that set is populated, all other fields in the set will automatically be cleared.

  • destination (::String) — Required. The resource name of the Location to deploy the model in. Format: projects/{project}/locations/{location}
  • model_config (::Google::Cloud::AIPlatform::V1::DeployRequest::ModelConfig, ::Hash) — Optional. The model config to use for the deployment. If not specified, the default model config will be used.
  • endpoint_config (::Google::Cloud::AIPlatform::V1::DeployRequest::EndpointConfig, ::Hash) — Optional. The endpoint config to use for the deployment. If not specified, the default endpoint config will be used.
  • deploy_config (::Google::Cloud::AIPlatform::V1::DeployRequest::DeployConfig, ::Hash) — Optional. The deploy config to use for the deployment. If not specified, the default deploy config will be used.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/ai_platform/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::AIPlatform::V1::DeployRequest.new

# Call the deploy method.
result = client.deploy request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#get_publisher_model

def get_publisher_model(request, options = nil) -> ::Google::Cloud::AIPlatform::V1::PublisherModel
def get_publisher_model(name: nil, language_code: nil, view: nil, is_hugging_face_model: nil, hugging_face_token: nil) -> ::Google::Cloud::AIPlatform::V1::PublisherModel

Gets a Model Garden publisher model.

Overloads 
def get_publisher_model(request, options = nil) -> ::Google::Cloud::AIPlatform::V1::PublisherModel
Pass arguments to get_publisher_model via a request object, either of type GetPublisherModelRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::AIPlatform::V1::GetPublisherModelRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_publisher_model(name: nil, language_code: nil, view: nil, is_hugging_face_model: nil, hugging_face_token: nil) -> ::Google::Cloud::AIPlatform::V1::PublisherModel
Pass arguments to get_publisher_model via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The name of the PublisherModel resource. Format: publishers/{publisher}/models/{publisher_model}
  • language_code (::String) — Optional. The IETF BCP-47 language code representing the language in which the publisher model's text information should be written in.
  • view (::Google::Cloud::AIPlatform::V1::PublisherModelView) — Optional. PublisherModel view specifying which fields to read.
  • is_hugging_face_model (::Boolean) — Optional. Boolean indicates whether the requested model is a Hugging Face model.
  • hugging_face_token (::String) — Optional. Token used to access Hugging Face gated models.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/ai_platform/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::AIPlatform::V1::GetPublisherModelRequest.new

# Call the get_publisher_model method.
result = client.get_publisher_model request

# The returned object is of type Google::Cloud::AIPlatform::V1::PublisherModel.
p result

#iam_policy_client

def iam_policy_client() -> Google::Iam::V1::IAMPolicy::Rest::Client

Get the associated client for mix-in of the IAMPolicy.

Returns
  • (Google::Iam::V1::IAMPolicy::Rest::Client)

#initialize

def initialize() { |config| ... } -> Client

Create a new ModelGardenService REST client object.

Yields
  • (config) — Configure the ModelGardenService client.
Yield Parameter
Returns
  • (Client) — a new instance of Client
Example 
# Create a client using the default configuration
client = ::Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client.new

# Create a client using a custom configuration
client = ::Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Client.new do |config|
  config.timeout = 10.0
end

#location_client

def location_client() -> Google::Cloud::Location::Locations::Rest::Client

Get the associated client for mix-in of the Locations.

Returns
  • (Google::Cloud::Location::Locations::Rest::Client)

#logger

def logger() -> Logger

The logger used for request/response debug logging.

Returns
  • (Logger)

#operations_client

def operations_client() -> ::Google::Cloud::AIPlatform::V1::ModelGardenService::Rest::Operations

Get the associated client for long-running operations.

Returns

#universe_domain

def universe_domain() -> String

The effective universe domain

Returns
  • (String)