docs: Fix formatting of request arg in docstring (#359)

gcf-owl-bot[bot] · web-flow · commit d10ac7e8db4d · 2023-03-23T09:44:04.000-04:00
* docs: Fix formatting of request arg in docstring chore: Update gapic-generator-python to v1.9.1 PiperOrigin-RevId: 518604533 Source-Link: googleapis/googleapis@8a085ae Source-Link: https://github.com/googleapis/googleapis-gen/commit/b2ab4b0a0ae2907e812c209198a74e0898afcb04 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjJhYjRiMGEwYWUyOTA3ZTgxMmMyMDkxOThhNzRlMDg5OGFmY2IwNCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/google/cloud/container_v1/services/cluster_manager/async_client.py b/google/cloud/container_v1/services/cluster_manager/async_client.py
@@ -2616,11 +2616,11 @@ async def sample_get_json_web_keys():
 
         Args:
             request (Optional[Union[google.cloud.container_v1.types.GetJSONWebKeysRequest, dict]]):
-                The request object. GetJSONWebKeysRequest gets the
-                public component of the keys used by the cluster to sign
-                token requests. This will be the jwks_uri for the
-                discover document returned by getOpenIDConfig. See the
-                OpenID Connect Discovery 1.0 specification for details.
+                The request object. GetJSONWebKeysRequest gets the public component of the
+                keys used by the cluster to sign token requests. This
+                will be the jwks_uri for the discover document returned
+                by getOpenIDConfig. See the OpenID Connect Discovery 1.0
+                specification for details.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3325,7 +3325,8 @@ async def sample_complete_node_pool_upgrade():
         Args:
             request (Optional[Union[google.cloud.container_v1.types.CompleteNodePoolUpgradeRequest, dict]]):
                 The request object. CompleteNodePoolUpgradeRequest sets
-                the name of target node pool to complete upgrade.
+                the name of target node pool to complete
+                upgrade.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3404,9 +3405,10 @@ async def sample_rollback_node_pool_upgrade():
         Args:
             request (Optional[Union[google.cloud.container_v1.types.RollbackNodePoolUpgradeRequest, dict]]):
                 The request object. RollbackNodePoolUpgradeRequest
-                rollbacks the previously Aborted or Failed NodePool
-                upgrade. This will be an no-op if the last upgrade
-                successfully completed.
+                rollbacks the previously Aborted or
+                Failed NodePool upgrade. This will be an
+                no-op if the last upgrade successfully
+                completed.
             project_id (:class:`str`):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -3556,8 +3558,9 @@ async def sample_set_node_pool_management():
 
         Args:
             request (Optional[Union[google.cloud.container_v1.types.SetNodePoolManagementRequest, dict]]):
-                The request object. SetNodePoolManagementRequest sets
-                the node management properties of a node pool.
+                The request object. SetNodePoolManagementRequest sets the
+                node management properties of a node
+                pool.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3639,9 +3642,10 @@ async def sample_set_labels():
         Args:
             request (Optional[Union[google.cloud.container_v1.types.SetLabelsRequest, dict]]):
                 The request object. SetLabelsRequest sets the Google
-                Cloud Platform labels on a Google Container Engine
-                cluster, which will in turn set them for Google Compute
-                Engine resources used by that cluster
+                Cloud Platform labels on a Google
+                Container Engine cluster, which will in
+                turn set them for Google Compute Engine
+                resources used by that cluster
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3729,7 +3733,8 @@ async def sample_set_legacy_abac():
         Args:
             request (Optional[Union[google.cloud.container_v1.types.SetLegacyAbacRequest, dict]]):
                 The request object. SetLegacyAbacRequest enables or
-                disables the ABAC authorization mechanism for a cluster.
+                disables the ABAC authorization
+                mechanism for a cluster.
             project_id (:class:`str`):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -3879,8 +3884,9 @@ async def sample_start_ip_rotation():
         Args:
             request (Optional[Union[google.cloud.container_v1.types.StartIPRotationRequest, dict]]):
                 The request object. StartIPRotationRequest creates a new
-                IP for the cluster and then performs a node upgrade on
-                each node pool to point to the new IP.
+                IP for the cluster and then performs a
+                node upgrade on each node pool to point
+                to the new IP.
             project_id (:class:`str`):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -4248,7 +4254,8 @@ async def sample_set_network_policy():
         Args:
             request (Optional[Union[google.cloud.container_v1.types.SetNetworkPolicyRequest, dict]]):
                 The request object. SetNetworkPolicyRequest
-                enables/disables network policy for a cluster.
+                enables/disables network policy for a
+                cluster.
             project_id (:class:`str`):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -4550,9 +4557,9 @@ async def sample_list_usable_subnetworks():
 
         Args:
             request (Optional[Union[google.cloud.container_v1.types.ListUsableSubnetworksRequest, dict]]):
-                The request object. ListUsableSubnetworksRequest
-                requests the list of usable subnetworks available to a
-                user for creating clusters.
+                The request object. ListUsableSubnetworksRequest requests
+                the list of usable subnetworks available
+                to a user for creating clusters.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
diff --git a/google/cloud/container_v1/services/cluster_manager/client.py b/google/cloud/container_v1/services/cluster_manager/client.py
@@ -2783,11 +2783,11 @@ def sample_get_json_web_keys():
 
         Args:
             request (Union[google.cloud.container_v1.types.GetJSONWebKeysRequest, dict]):
-                The request object. GetJSONWebKeysRequest gets the
-                public component of the keys used by the cluster to sign
-                token requests. This will be the jwks_uri for the
-                discover document returned by getOpenIDConfig. See the
-                OpenID Connect Discovery 1.0 specification for details.
+                The request object. GetJSONWebKeysRequest gets the public component of the
+                keys used by the cluster to sign token requests. This
+                will be the jwks_uri for the discover document returned
+                by getOpenIDConfig. See the OpenID Connect Discovery 1.0
+                specification for details.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3463,7 +3463,8 @@ def sample_complete_node_pool_upgrade():
         Args:
             request (Union[google.cloud.container_v1.types.CompleteNodePoolUpgradeRequest, dict]):
                 The request object. CompleteNodePoolUpgradeRequest sets
-                the name of target node pool to complete upgrade.
+                the name of target node pool to complete
+                upgrade.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3545,9 +3546,10 @@ def sample_rollback_node_pool_upgrade():
         Args:
             request (Union[google.cloud.container_v1.types.RollbackNodePoolUpgradeRequest, dict]):
                 The request object. RollbackNodePoolUpgradeRequest
-                rollbacks the previously Aborted or Failed NodePool
-                upgrade. This will be an no-op if the last upgrade
-                successfully completed.
+                rollbacks the previously Aborted or
+                Failed NodePool upgrade. This will be an
+                no-op if the last upgrade successfully
+                completed.
             project_id (str):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -3699,8 +3701,9 @@ def sample_set_node_pool_management():
 
         Args:
             request (Union[google.cloud.container_v1.types.SetNodePoolManagementRequest, dict]):
-                The request object. SetNodePoolManagementRequest sets
-                the node management properties of a node pool.
+                The request object. SetNodePoolManagementRequest sets the
+                node management properties of a node
+                pool.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3783,9 +3786,10 @@ def sample_set_labels():
         Args:
             request (Union[google.cloud.container_v1.types.SetLabelsRequest, dict]):
                 The request object. SetLabelsRequest sets the Google
-                Cloud Platform labels on a Google Container Engine
-                cluster, which will in turn set them for Google Compute
-                Engine resources used by that cluster
+                Cloud Platform labels on a Google
+                Container Engine cluster, which will in
+                turn set them for Google Compute Engine
+                resources used by that cluster
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3874,7 +3878,8 @@ def sample_set_legacy_abac():
         Args:
             request (Union[google.cloud.container_v1.types.SetLegacyAbacRequest, dict]):
                 The request object. SetLegacyAbacRequest enables or
-                disables the ABAC authorization mechanism for a cluster.
+                disables the ABAC authorization
+                mechanism for a cluster.
             project_id (str):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -4024,8 +4029,9 @@ def sample_start_ip_rotation():
         Args:
             request (Union[google.cloud.container_v1.types.StartIPRotationRequest, dict]):
                 The request object. StartIPRotationRequest creates a new
-                IP for the cluster and then performs a node upgrade on
-                each node pool to point to the new IP.
+                IP for the cluster and then performs a
+                node upgrade on each node pool to point
+                to the new IP.
             project_id (str):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -4394,7 +4400,8 @@ def sample_set_network_policy():
         Args:
             request (Union[google.cloud.container_v1.types.SetNetworkPolicyRequest, dict]):
                 The request object. SetNetworkPolicyRequest
-                enables/disables network policy for a cluster.
+                enables/disables network policy for a
+                cluster.
             project_id (str):
                 Deprecated. The Google Developers Console `project ID or
                 project
@@ -4696,9 +4703,9 @@ def sample_list_usable_subnetworks():
 
         Args:
             request (Union[google.cloud.container_v1.types.ListUsableSubnetworksRequest, dict]):
-                The request object. ListUsableSubnetworksRequest
-                requests the list of usable subnetworks available to a
-                user for creating clusters.
+                The request object. ListUsableSubnetworksRequest requests
+                the list of usable subnetworks available
+                to a user for creating clusters.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
diff --git a/google/cloud/container_v1beta1/services/cluster_manager/async_client.py b/google/cloud/container_v1beta1/services/cluster_manager/async_client.py
@@ -818,8 +818,8 @@ async def sample_update_node_pool():
 
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.UpdateNodePoolRequest, dict]]):
-                The request object. SetNodePoolVersionRequest updates
-                the version of a node pool.
+                The request object. SetNodePoolVersionRequest updates the
+                version of a node pool.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -2532,11 +2532,11 @@ async def sample_get_json_web_keys():
 
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.GetJSONWebKeysRequest, dict]]):
-                The request object. GetJSONWebKeysRequest gets the
-                public component of the keys used by the cluster to sign
-                token requests. This will be the jwks_uri for the
-                discover document returned by getOpenIDConfig. See the
-                OpenID Connect Discovery 1.0 specification for details.
+                The request object. GetJSONWebKeysRequest gets the public component of the
+                keys used by the cluster to sign token requests. This
+                will be the jwks_uri for the discover document returned
+                by getOpenIDConfig. See the OpenID Connect Discovery 1.0
+                specification for details.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3249,7 +3249,8 @@ async def sample_complete_node_pool_upgrade():
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.CompleteNodePoolUpgradeRequest, dict]]):
                 The request object. CompleteNodePoolUpgradeRequest sets
-                the name of target node pool to complete upgrade.
+                the name of target node pool to complete
+                upgrade.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -3331,9 +3332,10 @@ async def sample_rollback_node_pool_upgrade():
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.RollbackNodePoolUpgradeRequest, dict]]):
                 The request object. RollbackNodePoolUpgradeRequest
-                rollbacks the previously Aborted or Failed NodePool
-                upgrade. This will be an no-op if the last upgrade
-                successfully completed.
+                rollbacks the previously Aborted or
+                Failed NodePool upgrade. This will be an
+                no-op if the last upgrade successfully
+                completed.
             project_id (:class:`str`):
                 Required. Deprecated. The Google Developers Console
                 `project ID or project
@@ -3482,8 +3484,9 @@ async def sample_set_node_pool_management():
 
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.SetNodePoolManagementRequest, dict]]):
-                The request object. SetNodePoolManagementRequest sets
-                the node management properties of a node pool.
+                The request object. SetNodePoolManagementRequest sets the
+                node management properties of a node
+                pool.
             project_id (:class:`str`):
                 Required. Deprecated. The Google Developers Console
                 `project ID or project
@@ -3642,9 +3645,10 @@ async def sample_set_labels():
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.SetLabelsRequest, dict]]):
                 The request object. SetLabelsRequest sets the Google
-                Cloud Platform labels on a Google Container Engine
-                cluster, which will in turn set them for Google Compute
-                Engine resources used by that cluster
+                Cloud Platform labels on a Google
+                Container Engine cluster, which will in
+                turn set them for Google Compute Engine
+                resources used by that cluster
             project_id (:class:`str`):
                 Required. Deprecated. The Google Developers Console
                 `project ID or project
@@ -3807,7 +3811,8 @@ async def sample_set_legacy_abac():
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.SetLegacyAbacRequest, dict]]):
                 The request object. SetLegacyAbacRequest enables or
-                disables the ABAC authorization mechanism for a cluster.
+                disables the ABAC authorization
+                mechanism for a cluster.
             project_id (:class:`str`):
                 Required. Deprecated. The Google Developers Console
                 `project ID or project
@@ -3950,8 +3955,9 @@ async def sample_start_ip_rotation():
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.StartIPRotationRequest, dict]]):
                 The request object. StartIPRotationRequest creates a new
-                IP for the cluster and then performs a node upgrade on
-                each node pool to point to the new IP.
+                IP for the cluster and then performs a
+                node upgrade on each node pool to point
+                to the new IP.
             project_id (:class:`str`):
                 Required. Deprecated. The Google Developers Console
                 `project ID or project
@@ -4309,7 +4315,8 @@ async def sample_set_network_policy():
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.SetNetworkPolicyRequest, dict]]):
                 The request object. SetNetworkPolicyRequest
-                enables/disables network policy for a cluster.
+                enables/disables network policy for a
+                cluster.
             project_id (:class:`str`):
                 Required. Deprecated. The Google Developers Console
                 `project ID or project
@@ -4591,9 +4598,10 @@ async def sample_list_usable_subnetworks():
 
         Args:
             request (Optional[Union[google.cloud.container_v1beta1.types.ListUsableSubnetworksRequest, dict]]):
-                The request object. ListUsableSubnetworksRequest
-                requests the list of usable subnetworks. available to a
-                user for creating clusters.
+                The request object. ListUsableSubnetworksRequest requests
+                the list of usable subnetworks.
+                available to a user for creating
+                clusters.
             parent (:class:`str`):
                 Required. The parent project where subnetworks are
                 usable. Specified in the format ``projects/*``.
diff --git a/google/cloud/container_v1beta1/services/cluster_manager/client.py b/google/cloud/container_v1beta1/services/cluster_manager/client.py
