Class ModelServiceClient (2.4.0)

Service Description: A service for managing Vertex AI's machine learning Models.

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]");
   Model response = modelServiceClient.getModel(name);
 }
 

Note: close() needs to be called on the ModelServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

The surface of this class includes several types of Java methods for each of the API's methods:

1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of ModelServiceSettings to create(). For example:

To customize credentials:

 ModelServiceSettings modelServiceSettings =
     ModelServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 ModelServiceClient modelServiceClient = ModelServiceClient.create(modelServiceSettings);
 

To customize the endpoint:

 ModelServiceSettings modelServiceSettings =
     ModelServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 ModelServiceClient modelServiceClient = ModelServiceClient.create(modelServiceSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

Constructs an instance of ModelServiceClient, using the given settings. This is protected so that it is easy to make a subclass, but otherwise, the static factory methods should be preferred.

Constructs an instance of ModelServiceClient with default settings.

Constructs an instance of ModelServiceClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Constructs an instance of ModelServiceClient, using the given stub for making calls. This is for advanced usage - prefer using create(ModelServiceSettings).

Deletes a Model.

Model can only be deleted if there are no [DeployedModels][] created from it.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   DeleteModelRequest request =
       DeleteModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .build();
   modelServiceClient.deleteModelAsync(request).get();
 }
 

Deletes a Model.

Model can only be deleted if there are no [DeployedModels][] created from it.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]");
   modelServiceClient.deleteModelAsync(name).get();
 }
 

Deletes a Model.

Model can only be deleted if there are no [DeployedModels][] created from it.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString();
   modelServiceClient.deleteModelAsync(name).get();
 }
 

Deletes a Model.

Model can only be deleted if there are no [DeployedModels][] created from it.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   DeleteModelRequest request =
       DeleteModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .build();
   ApiFuture

Deletes a Model.

Model can only be deleted if there are no [DeployedModels][] created from it.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   DeleteModelRequest request =
       DeleteModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .build();
   OperationFuture

Exports a trained, exportable, Model to a location specified by the user. A Model is considered to be exportable if it has at least one supported export format.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ExportModelRequest request =
       ExportModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .setOutputConfig(ExportModelRequest.OutputConfig.newBuilder().build())
           .build();
   ExportModelResponse response = modelServiceClient.exportModelAsync(request).get();
 }
 

Exports a trained, exportable, Model to a location specified by the user. A Model is considered to be exportable if it has at least one supported export format.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]");
   ExportModelRequest.OutputConfig outputConfig =
       ExportModelRequest.OutputConfig.newBuilder().build();
   ExportModelResponse response = modelServiceClient.exportModelAsync(name, outputConfig).get();
 }
 

Exports a trained, exportable, Model to a location specified by the user. A Model is considered to be exportable if it has at least one supported export format.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString();
   ExportModelRequest.OutputConfig outputConfig =
       ExportModelRequest.OutputConfig.newBuilder().build();
   ExportModelResponse response = modelServiceClient.exportModelAsync(name, outputConfig).get();
 }
 

Exports a trained, exportable, Model to a location specified by the user. A Model is considered to be exportable if it has at least one supported export format.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ExportModelRequest request =
       ExportModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .setOutputConfig(ExportModelRequest.OutputConfig.newBuilder().build())
           .build();
   ApiFuture

Exports a trained, exportable, Model to a location specified by the user. A Model is considered to be exportable if it has at least one supported export format.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ExportModelRequest request =
       ExportModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .setOutputConfig(ExportModelRequest.OutputConfig.newBuilder().build())
           .build();
   OperationFuture

Gets a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   GetModelRequest request =
       GetModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .build();
   Model response = modelServiceClient.getModel(request);
 }
 

Gets a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelName name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]");
   Model response = modelServiceClient.getModel(name);
 }
 

Gets a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String name = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString();
   Model response = modelServiceClient.getModel(name);
 }
 

Gets a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   GetModelRequest request =
       GetModelRequest.newBuilder()
           .setName(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .build();
   ApiFuture

Gets a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   GetModelEvaluationRequest request =
       GetModelEvaluationRequest.newBuilder()
           .setName(
               ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]")
                   .toString())
           .build();
   ModelEvaluation response = modelServiceClient.getModelEvaluation(request);
 }
 

Gets a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelEvaluationName name =
       ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]");
   ModelEvaluation response = modelServiceClient.getModelEvaluation(name);
 }
 

Gets a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String name =
       ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]").toString();
   ModelEvaluation response = modelServiceClient.getModelEvaluation(name);
 }
 

Gets a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   GetModelEvaluationRequest request =
       GetModelEvaluationRequest.newBuilder()
           .setName(
               ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]")
                   .toString())
           .build();
   ApiFuture

Gets a ModelEvaluationSlice.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   GetModelEvaluationSliceRequest request =
       GetModelEvaluationSliceRequest.newBuilder()
           .setName(
               ModelEvaluationSliceName.of(
                       "[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]", "[SLICE]")
                   .toString())
           .build();
   ModelEvaluationSlice response = modelServiceClient.getModelEvaluationSlice(request);
 }
 

Gets a ModelEvaluationSlice.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelEvaluationSliceName name =
       ModelEvaluationSliceName.of(
           "[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]", "[SLICE]");
   ModelEvaluationSlice response = modelServiceClient.getModelEvaluationSlice(name);
 }
 

Gets a ModelEvaluationSlice.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String name =
       ModelEvaluationSliceName.of(
               "[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]", "[SLICE]")
           .toString();
   ModelEvaluationSlice response = modelServiceClient.getModelEvaluationSlice(name);
 }
 

Gets a ModelEvaluationSlice.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   GetModelEvaluationSliceRequest request =
       GetModelEvaluationSliceRequest.newBuilder()
           .setName(
               ModelEvaluationSliceName.of(
                       "[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]", "[SLICE]")
                   .toString())
           .build();
   ApiFuture

Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

Lists ModelEvaluationSlices in a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelEvaluationSlicesRequest request =
       ListModelEvaluationSlicesRequest.newBuilder()
           .setParent(
               ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]")
                   .toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .build();
   for (ModelEvaluationSlice element :
       modelServiceClient.listModelEvaluationSlices(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists ModelEvaluationSlices in a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelEvaluationName parent =
       ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]");
   for (ModelEvaluationSlice element :
       modelServiceClient.listModelEvaluationSlices(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists ModelEvaluationSlices in a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String parent =
       ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]").toString();
   for (ModelEvaluationSlice element :
       modelServiceClient.listModelEvaluationSlices(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists ModelEvaluationSlices in a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelEvaluationSlicesRequest request =
       ListModelEvaluationSlicesRequest.newBuilder()
           .setParent(
               ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]")
                   .toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .build();
   while (true) {
     ListModelEvaluationSlicesResponse response =
         modelServiceClient.listModelEvaluationSlicesCallable().call(request);
     for (ModelEvaluationSlice element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

Lists ModelEvaluationSlices in a ModelEvaluation.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelEvaluationSlicesRequest request =
       ListModelEvaluationSlicesRequest.newBuilder()
           .setParent(
               ModelEvaluationName.of("[PROJECT]", "[LOCATION]", "[MODEL]", "[EVALUATION]")
                   .toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture

Lists ModelEvaluations in a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelEvaluationsRequest request =
       ListModelEvaluationsRequest.newBuilder()
           .setParent(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .build();
   for (ModelEvaluation element :
       modelServiceClient.listModelEvaluations(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists ModelEvaluations in a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ModelName parent = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]");
   for (ModelEvaluation element : modelServiceClient.listModelEvaluations(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists ModelEvaluations in a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String parent = ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString();
   for (ModelEvaluation element : modelServiceClient.listModelEvaluations(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists ModelEvaluations in a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelEvaluationsRequest request =
       ListModelEvaluationsRequest.newBuilder()
           .setParent(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .build();
   while (true) {
     ListModelEvaluationsResponse response =
         modelServiceClient.listModelEvaluationsCallable().call(request);
     for (ModelEvaluation element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

Lists ModelEvaluations in a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelEvaluationsRequest request =
       ListModelEvaluationsRequest.newBuilder()
           .setParent(ModelName.of("[PROJECT]", "[LOCATION]", "[MODEL]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture

Lists Models in a Location.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelsRequest request =
       ListModelsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .setOrderBy("orderBy-1207110587")
           .build();
   for (Model element : modelServiceClient.listModels(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists Models in a Location.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   for (Model element : modelServiceClient.listModels(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists Models in a Location.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   for (Model element : modelServiceClient.listModels(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 

Lists Models in a Location.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelsRequest request =
       ListModelsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .setOrderBy("orderBy-1207110587")
           .build();
   while (true) {
     ListModelsResponse response = modelServiceClient.listModelsCallable().call(request);
     for (Model element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 

Lists Models in a Location.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   ListModelsRequest request =
       ListModelsRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setReadMask(FieldMask.newBuilder().build())
           .setOrderBy("orderBy-1207110587")
           .build();
   ApiFuture

Updates a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   Model model = Model.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Model response = modelServiceClient.updateModel(model, updateMask);
 }
 

Updates a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   UpdateModelRequest request =
       UpdateModelRequest.newBuilder()
           .setModel(Model.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Model response = modelServiceClient.updateModel(request);
 }
 

Updates a Model.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   UpdateModelRequest request =
       UpdateModelRequest.newBuilder()
           .setModel(Model.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture

Uploads a Model artifact into Vertex AI.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   Model model = Model.newBuilder().build();
   UploadModelResponse response = modelServiceClient.uploadModelAsync(parent, model).get();
 }
 

Uploads a Model artifact into Vertex AI.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   UploadModelRequest request =
       UploadModelRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setModel(Model.newBuilder().build())
           .build();
   UploadModelResponse response = modelServiceClient.uploadModelAsync(request).get();
 }
 

Uploads a Model artifact into Vertex AI.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   Model model = Model.newBuilder().build();
   UploadModelResponse response = modelServiceClient.uploadModelAsync(parent, model).get();
 }
 

Uploads a Model artifact into Vertex AI.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   UploadModelRequest request =
       UploadModelRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setModel(Model.newBuilder().build())
           .build();
   ApiFuture

Uploads a Model artifact into Vertex AI.

Sample code:

 try (ModelServiceClient modelServiceClient = ModelServiceClient.create()) {
   UploadModelRequest request =
       UploadModelRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setModel(Model.newBuilder().build())
           .build();
   OperationFuture