feat(workstations): update the api

#### workstations:v1beta

The following keys were added:
- schemas.WorkstationConfig.properties.maxUsableWorkstations (Total Keys: 2)

Author: yoshi-automation

docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html

@@ -131,10 +131,10 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # A workstation configuration resource in the Cloud Workstations API. Workstation configurations act as templates for workstations. The workstation configuration defines details such as the workstation virtual machine (VM) instance type, persistent storage, container image defining environment, which IDE or Code Editor to use, and more. Administrators and platform teams can also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/docs/overview) rules to grant access to teams or to individual developers.
-  &quot;allowedPorts&quot;: [ # Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.
+  &quot;allowedPorts&quot;: [ # Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.
     { # A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.
-      &quot;first&quot;: 42, # Required. Starting port number for the current range of ports.
-      &quot;last&quot;: 42, # Required. Ending port number for the current range of ports.
+      &quot;first&quot;: 42, # Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
+      &quot;last&quot;: 42, # Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
     },
   ],
   &quot;annotations&quot;: { # Optional. Client-specified annotations.
@@ -217,7 +217,7 @@ <h3>Method Details</h3>
       &quot;tags&quot;: [ # Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).
         &quot;A String&quot;,
       ],
-      &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
+      &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
         &quot;a_key&quot;: &quot;A String&quot;,
       },
     },
@@ -338,10 +338,10 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # A workstation configuration resource in the Cloud Workstations API. Workstation configurations act as templates for workstations. The workstation configuration defines details such as the workstation virtual machine (VM) instance type, persistent storage, container image defining environment, which IDE or Code Editor to use, and more. Administrators and platform teams can also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/docs/overview) rules to grant access to teams or to individual developers.
-  &quot;allowedPorts&quot;: [ # Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.
+  &quot;allowedPorts&quot;: [ # Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.
     { # A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.
-      &quot;first&quot;: 42, # Required. Starting port number for the current range of ports.
-      &quot;last&quot;: 42, # Required. Ending port number for the current range of ports.
+      &quot;first&quot;: 42, # Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
+      &quot;last&quot;: 42, # Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
     },
   ],
   &quot;annotations&quot;: { # Optional. Client-specified annotations.
@@ -424,7 +424,7 @@ <h3>Method Details</h3>
       &quot;tags&quot;: [ # Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).
         &quot;A String&quot;,
       ],
-      &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
+      &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
         &quot;a_key&quot;: &quot;A String&quot;,
       },
     },
@@ -533,10 +533,10 @@ <h3>Method Details</h3>
   ],
   &quot;workstationConfigs&quot;: [ # The requested configs.
     { # A workstation configuration resource in the Cloud Workstations API. Workstation configurations act as templates for workstations. The workstation configuration defines details such as the workstation virtual machine (VM) instance type, persistent storage, container image defining environment, which IDE or Code Editor to use, and more. Administrators and platform teams can also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/docs/overview) rules to grant access to teams or to individual developers.
-      &quot;allowedPorts&quot;: [ # Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.
+      &quot;allowedPorts&quot;: [ # Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.
         { # A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.
-          &quot;first&quot;: 42, # Required. Starting port number for the current range of ports.
-          &quot;last&quot;: 42, # Required. Ending port number for the current range of ports.
+          &quot;first&quot;: 42, # Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
+          &quot;last&quot;: 42, # Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
         },
       ],
       &quot;annotations&quot;: { # Optional. Client-specified annotations.
@@ -619,7 +619,7 @@ <h3>Method Details</h3>
           &quot;tags&quot;: [ # Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).
             &quot;A String&quot;,
           ],
-          &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
+          &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
             &quot;a_key&quot;: &quot;A String&quot;,
           },
         },
@@ -682,10 +682,10 @@ <h3>Method Details</h3>
   ],
   &quot;workstationConfigs&quot;: [ # The requested configs.
     { # A workstation configuration resource in the Cloud Workstations API. Workstation configurations act as templates for workstations. The workstation configuration defines details such as the workstation virtual machine (VM) instance type, persistent storage, container image defining environment, which IDE or Code Editor to use, and more. Administrators and platform teams can also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/docs/overview) rules to grant access to teams or to individual developers.
-      &quot;allowedPorts&quot;: [ # Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.
+      &quot;allowedPorts&quot;: [ # Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.
         { # A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.
-          &quot;first&quot;: 42, # Required. Starting port number for the current range of ports.
-          &quot;last&quot;: 42, # Required. Ending port number for the current range of ports.
+          &quot;first&quot;: 42, # Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
+          &quot;last&quot;: 42, # Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
         },
       ],
       &quot;annotations&quot;: { # Optional. Client-specified annotations.
@@ -768,7 +768,7 @@ <h3>Method Details</h3>
           &quot;tags&quot;: [ # Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).
             &quot;A String&quot;,
           ],
-          &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
+          &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
             &quot;a_key&quot;: &quot;A String&quot;,
           },
         },
@@ -846,10 +846,10 @@ <h3>Method Details</h3>
     The object takes the form of:
 
 { # A workstation configuration resource in the Cloud Workstations API. Workstation configurations act as templates for workstations. The workstation configuration defines details such as the workstation virtual machine (VM) instance type, persistent storage, container image defining environment, which IDE or Code Editor to use, and more. Administrators and platform teams can also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/docs/overview) rules to grant access to teams or to individual developers.
-  &quot;allowedPorts&quot;: [ # Optional. A Single or Range of ports externally accessible in the workstation. If not specified defaults to ports 22, 80 and ports 1024-65535.
+  &quot;allowedPorts&quot;: [ # Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535.
     { # A PortRange defines a range of ports. Both first and last are inclusive. To specify a single port, both first and last should be the same.
-      &quot;first&quot;: 42, # Required. Starting port number for the current range of ports.
-      &quot;last&quot;: 42, # Required. Ending port number for the current range of ports.
+      &quot;first&quot;: 42, # Required. Starting port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
+      &quot;last&quot;: 42, # Required. Ending port number for the current range of ports. Valid ports are 22, 80, and ports within the range 1024-65535.
     },
   ],
   &quot;annotations&quot;: { # Optional. Client-specified annotations.
@@ -932,7 +932,7 @@ <h3>Method Details</h3>
       &quot;tags&quot;: [ # Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).
         &quot;A String&quot;,
       ],
-      &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as https://cloud.google.com/resource-manager/docs/tags/tags-overview Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
+      &quot;vmTags&quot;: { # Optional. Resource manager tags to be bound to this instance. Tag keys and values have the same definition as [resource manager tags](https://cloud.google.com/resource-manager/docs/tags/tags-overview). Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`.
         &quot;a_key&quot;: &quot;A String&quot;,
       },
     },