feat: [dataplex] new service DataTaxonomyService and related messages

java-dataplex/README.md

@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-dataplex.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataplex/1.19.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-dataplex/1.20.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataScanServiceClient.java

@@ -1275,6 +1275,7 @@ public final ListDataScanJobsPagedResponse listDataScanJobs(String parent) {
    *           .setParent(DataScanName.of("[PROJECT]", "[LOCATION]", "[DATASCAN]").toString())
    *           .setPageSize(883849137)
    *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
    *           .build();
    *   for (DataScanJob element : dataScanServiceClient.listDataScanJobs(request).iterateAll()) {
    *     // doThingsWith(element);
@@ -1307,6 +1308,7 @@ public final ListDataScanJobsPagedResponse listDataScanJobs(ListDataScanJobsRequ
    *           .setParent(DataScanName.of("[PROJECT]", "[LOCATION]", "[DATASCAN]").toString())
    *           .setPageSize(883849137)
    *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
    *           .build();
    *   ApiFuture<DataScanJob> future =
    *       dataScanServiceClient.listDataScanJobsPagedCallable().futureCall(request);
@@ -1340,6 +1342,7 @@ public final ListDataScanJobsPagedResponse listDataScanJobs(ListDataScanJobsRequ
    *           .setParent(DataScanName.of("[PROJECT]", "[LOCATION]", "[DATASCAN]").toString())
    *           .setPageSize(883849137)
    *           .setPageToken("pageToken873572522")
+   *           .setFilter("filter-1274492040")
    *           .build();
    *   while (true) {
    *     ListDataScanJobsResponse response =

java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/DataplexServiceClient.java

@@ -3832,6 +3832,8 @@ public final RunTaskResponse runTask(String name) {
    *   RunTaskRequest request =
    *       RunTaskRequest.newBuilder()
    *           .setName(TaskName.of("[PROJECT]", "[LOCATION]", "[LAKE]", "[TASK]").toString())
+   *           .putAllLabels(new HashMap<String, String>())
+   *           .putAllArgs(new HashMap<String, String>())
    *           .build();
    *   RunTaskResponse response = dataplexServiceClient.runTask(request);
    * }
@@ -3860,6 +3862,8 @@ public final RunTaskResponse runTask(RunTaskRequest request) {
    *   RunTaskRequest request =
    *       RunTaskRequest.newBuilder()
    *           .setName(TaskName.of("[PROJECT]", "[LOCATION]", "[LAKE]", "[TASK]").toString())
+   *           .putAllLabels(new HashMap<String, String>())
+   *           .putAllArgs(new HashMap<String, String>())
    *           .build();
    *   ApiFuture<RunTaskResponse> future =
    *       dataplexServiceClient.runTaskCallable().futureCall(request);

java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/gapic_metadata.json

@@ -44,6 +44,66 @@
         }
       }
     },
+    "DataTaxonomyService": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "DataTaxonomyServiceClient",
+          "rpcs": {
+            "CreateDataAttribute": {
+              "methods": ["createDataAttributeAsync", "createDataAttributeAsync", "createDataAttributeAsync", "createDataAttributeOperationCallable", "createDataAttributeCallable"]
+            },
+            "CreateDataAttributeBinding": {
+              "methods": ["createDataAttributeBindingAsync", "createDataAttributeBindingAsync", "createDataAttributeBindingAsync", "createDataAttributeBindingOperationCallable", "createDataAttributeBindingCallable"]
+            },
+            "CreateDataTaxonomy": {
+              "methods": ["createDataTaxonomyAsync", "createDataTaxonomyAsync", "createDataTaxonomyAsync", "createDataTaxonomyOperationCallable", "createDataTaxonomyCallable"]
+            },
+            "DeleteDataAttribute": {
+              "methods": ["deleteDataAttributeAsync", "deleteDataAttributeAsync", "deleteDataAttributeAsync", "deleteDataAttributeOperationCallable", "deleteDataAttributeCallable"]
+            },
+            "DeleteDataAttributeBinding": {
+              "methods": ["deleteDataAttributeBindingAsync", "deleteDataAttributeBindingAsync", "deleteDataAttributeBindingAsync", "deleteDataAttributeBindingOperationCallable", "deleteDataAttributeBindingCallable"]
+            },
+            "DeleteDataTaxonomy": {
+              "methods": ["deleteDataTaxonomyAsync", "deleteDataTaxonomyAsync", "deleteDataTaxonomyAsync", "deleteDataTaxonomyOperationCallable", "deleteDataTaxonomyCallable"]
+            },
+            "GetDataAttribute": {
+              "methods": ["getDataAttribute", "getDataAttribute", "getDataAttribute", "getDataAttributeCallable"]
+            },
+            "GetDataAttributeBinding": {
+              "methods": ["getDataAttributeBinding", "getDataAttributeBinding", "getDataAttributeBinding", "getDataAttributeBindingCallable"]
+            },
+            "GetDataTaxonomy": {
+              "methods": ["getDataTaxonomy", "getDataTaxonomy", "getDataTaxonomy", "getDataTaxonomyCallable"]
+            },
+            "GetLocation": {
+              "methods": ["getLocation", "getLocationCallable"]
+            },
+            "ListDataAttributeBindings": {
+              "methods": ["listDataAttributeBindings", "listDataAttributeBindings", "listDataAttributeBindings", "listDataAttributeBindingsPagedCallable", "listDataAttributeBindingsCallable"]
+            },
+            "ListDataAttributes": {
+              "methods": ["listDataAttributes", "listDataAttributes", "listDataAttributes", "listDataAttributesPagedCallable", "listDataAttributesCallable"]
+            },
+            "ListDataTaxonomies": {
+              "methods": ["listDataTaxonomies", "listDataTaxonomies", "listDataTaxonomies", "listDataTaxonomiesPagedCallable", "listDataTaxonomiesCallable"]
+            },
+            "ListLocations": {
+              "methods": ["listLocations", "listLocationsPagedCallable", "listLocationsCallable"]
+            },
+            "UpdateDataAttribute": {
+              "methods": ["updateDataAttributeAsync", "updateDataAttributeAsync", "updateDataAttributeOperationCallable", "updateDataAttributeCallable"]
+            },
+            "UpdateDataAttributeBinding": {
+              "methods": ["updateDataAttributeBindingAsync", "updateDataAttributeBindingAsync", "updateDataAttributeBindingOperationCallable", "updateDataAttributeBindingCallable"]
+            },
+            "UpdateDataTaxonomy": {
+              "methods": ["updateDataTaxonomyAsync", "updateDataTaxonomyAsync", "updateDataTaxonomyOperationCallable", "updateDataTaxonomyCallable"]
+            }
+          }
+        }
+      }
+    },
     "DataScanService": {
       "clients": {
         "grpc": {

java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/package-info.java

@@ -38,6 +38,25 @@
  * }
  * }</pre>
  *
+ * <p>======================= DataTaxonomyServiceClient =======================
+ *
+ * <p>Service Description: DataTaxonomyService enables attribute-based governance. The resources
+ * currently offered include DataTaxonomy and DataAttribute.
+ *
+ * <p>Sample for DataTaxonomyServiceClient:
+ *
+ * <pre>{@code
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+ * try (DataTaxonomyServiceClient dataTaxonomyServiceClient = DataTaxonomyServiceClient.create()) {
+ *   DataTaxonomyName name = DataTaxonomyName.of("[PROJECT]", "[LOCATION]", "[DATA_TAXONOMY_ID]");
+ *   DataTaxonomy response = dataTaxonomyServiceClient.getDataTaxonomy(name);
+ * }
+ * }</pre>
+ *
  * <p>======================= DataScanServiceClient =======================
  *
  * <p>Service Description: DataScanService manages DataScan resources which can be configured to run

java-dataplex/google-cloud-dataplex/src/main/java/com/google/cloud/dataplex/v1/stub/DataTaxonomyServiceStub.java

@@ -0,0 +1,232 @@
+/*
+ * Copyright 2023 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.dataplex.v1.stub;
+
+import static com.google.cloud.dataplex.v1.DataTaxonomyServiceClient.ListDataAttributeBindingsPagedResponse;
+import static com.google.cloud.dataplex.v1.DataTaxonomyServiceClient.ListDataAttributesPagedResponse;
+import static com.google.cloud.dataplex.v1.DataTaxonomyServiceClient.ListDataTaxonomiesPagedResponse;
+import static com.google.cloud.dataplex.v1.DataTaxonomyServiceClient.ListLocationsPagedResponse;
+
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.dataplex.v1.CreateDataAttributeBindingRequest;
+import com.google.cloud.dataplex.v1.CreateDataAttributeRequest;
+import com.google.cloud.dataplex.v1.CreateDataTaxonomyRequest;
+import com.google.cloud.dataplex.v1.DataAttribute;
+import com.google.cloud.dataplex.v1.DataAttributeBinding;
+import com.google.cloud.dataplex.v1.DataTaxonomy;
+import com.google.cloud.dataplex.v1.DeleteDataAttributeBindingRequest;
+import com.google.cloud.dataplex.v1.DeleteDataAttributeRequest;
+import com.google.cloud.dataplex.v1.DeleteDataTaxonomyRequest;
+import com.google.cloud.dataplex.v1.GetDataAttributeBindingRequest;
+import com.google.cloud.dataplex.v1.GetDataAttributeRequest;
+import com.google.cloud.dataplex.v1.GetDataTaxonomyRequest;
+import com.google.cloud.dataplex.v1.ListDataAttributeBindingsRequest;
+import com.google.cloud.dataplex.v1.ListDataAttributeBindingsResponse;
+import com.google.cloud.dataplex.v1.ListDataAttributesRequest;
+import com.google.cloud.dataplex.v1.ListDataAttributesResponse;
+import com.google.cloud.dataplex.v1.ListDataTaxonomiesRequest;
+import com.google.cloud.dataplex.v1.ListDataTaxonomiesResponse;
+import com.google.cloud.dataplex.v1.OperationMetadata;
+import com.google.cloud.dataplex.v1.UpdateDataAttributeBindingRequest;
+import com.google.cloud.dataplex.v1.UpdateDataAttributeRequest;
+import com.google.cloud.dataplex.v1.UpdateDataTaxonomyRequest;
+import com.google.cloud.location.GetLocationRequest;
+import com.google.cloud.location.ListLocationsRequest;
+import com.google.cloud.location.ListLocationsResponse;
+import com.google.cloud.location.Location;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
+import com.google.protobuf.Empty;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Base stub class for the DataTaxonomyService service API.
+ *
+ * <p>This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public abstract class DataTaxonomyServiceStub implements BackgroundResource {
+
+  public OperationsStub getOperationsStub() {
+    return null;
+  }
+
+  public com.google.api.gax.httpjson.longrunning.stub.OperationsStub getHttpJsonOperationsStub() {
+    return null;
+  }
+
+  public OperationCallable<CreateDataTaxonomyRequest, DataTaxonomy, OperationMetadata>
+      createDataTaxonomyOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: createDataTaxonomyOperationCallable()");
+  }
+
+  public UnaryCallable<CreateDataTaxonomyRequest, Operation> createDataTaxonomyCallable() {
+    throw new UnsupportedOperationException("Not implemented: createDataTaxonomyCallable()");
+  }
+
+  public OperationCallable<UpdateDataTaxonomyRequest, DataTaxonomy, OperationMetadata>
+      updateDataTaxonomyOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: updateDataTaxonomyOperationCallable()");
+  }
+
+  public UnaryCallable<UpdateDataTaxonomyRequest, Operation> updateDataTaxonomyCallable() {
+    throw new UnsupportedOperationException("Not implemented: updateDataTaxonomyCallable()");
+  }
+
+  public OperationCallable<DeleteDataTaxonomyRequest, Empty, OperationMetadata>
+      deleteDataTaxonomyOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: deleteDataTaxonomyOperationCallable()");
+  }
+
+  public UnaryCallable<DeleteDataTaxonomyRequest, Operation> deleteDataTaxonomyCallable() {
+    throw new UnsupportedOperationException("Not implemented: deleteDataTaxonomyCallable()");
+  }
+
+  public UnaryCallable<ListDataTaxonomiesRequest, ListDataTaxonomiesPagedResponse>
+      listDataTaxonomiesPagedCallable() {
+    throw new UnsupportedOperationException("Not implemented: listDataTaxonomiesPagedCallable()");
+  }
+
+  public UnaryCallable<ListDataTaxonomiesRequest, ListDataTaxonomiesResponse>
+      listDataTaxonomiesCallable() {
+    throw new UnsupportedOperationException("Not implemented: listDataTaxonomiesCallable()");
+  }
+
+  public UnaryCallable<GetDataTaxonomyRequest, DataTaxonomy> getDataTaxonomyCallable() {
+    throw new UnsupportedOperationException("Not implemented: getDataTaxonomyCallable()");
+  }
+
+  public OperationCallable<
+          CreateDataAttributeBindingRequest, DataAttributeBinding, OperationMetadata>
+      createDataAttributeBindingOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: createDataAttributeBindingOperationCallable()");
+  }
+
+  public UnaryCallable<CreateDataAttributeBindingRequest, Operation>
+      createDataAttributeBindingCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: createDataAttributeBindingCallable()");
+  }
+
+  public OperationCallable<
+          UpdateDataAttributeBindingRequest, DataAttributeBinding, OperationMetadata>
+      updateDataAttributeBindingOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: updateDataAttributeBindingOperationCallable()");
+  }
+
+  public UnaryCallable<UpdateDataAttributeBindingRequest, Operation>
+      updateDataAttributeBindingCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: updateDataAttributeBindingCallable()");
+  }
+
+  public OperationCallable<DeleteDataAttributeBindingRequest, Empty, OperationMetadata>
+      deleteDataAttributeBindingOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: deleteDataAttributeBindingOperationCallable()");
+  }
+
+  public UnaryCallable<DeleteDataAttributeBindingRequest, Operation>
+      deleteDataAttributeBindingCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: deleteDataAttributeBindingCallable()");
+  }
+
+  public UnaryCallable<ListDataAttributeBindingsRequest, ListDataAttributeBindingsPagedResponse>
+      listDataAttributeBindingsPagedCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: listDataAttributeBindingsPagedCallable()");
+  }
+
+  public UnaryCallable<ListDataAttributeBindingsRequest, ListDataAttributeBindingsResponse>
+      listDataAttributeBindingsCallable() {
+    throw new UnsupportedOperationException("Not implemented: listDataAttributeBindingsCallable()");
+  }
+
+  public UnaryCallable<GetDataAttributeBindingRequest, DataAttributeBinding>
+      getDataAttributeBindingCallable() {
+    throw new UnsupportedOperationException("Not implemented: getDataAttributeBindingCallable()");
+  }
+
+  public OperationCallable<CreateDataAttributeRequest, DataAttribute, OperationMetadata>
+      createDataAttributeOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: createDataAttributeOperationCallable()");
+  }
+
+  public UnaryCallable<CreateDataAttributeRequest, Operation> createDataAttributeCallable() {
+    throw new UnsupportedOperationException("Not implemented: createDataAttributeCallable()");
+  }
+
+  public OperationCallable<UpdateDataAttributeRequest, DataAttribute, OperationMetadata>
+      updateDataAttributeOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: updateDataAttributeOperationCallable()");
+  }
+
+  public UnaryCallable<UpdateDataAttributeRequest, Operation> updateDataAttributeCallable() {
+    throw new UnsupportedOperationException("Not implemented: updateDataAttributeCallable()");
+  }
+
+  public OperationCallable<DeleteDataAttributeRequest, Empty, OperationMetadata>
+      deleteDataAttributeOperationCallable() {
+    throw new UnsupportedOperationException(
+        "Not implemented: deleteDataAttributeOperationCallable()");
+  }
+
+  public UnaryCallable<DeleteDataAttributeRequest, Operation> deleteDataAttributeCallable() {
+    throw new UnsupportedOperationException("Not implemented: deleteDataAttributeCallable()");
+  }
+
+  public UnaryCallable<ListDataAttributesRequest, ListDataAttributesPagedResponse>
+      listDataAttributesPagedCallable() {
+    throw new UnsupportedOperationException("Not implemented: listDataAttributesPagedCallable()");
+  }
+
+  public UnaryCallable<ListDataAttributesRequest, ListDataAttributesResponse>
+      listDataAttributesCallable() {
+    throw new UnsupportedOperationException("Not implemented: listDataAttributesCallable()");
+  }
+
+  public UnaryCallable<GetDataAttributeRequest, DataAttribute> getDataAttributeCallable() {
+    throw new UnsupportedOperationException("Not implemented: getDataAttributeCallable()");
+  }
+
+  public UnaryCallable<ListLocationsRequest, ListLocationsPagedResponse>
+      listLocationsPagedCallable() {
+    throw new UnsupportedOperationException("Not implemented: listLocationsPagedCallable()");
+  }
+
+  public UnaryCallable<ListLocationsRequest, ListLocationsResponse> listLocationsCallable() {
+    throw new UnsupportedOperationException("Not implemented: listLocationsCallable()");
+  }
+
+  public UnaryCallable<GetLocationRequest, Location> getLocationCallable() {
+    throw new UnsupportedOperationException("Not implemented: getLocationCallable()");
+  }
+
+  @Override
+  public abstract void close();
+}