feat: [workstations] add output field for the control plane IP address (#9422)

- [ ] Regenerate this pull request now.

feat: add output field for the number of pooled instances
docs: adjust documentation wording

PiperOrigin-RevId: 530727488

Source-Link: https://togithub.com/googleapis/googleapis/commit/866228ea605fcf8bb76b934ae93d12c5fff85587

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/53444d0dd83d81e11cc1ae1d657135e183eae8dc
Copy-Tag: eyJwIjoiamF2YS13b3Jrc3RhdGlvbnMvLk93bEJvdC55YW1sIiwiaCI6IjUzNDQ0ZDBkZDgzZDgxZTExY2MxYWUxZDY1NzEzNWUxODNlYWU4ZGMifQ==

Author: gcf-owl-bot[bot]

java-workstations/README.md

@@ -23,7 +23,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.12.0</version>
+      <version>26.14.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -201,7 +201,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/java-workstations/java11.html
 [stability-image]: https://img.shields.io/badge/stability-preview-yellow
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-workstations.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-workstations/0.2.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-workstations/0.4.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-workstations/google-cloud-workstations/src/main/java/com/google/cloud/workstations/v1/WorkstationsClient.java

@@ -1096,7 +1096,7 @@ public final WorkstationConfig getWorkstationConfig(GetWorkstationConfigRequest
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all WorkstationConfigs in the specified cluster.
+   * Returns all workstation configurations in the specified cluster.
    *
    * <p>Sample code:
    *
@@ -1130,7 +1130,7 @@ public final ListWorkstationConfigsPagedResponse listWorkstationConfigs(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all WorkstationConfigs in the specified cluster.
+   * Returns all workstation configurations in the specified cluster.
    *
    * <p>Sample code:
    *
@@ -1161,7 +1161,7 @@ public final ListWorkstationConfigsPagedResponse listWorkstationConfigs(String p
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all WorkstationConfigs in the specified cluster.
+   * Returns all workstation configurations in the specified cluster.
    *
    * <p>Sample code:
    *
@@ -1197,7 +1197,7 @@ public final ListWorkstationConfigsPagedResponse listWorkstationConfigs(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all WorkstationConfigs in the specified cluster.
+   * Returns all workstation configurations in the specified cluster.
    *
    * <p>Sample code:
    *
@@ -1232,7 +1232,7 @@ public final ListWorkstationConfigsPagedResponse listWorkstationConfigs(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all WorkstationConfigs in the specified cluster.
+   * Returns all workstation configurations in the specified cluster.
    *
    * <p>Sample code:
    *
@@ -1484,7 +1484,7 @@ public final ListUsableWorkstationConfigsPagedResponse listUsableWorkstationConf
    *
    * @param parent Required. Parent resource name.
    * @param workstationConfig Required. Config to create.
-   * @param workstationConfigId Required. ID to use for the config.
+   * @param workstationConfigId Required. ID to use for the workstation configuration.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<WorkstationConfig, OperationMetadata> createWorkstationConfigAsync(
@@ -1526,7 +1526,7 @@ public final OperationFuture<WorkstationConfig, OperationMetadata> createWorksta
    *
    * @param parent Required. Parent resource name.
    * @param workstationConfig Required. Config to create.
-   * @param workstationConfigId Required. ID to use for the config.
+   * @param workstationConfigId Required. ID to use for the workstation configuration.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<WorkstationConfig, OperationMetadata> createWorkstationConfigAsync(
@@ -1664,7 +1664,8 @@ public final OperationFuture<WorkstationConfig, OperationMetadata> createWorksta
    * }</pre>
    *
    * @param workstationConfig Required. Config to update.
-   * @param updateMask Required. Mask specifying which fields in the config should be updated.
+   * @param updateMask Required. Mask specifying which fields in the workstation configuration
+   *     should be updated.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<WorkstationConfig, OperationMetadata> updateWorkstationConfigAsync(
@@ -1794,7 +1795,7 @@ public final OperationFuture<WorkstationConfig, OperationMetadata> updateWorksta
    * }
    * }</pre>
    *
-   * @param name Required. Name of the config to delete.
+   * @param name Required. Name of the workstation configuration to delete.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<WorkstationConfig, OperationMetadata> deleteWorkstationConfigAsync(
@@ -1827,7 +1828,7 @@ public final OperationFuture<WorkstationConfig, OperationMetadata> deleteWorksta
    * }
    * }</pre>
    *
-   * @param name Required. Name of the config to delete.
+   * @param name Required. Name of the workstation configuration to delete.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<WorkstationConfig, OperationMetadata> deleteWorkstationConfigAsync(
@@ -2090,7 +2091,7 @@ public final UnaryCallable<GetWorkstationRequest, Workstation> getWorkstationCal
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config.
+   * Returns all Workstations using the specified workstation configuration.
    *
    * <p>Sample code:
    *
@@ -2123,7 +2124,7 @@ public final ListWorkstationsPagedResponse listWorkstations(WorkstationConfigNam
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config.
+   * Returns all Workstations using the specified workstation configuration.
    *
    * <p>Sample code:
    *
@@ -2155,7 +2156,7 @@ public final ListWorkstationsPagedResponse listWorkstations(String parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config.
+   * Returns all Workstations using the specified workstation configuration.
    *
    * <p>Sample code:
    *
@@ -2193,7 +2194,7 @@ public final ListWorkstationsPagedResponse listWorkstations(ListWorkstationsRequ
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config.
+   * Returns all Workstations using the specified workstation configuration.
    *
    * <p>Sample code:
    *
@@ -2232,7 +2233,7 @@ public final ListWorkstationsPagedResponse listWorkstations(ListWorkstationsRequ
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config.
+   * Returns all Workstations using the specified workstation configuration.
    *
    * <p>Sample code:
    *
@@ -2278,8 +2279,8 @@ public final ListWorkstationsPagedResponse listWorkstations(ListWorkstationsRequ
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config on which the caller has the
-   * "workstations.workstations.use" permission.
+   * Returns all workstations using the specified workstation configuration on which the caller has
+   * the "workstations.workstations.use" permission.
    *
    * <p>Sample code:
    *
@@ -2313,8 +2314,8 @@ public final ListUsableWorkstationsPagedResponse listUsableWorkstations(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config on which the caller has the
-   * "workstations.workstations.use" permission.
+   * Returns all workstations using the specified workstation configuration on which the caller has
+   * the "workstations.workstations.use" permission.
    *
    * <p>Sample code:
    *
@@ -2346,8 +2347,8 @@ public final ListUsableWorkstationsPagedResponse listUsableWorkstations(String p
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config on which the caller has the
-   * "workstations.workstations.use" permission.
+   * Returns all workstations using the specified workstation configuration on which the caller has
+   * the "workstations.workstations.use" permission.
    *
    * <p>Sample code:
    *
@@ -2386,8 +2387,8 @@ public final ListUsableWorkstationsPagedResponse listUsableWorkstations(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config on which the caller has the
-   * "workstations.workstations.use" permission.
+   * Returns all workstations using the specified workstation configuration on which the caller has
+   * the "workstations.workstations.use" permission.
    *
    * <p>Sample code:
    *
@@ -2426,8 +2427,8 @@ public final ListUsableWorkstationsPagedResponse listUsableWorkstations(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns all Workstations using the specified config on which the caller has the
-   * "workstations.workstations.use" permission.
+   * Returns all workstations using the specified workstation configuration on which the caller has
+   * the "workstations.workstations.use" permission.
    *
    * <p>Sample code:
    *
@@ -2684,7 +2685,8 @@ public final UnaryCallable<CreateWorkstationRequest, Operation> createWorkstatio
    * }</pre>
    *
    * @param workstation Required. Workstation to update.
-   * @param updateMask Required. Mask specifying which fields in the config should be updated.
+   * @param updateMask Required. Mask specifying which fields in the workstation configuration
+   *     should be updated.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final OperationFuture<Workstation, OperationMetadata> updateWorkstationAsync(

java-workstations/google-cloud-workstations/src/test/java/com/google/cloud/workstations/v1/WorkstationsClientHttpJsonTest.java

@@ -115,6 +115,7 @@ public void getWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -177,6 +178,7 @@ public void getWorkstationClusterTest2() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -339,6 +341,7 @@ public void createWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -411,6 +414,7 @@ public void createWorkstationClusterTest2() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -483,6 +487,7 @@ public void updateWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -511,6 +516,7 @@ public void updateWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -560,6 +566,7 @@ public void updateWorkstationClusterExceptionTest() throws Exception {
               .setEtag("etag3123477")
               .setNetwork("network1843485230")
               .setSubnetwork("subnetwork-1302785042")
+              .setControlPlaneIp("controlPlaneIp-1263362938")
               .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
               .setDegraded(true)
               .addAllConditions(new ArrayList<Status>())
@@ -589,6 +596,7 @@ public void deleteWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -656,6 +664,7 @@ public void deleteWorkstationClusterTest2() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())

java-workstations/google-cloud-workstations/src/test/java/com/google/cloud/workstations/v1/WorkstationsClientTest.java

@@ -124,6 +124,7 @@ public void getWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -181,6 +182,7 @@ public void getWorkstationClusterTest2() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -326,6 +328,7 @@ public void createWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -398,6 +401,7 @@ public void createWorkstationClusterTest2() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -470,6 +474,7 @@ public void updateWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -537,6 +542,7 @@ public void deleteWorkstationClusterTest() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())
@@ -602,6 +608,7 @@ public void deleteWorkstationClusterTest2() throws Exception {
             .setEtag("etag3123477")
             .setNetwork("network1843485230")
             .setSubnetwork("subnetwork-1302785042")
+            .setControlPlaneIp("controlPlaneIp-1263362938")
             .setPrivateClusterConfig(WorkstationCluster.PrivateClusterConfig.newBuilder().build())
             .setDegraded(true)
             .addAllConditions(new ArrayList<Status>())