feat!: BREAKING CHANGE: remove unsupported accelerator types feat: ad…

…d aiplatform API Vizier service (#92)

Committer: @dizcology
PiperOrigin-RevId: 363921711

Source-Author: Google APIs <noreply@google.com>
Source-Date: Fri Mar 19 10:37:18 2021 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 4ea5a2764a08f86676d0e853dbb01c4e9868a22b
Source-Link: googleapis/googleapis@4ea5a27

Co-authored-by: Benjamin E. Coe <bencoe@google.com>

protos/google/cloud/aiplatform/v1beta1/accelerator_type.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -42,10 +42,4 @@ enum AcceleratorType {
 
   // Nvidia Tesla T4 GPU.
   NVIDIA_TESLA_T4 = 5;
-
-  // TPU v2.
-  TPU_V2 = 6;
-
-  // TPU v3.
-  TPU_V3 = 7;
 }

protos/google/cloud/aiplatform/v1beta1/annotation.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ package google.cloud.aiplatform.v1beta1;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+
 import "google/cloud/aiplatform/v1beta1/user_action_reference.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
@@ -58,7 +59,7 @@ message Annotation {
   // Output only. Timestamp when this Annotation was last updated.
   google.protobuf.Timestamp update_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. Used to perform a consistent read-modify-write updates. If not set, a blind
+  // Optional. Used to perform consistent read-modify-write updates. If not set, a blind
   // "overwrite" update happens.
   string etag = 8 [(google.api.field_behavior) = OPTIONAL];
 
@@ -79,7 +80,7 @@ message Annotation {
   //
   // * "aiplatform.googleapis.com/annotation_set_name":
   //   optional, name of the UI's annotation set this Annotation belongs to.
-  //   If not set the Annotation is not visible in the UI.
+  //   If not set, the Annotation is not visible in the UI.
   //
   // * "aiplatform.googleapis.com/payload_schema":
   //   output only, its value is the [payload_schema's][google.cloud.aiplatform.v1beta1.Annotation.payload_schema_uri]

protos/google/cloud/aiplatform/v1beta1/annotation_spec.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -47,7 +47,7 @@ message AnnotationSpec {
   // Output only. Timestamp when AnnotationSpec was last updated.
   google.protobuf.Timestamp update_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. Used to perform a consistent read-modify-write updates. If not set, a blind
+  // Optional. Used to perform consistent read-modify-write updates. If not set, a blind
   // "overwrite" update happens.
   string etag = 5 [(google.api.field_behavior) = OPTIONAL];
 }

protos/google/cloud/aiplatform/v1beta1/batch_prediction_job.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -120,7 +120,6 @@ message BatchPredictionJob {
 
     // Required. The format in which AI Platform gives the predictions, must be one of the
     // [Model's][google.cloud.aiplatform.v1beta1.BatchPredictionJob.model]
-    //
     // [supported_output_storage_formats][google.cloud.aiplatform.v1beta1.Model.supported_output_storage_formats].
     string predictions_format = 1 [(google.api.field_behavior) = REQUIRED];
   }
@@ -206,8 +205,8 @@ message BatchPredictionJob {
   //    conforms to the [Explanation][google.cloud.aiplatform.v1beta1.Explanation] object.
   //  * `csv`: Generating explanations for CSV format is not supported.
   //
-  // If this field is set to true, the [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec] must be
-  // populated.
+  // If this field is set to true, either the [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec] or
+  // [explanation_spec][google.cloud.aiplatform.v1beta1.BatchPredictionJob.explanation_spec] must be populated.
   bool generate_explanation = 23;
 
   // Explanation configuration for this BatchPredictionJob. Can be

protos/google/cloud/aiplatform/v1beta1/completion_stats.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

protos/google/cloud/aiplatform/v1beta1/custom_job.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -93,6 +93,8 @@ message CustomJob {
 // Represents the spec of a CustomJob.
 message CustomJobSpec {
   // Required. The spec of the worker pools including machine type and Docker image.
+  // All worker pools except the first one are optional and can be skipped by
+  // providing an empty value.
   repeated WorkerPoolSpec worker_pool_specs = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Scheduling options for a CustomJob.
@@ -180,10 +182,12 @@ message ContainerSpec {
 
 // The spec of a Python packaged code.
 message PythonPackageSpec {
-  // Required. The URI of a container image in the Container Registry that will run the
-  // provided python package. AI Platform provides wide range of executor images
-  // with pre-installed packages to meet users' various use cases. Only one of
-  // the provided images can be set here.
+  // Required. The URI of a container image in Artifact Registry that will run the
+  // provided Python package. AI Platform provides a wide range of executor
+  // images with pre-installed packages to meet users' various use cases. See
+  // the list of [pre-built containers for
+  // training](https://cloud.google.com/ai-platform-unified/docs/training/pre-built-containers).
+  // You must use an image from this list.
   string executor_image_uri = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The Google Cloud Storage location of the Python package files which are

protos/google/cloud/aiplatform/v1beta1/data_item.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ package google.cloud.aiplatform.v1beta1;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 import "google/api/annotations.proto";
@@ -62,7 +63,7 @@ message DataItem {
   // [metadata schema's][google.cloud.aiplatform.v1beta1.Dataset.metadata_schema_uri] dataItemSchemaUri field.
   google.protobuf.Value payload = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Used to perform a consistent read-modify-write updates. If not set, a blind
+  // Optional. Used to perform consistent read-modify-write updates. If not set, a blind
   // "overwrite" update happens.
   string etag = 7 [(google.api.field_behavior) = OPTIONAL];
 }

protos/google/cloud/aiplatform/v1beta1/data_labeling_job.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -134,13 +134,13 @@ message DataLabelingJob {
   // the EncryptionSpec of the Dataset they are exported to.
   EncryptionSpec encryption_spec = 20;
 
-  // Parameters that configure active learning pipeline. Active learning will
-  // label the data incrementally via several iterations. For every iteration,
-  // it will select a batch of data based on the sampling strategy.
+  // Parameters that configure the active learning pipeline. Active learning
+  // will label the data incrementally via several iterations. For every
+  // iteration, it will select a batch of data based on the sampling strategy.
   ActiveLearningConfig active_learning_config = 21;
 }
 
-// Parameters that configure active learning pipeline. Active learning will
+// Parameters that configure the active learning pipeline. Active learning will
 //  label the data incrementally by several iterations. For every iteration, it
 //  will select a batch of data based on the sampling strategy.
 message ActiveLearningConfig {
@@ -192,7 +192,7 @@ message SampleConfig {
     int32 following_batch_sample_percentage = 3;
   }
 
-  // Field to chose sampling strategy. Sampling strategy will decide which data
+  // Field to choose sampling strategy. Sampling strategy will decide which data
   // should be selected for human labeling in every batch.
   SampleStrategy sample_strategy = 5;
 }

protos/google/cloud/aiplatform/v1beta1/dataset.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -104,7 +104,7 @@ message ImportDataConfig {
   // considered identical if their content bytes are identical (e.g. image bytes
   // or pdf bytes).
   // These labels will be overridden by Annotation labels specified inside index
-  // file refenced by [import_schema_uri][google.cloud.aiplatform.v1beta1.ImportDataConfig.import_schema_uri], e.g. jsonl file.
+  // file referenced by [import_schema_uri][google.cloud.aiplatform.v1beta1.ImportDataConfig.import_schema_uri], e.g. jsonl file.
   map<string, string> data_item_labels = 2;
 
   // Required. Points to a YAML file stored on Google Cloud Storage describing the import

protos/google/cloud/aiplatform/v1beta1/dataset_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -358,7 +358,6 @@ message ListDataItemsResponse {
 message GetAnnotationSpecRequest {
   // Required. The name of the AnnotationSpec resource.
   // Format:
-  //
   // `projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
@@ -375,7 +374,6 @@ message GetAnnotationSpecRequest {
 message ListAnnotationsRequest {
   // Required. The resource name of the DataItem to list Annotations from.
   // Format:
-  //
   // `projects/{project}/locations/{location}/datasets/{dataset}/dataItems/{data_item}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,

protos/google/cloud/aiplatform/v1beta1/deployed_model_ref.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

protos/google/cloud/aiplatform/v1beta1/encryption_spec.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

protos/google/cloud/aiplatform/v1beta1/endpoint.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -108,7 +108,7 @@ message DeployedModel {
   // Output only. The ID of the DeployedModel.
   string id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Required. The name of the Model this is the deployment of. Note that the Model
+  // Required. The name of the Model that this is the deployment of. Note that the Model
   // may be in a different location than the DeployedModel's Endpoint.
   string model = 2 [
     (google.api.field_behavior) = REQUIRED,
@@ -130,9 +130,9 @@ message DeployedModel {
   // overrides the value of [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec]. All fields of
   // [explanation_spec][google.cloud.aiplatform.v1beta1.DeployedModel.explanation_spec] are optional in the request. If a field of
   // [explanation_spec][google.cloud.aiplatform.v1beta1.DeployedModel.explanation_spec] is not populated, the value of the same field of
-  // [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec] is inherited. The corresponding
-  // [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec] must be populated, otherwise explanation for
-  // this Model is not allowed.
+  // [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec] is inherited. If the corresponding
+  // [Model.explanation_spec][google.cloud.aiplatform.v1beta1.Model.explanation_spec] is not populated, all fields of the
+  // [explanation_spec][google.cloud.aiplatform.v1beta1.DeployedModel.explanation_spec] will be used for the explanation configuration.
   ExplanationSpec explanation_spec = 9;
 
   // The service account that the DeployedModel's container runs as. Specify the

protos/google/cloud/aiplatform/v1beta1/endpoint_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -192,7 +192,7 @@ message ListEndpointsResponse {
   // List of Endpoints in the requested page.
   repeated Endpoint endpoints = 1;
 
-  // A token to retrieve next page of results.
+  // A token to retrieve the next page of results.
   // Pass to [ListEndpointsRequest.page_token][google.cloud.aiplatform.v1beta1.ListEndpointsRequest.page_token] to obtain that page.
   string next_page_token = 2;
 }

protos/google/cloud/aiplatform/v1beta1/env_var.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

protos/google/cloud/aiplatform/v1beta1/explanation.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ package google.cloud.aiplatform.v1beta1;
 
 import "google/api/field_behavior.proto";
 import "google/cloud/aiplatform/v1beta1/explanation_metadata.proto";
+import "google/cloud/aiplatform/v1beta1/io.proto";
 import "google/protobuf/struct.proto";
 import "google/api/annotations.proto";
 

protos/google/cloud/aiplatform/v1beta1/explanation_metadata.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -339,7 +339,7 @@ message ExplanationMetadata {
       // outputs by their values.
       //
       // The shape of the value must be an n-dimensional array of strings. The
-      // number of dimentions must match that of the outputs to be explained.
+      // number of dimensions must match that of the outputs to be explained.
       // The [Attribution.output_display_name][google.cloud.aiplatform.v1beta1.Attribution.output_display_name] is populated by locating in the
       // mapping with [Attribution.output_index][google.cloud.aiplatform.v1beta1.Attribution.output_index].
       google.protobuf.Value index_display_name_mapping = 1;
@@ -377,8 +377,8 @@ message ExplanationMetadata {
 
   // Required. Map from output names to output metadata.
   //
-  // For AI Platform provided Tensorflow images, keys can be any string user
-  // defines.
+  // For AI Platform provided Tensorflow images, keys can be any user defined
+  // string that consists of any UTF-8 characters.
   //
   // For custom images, keys are the name of the output field in the prediction
   // to be explained.

protos/google/cloud/aiplatform/v1beta1/hyperparameter_tuning_job.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

protos/google/cloud/aiplatform/v1beta1/io.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -53,9 +53,9 @@ message BigQuerySource {
 message BigQueryDestination {
   // Required. BigQuery URI to a project or table, up to 2000 characters long.
   //
-  // When only project is specified, Dataset and Table is created.
-  // When full table reference is specified, Dataset must exist and table must
-  // not exist.
+  // When only the project is specified, the Dataset and Table is created.
+  // When the full table reference is specified, the Dataset must exist and
+  // table must not exist.
   //
   // Accepted forms:
   //
@@ -64,7 +64,7 @@ message BigQueryDestination {
   string output_uri = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The Container Regsitry location for the container image.
+// The Container Registry location for the container image.
 message ContainerRegistryDestination {
   // Required. Container Registry URI of a container image.
   // Only Google Container Registry and Artifact Registry are supported now.