Version 2.12.0

• 3.15.0 (latest)
• 3.13.0
• 3.11.0
• 3.10.1
• 3.9.0
• 3.7.0
• 3.6.0
• 3.4.0
• 3.3.0
• 3.0.0
• 2.12.0
• 2.11.0
• 2.10.0
• 2.7.0
• 2.6.1
• 2.5.0
• 2.3.0
• 1.19.0
• 1.18.0
• 1.17.0
• 1.16.0
• 1.15.0
• 1.14.1
• 1.13.0
• 1.11.0
• 1.7.2

Vertex AI: Node.js Client

Vertex AI client for Node.js

A comprehensive list of changes in each version may be found in the CHANGELOG.

• Vertex AI Node.js Client API Reference
• Vertex AI Documentation
• github.com/googleapis/google-cloud-node/packages/google-cloud-aiplatform

Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in Client Libraries Explained.

Table of contents:

• Quickstart
  • Before you begin
  • Installing the client library
  • Using the client library
• Samples
• Versioning
• Contributing
• License

Quickstart

Before you begin

1. Select or create a Cloud Platform project.
2. Enable billing for your project.
3. Enable the Vertex AI API.
4. Set up authentication with a service account so you can access the API from your local workstation.

Installing the client library

npm install @google-cloud/aiplatform

Using the client library

/**
 * TODO(developer): Uncomment these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const location = 'YOUR_PROJECT_LOCATION';

const {EndpointServiceClient} = require('@google-cloud/aiplatform');

// Specifies the location of the api endpoint
const clientOptions = {
  apiEndpoint: 'us-central1-aiplatform.googleapis.com',
};
const client = new EndpointServiceClient(clientOptions);

async function listEndpoints() {
  // Configure the parent resource
  const parent = `projects/${projectId}/locations/${location}`;
  const request = {
    parent,
  };

  // Get and print out a list of all the endpoints for this resource
  const [result] = await client.listEndpoints(request);
  for (const endpoint of result) {
    console.log(`\nEndpoint name: ${endpoint.name}`);
    console.log(`Display name: ${endpoint.displayName}`);
    if (endpoint.deployedModels[0]) {
      console.log(
        `First deployed model: ${endpoint.deployedModels[0].model}`
      );
    }
  }
}
listEndpoints();

Samples

Samples are in the samples/ directory. Each sample's README.md has instructions for running its sample.

Sample	Source Code	Try it
Dataset_service.create_dataset	source code
Dataset_service.delete_dataset	source code
Dataset_service.export_data	source code
Dataset_service.get_annotation_spec	source code
Dataset_service.get_dataset	source code
Dataset_service.import_data	source code
Dataset_service.list_annotations	source code
Dataset_service.list_data_items	source code
Dataset_service.list_datasets	source code
Dataset_service.list_saved_queries	source code
Dataset_service.search_data_items	source code
Dataset_service.update_dataset	source code
Endpoint_service.create_endpoint	source code
Endpoint_service.delete_endpoint	source code
Endpoint_service.deploy_model	source code
Endpoint_service.get_endpoint	source code
Endpoint_service.list_endpoints	source code
Endpoint_service.mutate_deployed_model	source code
Endpoint_service.undeploy_model	source code
Endpoint_service.update_endpoint	source code
Featurestore_online_serving_service.read_feature_values	source code
Featurestore_online_serving_service.streaming_read_feature_values	source code
Featurestore_online_serving_service.write_feature_values	source code
Featurestore_service.batch_create_features	source code
Featurestore_service.batch_read_feature_values	source code
Featurestore_service.create_entity_type	source code
Featurestore_service.create_feature	source code
Featurestore_service.create_featurestore	source code
Featurestore_service.delete_entity_type	source code
Featurestore_service.delete_feature	source code
Featurestore_service.delete_feature_values	source code
Featurestore_service.delete_featurestore	source code
Featurestore_service.export_feature_values	source code
Featurestore_service.get_entity_type	source code
Featurestore_service.get_feature	source code
Featurestore_service.get_featurestore	source code
Featurestore_service.import_feature_values	source code
Featurestore_service.list_entity_types	source code
Featurestore_service.list_features	source code
Featurestore_service.list_featurestores	source code
Featurestore_service.search_features	source code
Featurestore_service.update_entity_type	source code
Featurestore_service.update_feature	source code
Featurestore_service.update_featurestore	source code
Index_endpoint_service.create_index_endpoint	source code
Index_endpoint_service.delete_index_endpoint	source code
Index_endpoint_service.deploy_index	source code
Index_endpoint_service.get_index_endpoint	source code
Index_endpoint_service.list_index_endpoints	source code
Index_endpoint_service.mutate_deployed_index	source code
Index_endpoint_service.undeploy_index	source code
Index_endpoint_service.update_index_endpoint	source code
Index_service.create_index	source code
Index_service.delete_index	source code
Index_service.get_index	source code
Index_service.list_indexes	source code
Index_service.remove_datapoints	source code
Index_service.update_index	source code
Index_service.upsert_datapoints	source code
Job_service.cancel_batch_prediction_job	source code
Job_service.cancel_custom_job	source code
Job_service.cancel_data_labeling_job	source code
Job_service.cancel_hyperparameter_tuning_job	source code
Job_service.cancel_nas_job	source code
Job_service.create_batch_prediction_job	source code
Job_service.create_custom_job	source code
Job_service.create_data_labeling_job	source code
Job_service.create_hyperparameter_tuning_job	source code
Job_service.create_model_deployment_monitoring_job	source code
Job_service.create_nas_job	source code
Job_service.delete_batch_prediction_job	source code
Job_service.delete_custom_job	source code
Job_service.delete_data_labeling_job	source code
Job_service.delete_hyperparameter_tuning_job	source code
Job_service.delete_model_deployment_monitoring_job	source code
Job_service.delete_nas_job	source code
Job_service.get_batch_prediction_job	source code
Job_service.get_custom_job	source code
Job_service.get_data_labeling_job	source code
Job_service.get_hyperparameter_tuning_job	source code
Job_service.get_model_deployment_monitoring_job	source code
Job_service.get_nas_job	source code
Job_service.get_nas_trial_detail	source code
Job_service.list_batch_prediction_jobs	source code
Job_service.list_custom_jobs	source code
Job_service.list_data_labeling_jobs	source code
Job_service.list_hyperparameter_tuning_jobs	source code
Job_service.list_model_deployment_monitoring_jobs	source code
Job_service.list_nas_jobs	source code
Job_service.list_nas_trial_details	source code
Job_service.pause_model_deployment_monitoring_job	source code
Job_service.resume_model_deployment_monitoring_job	source code
Job_service.search_model_deployment_monitoring_stats_anomalies	source code
Job_service.update_model_deployment_monitoring_job	source code
Metadata_service.add_context_artifacts_and_executions	source code
Metadata_service.add_context_children	source code
Metadata_service.add_execution_events	source code
Metadata_service.create_artifact	source code
Metadata_service.create_context	source code
Metadata_service.create_execution	source code
Metadata_service.create_metadata_schema	source code
Metadata_service.create_metadata_store	source code
Metadata_service.delete_artifact	source code
Metadata_service.delete_context	source code
Metadata_service.delete_execution	source code
Metadata_service.delete_metadata_store	source code
Metadata_service.get_artifact	source code
Metadata_service.get_context	source code
Metadata_service.get_execution	source code
Metadata_service.get_metadata_schema	source code
Metadata_service.get_metadata_store	source code
Metadata_service.list_artifacts	source code
Metadata_service.list_contexts	source code
Metadata_service.list_executions	source code
Metadata_service.list_metadata_schemas	source code
Metadata_service.list_metadata_stores	source code
Metadata_service.purge_artifacts	source code
Metadata_service.purge_contexts	source code
Metadata_service.purge_executions	source code
Metadata_service.query_artifact_lineage_subgraph	source code
Metadata_service.query_context_lineage_subgraph	source code
Metadata_service.query_execution_inputs_and_outputs	source code
Metadata_service.remove_context_children	source code
Metadata_service.update_artifact	source code
Metadata_service.update_context	source code
Metadata_service.update_execution	source code
Migration_service.batch_migrate_resources	source code
Migration_service.search_migratable_resources	source code
Model_service.batch_import_evaluated_annotations	source code
Model_service.batch_import_model_evaluation_slices	source code
Model_service.copy_model	source code
Model_service.delete_model	source code
Model_service.delete_model_version	source code
Model_service.export_model	source code
Model_service.get_model	source code
Model_service.get_model_evaluation	source code
Model_service.get_model_evaluation_slice	source code
Model_service.import_model_evaluation	source code
Model_service.list_model_evaluation_slices	source code
Model_service.list_model_evaluations	source code
Model_service.list_model_versions	source code
Model_service.list_models	source code
Model_service.merge_version_aliases	source code
Model_service.update_model	source code
Model_service.upload_model	source code
Pipeline_service.cancel_pipeline_job	source code
Pipeline_service.cancel_training_pipeline	source code
Pipeline_service.create_pipeline_job	source code
Pipeline_service.create_training_pipeline	source code
Pipeline_service.delete_pipeline_job	source code
Pipeline_service.delete_training_pipeline	source code
Pipeline_service.get_pipeline_job	source code
Pipeline_service.get_training_pipeline	source code
Pipeline_service.list_pipeline_jobs	source code
Pipeline_service.list_training_pipelines	source code
Prediction_service.explain	source code
Prediction_service.predict	source code
Prediction_service.raw_predict	source code
Specialist_pool_service.create_specialist_pool	source code
Specialist_pool_service.delete_specialist_pool	source code
Specialist_pool_service.get_specialist_pool	source code
Specialist_pool_service.list_specialist_pools	source code
Specialist_pool_service.update_specialist_pool	source code
Tensorboard_service.batch_create_tensorboard_runs	source code
Tensorboard_service.batch_create_tensorboard_time_series	source code
Tensorboard_service.batch_read_tensorboard_time_series_data	source code
Tensorboard_service.create_tensorboard	source code
Tensorboard_service.create_tensorboard_experiment	source code
Tensorboard_service.create_tensorboard_run	source code
Tensorboard_service.create_tensorboard_time_series	source code
Tensorboard_service.delete_tensorboard	source code
Tensorboard_service.delete_tensorboard_experiment	source code
Tensorboard_service.delete_tensorboard_run	source code
Tensorboard_service.delete_tensorboard_time_series	source code
Tensorboard_service.export_tensorboard_time_series_data	source code
Tensorboard_service.get_tensorboard	source code
Tensorboard_service.get_tensorboard_experiment	source code
Tensorboard_service.get_tensorboard_run	source code
Tensorboard_service.get_tensorboard_time_series	source code
Tensorboard_service.list_tensorboard_experiments	source code
Tensorboard_service.list_tensorboard_runs	source code
Tensorboard_service.list_tensorboard_time_series	source code
Tensorboard_service.list_tensorboards	source code
Tensorboard_service.read_tensorboard_blob_data	source code
Tensorboard_service.read_tensorboard_time_series_data	source code
Tensorboard_service.read_tensorboard_usage	source code
Tensorboard_service.update_tensorboard	source code
Tensorboard_service.update_tensorboard_experiment	source code
Tensorboard_service.update_tensorboard_run	source code
Tensorboard_service.update_tensorboard_time_series	source code
Tensorboard_service.write_tensorboard_experiment_data	source code
Tensorboard_service.write_tensorboard_run_data	source code
Vizier_service.add_trial_measurement	source code
Vizier_service.check_trial_early_stopping_state	source code
Vizier_service.complete_trial	source code
Vizier_service.create_study	source code
Vizier_service.create_trial	source code
Vizier_service.delete_study	source code
Vizier_service.delete_trial	source code
Vizier_service.get_study	source code
Vizier_service.get_trial	source code
Vizier_service.list_optimal_trials	source code
Vizier_service.list_studies	source code
Vizier_service.list_trials	source code
Vizier_service.lookup_study	source code
Vizier_service.stop_trial	source code
Vizier_service.suggest_trials	source code
Dataset_service.create_dataset	source code
Dataset_service.delete_dataset	source code
Dataset_service.export_data	source code
Dataset_service.get_annotation_spec	source code
Dataset_service.get_dataset	source code
Dataset_service.import_data	source code
Dataset_service.list_annotations	source code
Dataset_service.list_data_items	source code
Dataset_service.list_datasets	source code
Dataset_service.list_saved_queries	source code
Dataset_service.search_data_items	source code
Dataset_service.update_dataset	source code
Deployment_resource_pool_service.create_deployment_resource_pool	source code
Deployment_resource_pool_service.delete_deployment_resource_pool	source code
Deployment_resource_pool_service.get_deployment_resource_pool	source code
Deployment_resource_pool_service.list_deployment_resource_pools	source code
Deployment_resource_pool_service.query_deployed_models	source code
Endpoint_service.create_endpoint	source code
Endpoint_service.delete_endpoint	source code
Endpoint_service.deploy_model	source code
Endpoint_service.get_endpoint	source code
Endpoint_service.list_endpoints	source code
Endpoint_service.mutate_deployed_model	source code
Endpoint_service.undeploy_model	source code
Endpoint_service.update_endpoint	source code
Featurestore_online_serving_service.read_feature_values	source code
Featurestore_online_serving_service.streaming_read_feature_values	source code
Featurestore_online_serving_service.write_feature_values	source code
Featurestore_service.batch_create_features	source code
Featurestore_service.batch_read_feature_values	source code
Featurestore_service.create_entity_type	source code
Featurestore_service.create_feature	source code
Featurestore_service.create_featurestore	source code
Featurestore_service.delete_entity_type	source code
Featurestore_service.delete_feature	source code
Featurestore_service.delete_feature_values	source code
Featurestore_service.delete_featurestore	source code
Featurestore_service.export_feature_values	source code
Featurestore_service.get_entity_type	source code
Featurestore_service.get_feature	source code
Featurestore_service.get_featurestore	source code
Featurestore_service.import_feature_values	source code
Featurestore_service.list_entity_types	source code
Featurestore_service.list_features	source code
Featurestore_service.list_featurestores	source code
Featurestore_service.search_features	source code
Featurestore_service.update_entity_type	source code
Featurestore_service.update_feature	source code
Featurestore_service.update_featurestore	source code
Index_endpoint_service.create_index_endpoint	source code
Index_endpoint_service.delete_index_endpoint	source code
Index_endpoint_service.deploy_index	source code
Index_endpoint_service.get_index_endpoint	source code
Index_endpoint_service.list_index_endpoints	source code
Index_endpoint_service.mutate_deployed_index	source code
Index_endpoint_service.undeploy_index	source code
Index_endpoint_service.update_index_endpoint	source code
Index_service.create_index	source code
Index_service.delete_index	source code
Index_service.get_index	source code
Index_service.list_indexes	source code
Index_service.remove_datapoints	source code
Index_service.update_index	source code
Index_service.upsert_datapoints	source code
Job_service.cancel_batch_prediction_job	source code
Job_service.cancel_custom_job	source code
Job_service.cancel_data_labeling_job	source code
Job_service.cancel_hyperparameter_tuning_job	source code
Job_service.cancel_nas_job	source code
Job_service.create_batch_prediction_job	source code
Job_service.create_custom_job	source code
Job_service.create_data_labeling_job	source code
Job_service.create_hyperparameter_tuning_job	source code
Job_service.create_model_deployment_monitoring_job	source code
Job_service.create_nas_job	source code
Job_service.delete_batch_prediction_job	source code
Job_service.delete_custom_job	source code
Job_service.delete_data_labeling_job	source code
Job_service.delete_hyperparameter_tuning_job	source code
Job_service.delete_model_deployment_monitoring_job	source code
Job_service.delete_nas_job	source code
Job_service.get_batch_prediction_job	source code
Job_service.get_custom_job	source code
Job_service.get_data_labeling_job	source code
Job_service.get_hyperparameter_tuning_job	source code
Job_service.get_model_deployment_monitoring_job	source code
Job_service.get_nas_job	source code
Job_service.get_nas_trial_detail	source code
Job_service.list_batch_prediction_jobs	source code
Job_service.list_custom_jobs	source code
Job_service.list_data_labeling_jobs	source code
Job_service.list_hyperparameter_tuning_jobs	source code
Job_service.list_model_deployment_monitoring_jobs	source code
Job_service.list_nas_jobs	source code
Job_service.list_nas_trial_details	source code
Job_service.pause_model_deployment_monitoring_job	source code
Job_service.resume_model_deployment_monitoring_job	source code
Job_service.search_model_deployment_monitoring_stats_anomalies	source code
Job_service.update_model_deployment_monitoring_job	source code
Match_service.find_neighbors	source code
Match_service.read_index_datapoints	source code
Metadata_service.add_context_artifacts_and_executions	source code
Metadata_service.add_context_children	source code
Metadata_service.add_execution_events	source code
Metadata_service.create_artifact	source code
Metadata_service.create_context	source code
Metadata_service.create_execution	source code
Metadata_service.create_metadata_schema	source code
Metadata_service.create_metadata_store	source code
Metadata_service.delete_artifact	source code
Metadata_service.delete_context	source code
Metadata_service.delete_execution	source code
Metadata_service.delete_metadata_store	source code
Metadata_service.get_artifact	source code
Metadata_service.get_context	source code
Metadata_service.get_execution	source code
Metadata_service.get_metadata_schema	source code
Metadata_service.get_metadata_store	source code
Metadata_service.list_artifacts	source code
Metadata_service.list_contexts	source code
Metadata_service.list_executions	source code
Metadata_service.list_metadata_schemas	source code
Metadata_service.list_metadata_stores	source code
Metadata_service.purge_artifacts	source code
Metadata_service.purge_contexts	source code
Metadata_service.purge_executions	source code
Metadata_service.query_artifact_lineage_subgraph	source code
Metadata_service.query_context_lineage_subgraph	source code
Metadata_service.query_execution_inputs_and_outputs	source code
Metadata_service.remove_context_children	source code
Metadata_service.update_artifact	source code
Metadata_service.update_context	source code
Metadata_service.update_execution	source code
Migration_service.batch_migrate_resources	source code
Migration_service.search_migratable_resources	source code
Model_garden_service.get_publisher_model	source code
Model_service.batch_import_evaluated_annotations	source code
Model_service.batch_import_model_evaluation_slices	source code
Model_service.copy_model	source code
Model_service.delete_model	source code
Model_service.delete_model_version	source code
Model_service.export_model	source code
Model_service.get_model	source code
Model_service.get_model_evaluation	source code
Model_service.get_model_evaluation_slice	source code
Model_service.import_model_evaluation	source code
Model_service.list_model_evaluation_slices	source code
Model_service.list_model_evaluations	source code
Model_service.list_model_versions	source code
Model_service.list_models	source code
Model_service.merge_version_aliases	source code
Model_service.update_explanation_dataset	source code
Model_service.update_model	source code
Model_service.upload_model	source code
Pipeline_service.cancel_pipeline_job	source code
Pipeline_service.cancel_training_pipeline	source code
Pipeline_service.create_pipeline_job	source code
Pipeline_service.create_training_pipeline	source code
Pipeline_service.delete_pipeline_job	source code
Pipeline_service.delete_training_pipeline	source code
Pipeline_service.get_pipeline_job	source code
Pipeline_service.get_training_pipeline	source code
Pipeline_service.list_pipeline_jobs	source code
Pipeline_service.list_training_pipelines	source code
Prediction_service.explain	source code
Prediction_service.predict	source code
Prediction_service.raw_predict	source code
Schedule_service.create_schedule	source code
Schedule_service.delete_schedule	source code
Schedule_service.get_schedule	source code
Schedule_service.list_schedules	source code
Schedule_service.pause_schedule	source code
Schedule_service.resume_schedule	source code
Specialist_pool_service.create_specialist_pool	source code
Specialist_pool_service.delete_specialist_pool	source code
Specialist_pool_service.get_specialist_pool	source code
Specialist_pool_service.list_specialist_pools	source code
Specialist_pool_service.update_specialist_pool	source code
Tensorboard_service.batch_create_tensorboard_runs	source code
Tensorboard_service.batch_create_tensorboard_time_series	source code
Tensorboard_service.batch_read_tensorboard_time_series_data	source code
Tensorboard_service.create_tensorboard	source code
Tensorboard_service.create_tensorboard_experiment	source code
Tensorboard_service.create_tensorboard_run	source code
Tensorboard_service.create_tensorboard_time_series	source code
Tensorboard_service.delete_tensorboard	source code
Tensorboard_service.delete_tensorboard_experiment	source code
Tensorboard_service.delete_tensorboard_run	source code
Tensorboard_service.delete_tensorboard_time_series	source code
Tensorboard_service.export_tensorboard_time_series_data	source code
Tensorboard_service.get_tensorboard	source code
Tensorboard_service.get_tensorboard_experiment	source code
Tensorboard_service.get_tensorboard_run	source code
Tensorboard_service.get_tensorboard_time_series	source code
Tensorboard_service.list_tensorboard_experiments	source code
Tensorboard_service.list_tensorboard_runs	source code
Tensorboard_service.list_tensorboard_time_series	source code
Tensorboard_service.list_tensorboards	source code
Tensorboard_service.read_tensorboard_blob_data	source code
Tensorboard_service.read_tensorboard_time_series_data	source code
Tensorboard_service.read_tensorboard_usage	source code
Tensorboard_service.update_tensorboard	source code
Tensorboard_service.update_tensorboard_experiment	source code
Tensorboard_service.update_tensorboard_run	source code
Tensorboard_service.update_tensorboard_time_series	source code
Tensorboard_service.write_tensorboard_experiment_data	source code
Tensorboard_service.write_tensorboard_run_data	source code
Vizier_service.add_trial_measurement	source code
Vizier_service.check_trial_early_stopping_state	source code
Vizier_service.complete_trial	source code
Vizier_service.create_study	source code
Vizier_service.create_trial	source code
Vizier_service.delete_study	source code
Vizier_service.delete_trial	source code
Vizier_service.get_study	source code
Vizier_service.get_trial	source code
Vizier_service.list_optimal_trials	source code
Vizier_service.list_studies	source code
Vizier_service.list_trials	source code
Vizier_service.lookup_study	source code
Vizier_service.stop_trial	source code
Vizier_service.suggest_trials	source code
Quickstart	source code
Quickstart.test	source code

The Vertex AI Node.js Client API Reference documentation also contains samples.

Supported Node.js Versions

Our client libraries follow the Node.js release schedule. Libraries are compatible with all current active and maintenance versions of Node.js. If you are using an end-of-life version of Node.js, we recommend that you update as soon as possible to an actively supported LTS version.

Google's client libraries support legacy versions of Node.js runtimes on a best-efforts basis with the following warnings:

• Legacy versions are not tested in continuous integration.
• Some security patches and features cannot be backported.
• Dependencies cannot be kept up-to-date.

Client libraries targeting some end-of-life versions of Node.js are available, and can be installed through npm dist-tags. The dist-tags follow the naming convention legacy-(version). For example, npm install @google-cloud/aiplatform@legacy-8 installs client libraries for versions compatible with Node.js 8.

Versioning

This library follows Semantic Versioning.

This library is considered to be stable. The code surface will not change in backwards-incompatible ways unless absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period. Issues and requests against stable libraries are addressed with the highest priority.

More Information: Google Cloud Platform Launch Stages

Contributing

Contributions welcome! See the Contributing Guide.

Please note that this README.md, the samples/README.md, and a variety of configuration files in this repository (including .nycrc and tsconfig.json) are generated from a central template. To edit one of these files, make an edit to its templates in directory.

License

Apache Version 2.0

See LICENSE