fix: update backup timeouts (via synth) (#82)

* [CHANGE ME] Re-generated  to pick up changes in the API or client library generator.

* remove _pb2 files and multiprocessing due to docs failures

Co-authored-by: larkee <[email protected]>

Author: yoshi-automation

.kokoro/publish-docs.sh

@@ -13,8 +13,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-#!/bin/bash
-
 set -eo pipefail
 
 # Disable buffering, so that the logs stream through.

google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py

@@ -273,11 +273,11 @@ def create_database(
         Args:
             parent (str): Required. The name of the instance that will serve the new database.
                 Values are of the form ``projects/<project>/instances/<instance>``.
-            create_statement (str): Required. A ``CREATE DATABASE`` statement, which specifies the ID of the
-                new database. The database ID must conform to the regular expression
+            create_statement (str): Required. A ``CREATE DATABASE`` statement, which specifies the ID of
+                the new database. The database ID must conform to the regular expression
                 ``[a-z][a-z0-9_\-]*[a-z0-9]`` and be between 2 and 30 characters in
                 length. If the database ID is a reserved word or if it contains a
-                hyphen, the database ID must be enclosed in backticks (`````).
+                hyphen, the database ID must be enclosed in backticks (:literal:`\``).
             extra_statements (list[str]): Optional. A list of DDL statements to run inside the newly created
                 database. Statements can create tables, indexes, etc. These
                 statements execute atomically with the creation of the database:
@@ -451,9 +451,9 @@ def update_database_ddl(
         Args:
             database (str): Required. The database to update.
             statements (list[str]): Required. DDL statements to be applied to the database.
-            operation_id (str): If empty, the new update request is assigned an automatically-generated
-                operation ID. Otherwise, ``operation_id`` is used to construct the name
-                of the resulting ``Operation``.
+            operation_id (str): If empty, the new update request is assigned an
+                automatically-generated operation ID. Otherwise, ``operation_id`` is
+                used to construct the name of the resulting ``Operation``.
 
                 Specifying an explicit operation ID simplifies determining whether the
                 statements were executed in the event that the ``UpdateDatabaseDdl``
@@ -530,8 +530,8 @@ def drop_database(
         metadata=None,
     ):
         """
-        Drops (aka deletes) a Cloud Spanner database. Completed backups for the
-        database will be retained according to their ``expire_time``.
+        Drops (aka deletes) a Cloud Spanner database. Completed backups for
+        the database will be retained according to their ``expire_time``.
 
         Example:
             >>> from google.cloud import spanner_admin_database_v1
@@ -597,9 +597,9 @@ def get_database_ddl(
         metadata=None,
     ):
         """
-        Returns the schema of a Cloud Spanner database as a list of formatted
-        DDL statements. This method does not show pending schema updates, those
-        may be queried using the ``Operations`` API.
+        Returns the schema of a Cloud Spanner database as a list of
+        formatted DDL statements. This method does not show pending schema
+        updates, those may be queried using the ``Operations`` API.
 
         Example:
             >>> from google.cloud import spanner_admin_database_v1
@@ -845,10 +845,10 @@ def test_iam_permissions(
         backup resource.
 
         Attempting this RPC on a non-existent Cloud Spanner database will result
-        in a NOT\_FOUND error if the user has ``spanner.databases.list``
+        in a NOT_FOUND error if the user has ``spanner.databases.list``
         permission on the containing Cloud Spanner instance. Otherwise returns
         an empty set of permissions. Calling this method on a backup that does
-        not exist will result in a NOT\_FOUND error if the user has
+        not exist will result in a NOT_FOUND error if the user has
         ``spanner.backups.list`` permission on the containing instance.
 
         Example:
@@ -867,8 +867,8 @@ def test_iam_permissions(
         Args:
             resource (str): REQUIRED: The resource for which the policy detail is being requested.
                 See the operation documentation for the appropriate value for this field.
-            permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with
-                wildcards (such as '*' or 'storage.*') are not allowed. For more
+            permissions (list[str]): The set of permissions to check for the ``resource``. Permissions
+                with wildcards (such as '*' or 'storage.*') are not allowed. For more
                 information see `IAM
                 Overview <https://cloud.google.com/iam/docs/overview#permissions>`__.
             retry (Optional[google.api_core.retry.Retry]):  A retry object used
@@ -966,13 +966,13 @@ def create_backup(
             >>> metadata = response.metadata()
 
         Args:
-            parent (str): Required. The name of the instance in which the backup will be created.
-                This must be the same instance that contains the database the backup
-                will be created from. The backup will be stored in the location(s)
-                specified in the instance configuration of this instance. Values are of
-                the form ``projects/<project>/instances/<instance>``.
-            backup_id (str): Required. The id of the backup to be created. The ``backup_id`` appended
-                to ``parent`` forms the full backup name of the form
+            parent (str): Required. The name of the instance in which the backup will be
+                created. This must be the same instance that contains the database the
+                backup will be created from. The backup will be stored in the
+                location(s) specified in the instance configuration of this instance.
+                Values are of the form ``projects/<project>/instances/<instance>``.
+            backup_id (str): Required. The id of the backup to be created. The ``backup_id``
+                appended to ``parent`` forms the full backup name of the form
                 ``projects/<project>/instances/<instance>/backups/<backup_id>``.
             backup (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Backup]): Required. The backup to create.
 
@@ -1129,18 +1129,18 @@ def update_backup(
             >>> response = client.update_backup(backup, update_mask)
 
         Args:
-            backup (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Backup]): Required. The backup to update. ``backup.name``, and the fields to be
-                updated as specified by ``update_mask`` are required. Other fields are
-                ignored. Update is only supported for the following fields:
+            backup (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Backup]): Required. The backup to update. ``backup.name``, and the fields to
+                be updated as specified by ``update_mask`` are required. Other fields
+                are ignored. Update is only supported for the following fields:
 
                 -  ``backup.expire_time``.
 
                 If a dict is provided, it must be of the same form as the protobuf
                 message :class:`~google.cloud.spanner_admin_database_v1.types.Backup`
-            update_mask (Union[dict, ~google.cloud.spanner_admin_database_v1.types.FieldMask]): Required. A mask specifying which fields (e.g. ``expire_time``) in the
-                Backup resource should be updated. This mask is relative to the Backup
-                resource, not to the request message. The field mask must always be
-                specified; this prevents any future fields from being erased
+            update_mask (Union[dict, ~google.cloud.spanner_admin_database_v1.types.FieldMask]): Required. A mask specifying which fields (e.g. ``expire_time``) in
+                the Backup resource should be updated. This mask is relative to the
+                Backup resource, not to the request message. The field mask must always
+                be specified; this prevents any future fields from being erased
                 accidentally by clients that do not know about them.
 
                 If a dict is provided, it must be of the same form as the protobuf
@@ -1450,9 +1450,9 @@ def restore_database(
                 database. This instance must be in the same project and have the same
                 instance configuration as the instance containing the source backup.
                 Values are of the form ``projects/<project>/instances/<instance>``.
-            database_id (str): Required. The id of the database to create and restore to. This database
-                must not already exist. The ``database_id`` appended to ``parent`` forms
-                the full database name of the form
+            database_id (str): Required. The id of the database to create and restore to. This
+                database must not already exist. The ``database_id`` appended to
+                ``parent`` forms the full database name of the form
                 ``projects/<project>/instances/<instance>/databases/<database_id>``.
             backup (str): Name of the backup from which to restore. Values are of the form
                 ``projects/<project>/instances/<instance>/backups/<backup>``.
@@ -1526,8 +1526,8 @@ def list_database_operations(
         metadata=None,
     ):
         """
-        Lists database ``longrunning-operations``. A database operation has a
-        name of the form
+        Lists database ``longrunning-operations``. A database operation has
+        a name of the form
         ``projects/<project>/instances/<instance>/databases/<database>/operations/<operation>``.
         The long-running operation ``metadata`` field type ``metadata.type_url``
         describes the type of the metadata. Operations returned include those
@@ -1594,8 +1594,8 @@ def list_database_operations(
 
                    -  The operation's metadata type is ``RestoreDatabaseMetadata``.
                    -  The database is restored from a backup.
-                   -  The backup name contains "backup\_howl".
-                   -  The restored database's name contains "restored\_howl".
+                   -  The backup name contains "backup_howl".
+                   -  The restored database's name contains "restored_howl".
                    -  The operation started before 2018-03-28T14:50:00Z.
                    -  The operation resulted in an error.
             page_size (int): The maximum number of resources contained in the
@@ -1677,8 +1677,8 @@ def list_backup_operations(
         metadata=None,
     ):
         """
-        Lists the backup ``long-running operations`` in the given instance. A
-        backup operation has a name of the form
+        Lists the backup ``long-running operations`` in the given instance.
+        A backup operation has a name of the form
         ``projects/<project>/instances/<instance>/backups/<backup>/operations/<operation>``.
         The long-running operation ``metadata`` field type ``metadata.type_url``
         describes the type of the metadata. Operations returned include those
@@ -1709,8 +1709,8 @@ def list_backup_operations(
             ...         pass
 
         Args:
-            parent (str): Required. The instance of the backup operations. Values are of the form
-                ``projects/<project>/instances/<instance>``.
+            parent (str): Required. The instance of the backup operations. Values are of the
+                form ``projects/<project>/instances/<instance>``.
             filter_ (str): An expression that filters the list of returned backup operations.
 
                 A filter expression consists of a field name, a comparison operator, and
@@ -1851,8 +1851,8 @@ def list_databases(
             ...         pass
 
         Args:
-            parent (str): Required. The instance whose databases should be listed. Values are of
-                the form ``projects/<project>/instances/<instance>``.
+            parent (str): Required. The instance whose databases should be listed. Values are
+                of the form ``projects/<project>/instances/<instance>``.
             page_size (int): The maximum number of resources contained in the
                 underlying API response. If page streaming is performed per-
                 resource, this parameter does not affect the return value. If page

google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py

@@ -63,12 +63,12 @@
                     "retry_params_name": "default",
                 },
                 "GetBackup": {
-                    "timeout_millis": 30000,
+                    "timeout_millis": 600000,
                     "retry_codes_name": "idempotent",
                     "retry_params_name": "default",
                 },
                 "UpdateBackup": {
-                    "timeout_millis": 30000,
+                    "timeout_millis": 600000,
                     "retry_codes_name": "non_idempotent",
                     "retry_params_name": "default",
                 },
@@ -78,7 +78,7 @@
                     "retry_params_name": "default",
                 },
                 "ListBackups": {
-                    "timeout_millis": 30000,
+                    "timeout_millis": 600000,
                     "retry_codes_name": "idempotent",
                     "retry_params_name": "default",
                 },
@@ -88,12 +88,12 @@
                     "retry_params_name": "default",
                 },
                 "ListDatabaseOperations": {
-                    "timeout_millis": 30000,
+                    "timeout_millis": 600000,
                     "retry_codes_name": "idempotent",
                     "retry_params_name": "default",
                 },
                 "ListBackupOperations": {
-                    "timeout_millis": 30000,
+                    "timeout_millis": 600000,
                     "retry_codes_name": "idempotent",
                     "retry_params_name": "default",
                 },

google/cloud/spanner_admin_database_v1/gapic/enums.py

@@ -39,8 +39,8 @@ class State(enum.IntEnum):
 
         Attributes:
           STATE_UNSPECIFIED (int): Not specified.
-          CREATING (int): The pending backup is still being created. Operations on the backup may
-          fail with ``FAILED_PRECONDITION`` in this state.
+          CREATING (int): The pending backup is still being created. Operations on the backup
+          may fail with ``FAILED_PRECONDITION`` in this state.
           READY (int): The backup is complete and ready for use.
         """
 
@@ -56,8 +56,8 @@ class State(enum.IntEnum):
 
         Attributes:
           STATE_UNSPECIFIED (int): Not specified.
-          CREATING (int): The database is still being created. Operations on the database may fail
-          with ``FAILED_PRECONDITION`` in this state.
+          CREATING (int): The database is still being created. Operations on the database may
+          fail with ``FAILED_PRECONDITION`` in this state.
           READY (int): The database is fully created and ready for use.
           READY_OPTIMIZING (int): The database is fully created and ready for use, but is still being
           optimized for performance and cannot handle full load.

google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py

@@ -173,8 +173,8 @@ def update_database_ddl(self):
     def drop_database(self):
         """Return the gRPC stub for :meth:`DatabaseAdminClient.drop_database`.
 
-        Drops (aka deletes) a Cloud Spanner database. Completed backups for the
-        database will be retained according to their ``expire_time``.
+        Drops (aka deletes) a Cloud Spanner database. Completed backups for
+        the database will be retained according to their ``expire_time``.
 
         Returns:
             Callable: A callable which accepts the appropriate
@@ -187,9 +187,9 @@ def drop_database(self):
     def get_database_ddl(self):
         """Return the gRPC stub for :meth:`DatabaseAdminClient.get_database_ddl`.
 
-        Returns the schema of a Cloud Spanner database as a list of formatted
-        DDL statements. This method does not show pending schema updates, those
-        may be queried using the ``Operations`` API.
+        Returns the schema of a Cloud Spanner database as a list of
+        formatted DDL statements. This method does not show pending schema
+        updates, those may be queried using the ``Operations`` API.
 
         Returns:
             Callable: A callable which accepts the appropriate
@@ -243,10 +243,10 @@ def test_iam_permissions(self):
         backup resource.
 
         Attempting this RPC on a non-existent Cloud Spanner database will result
-        in a NOT\_FOUND error if the user has ``spanner.databases.list``
+        in a NOT_FOUND error if the user has ``spanner.databases.list``
         permission on the containing Cloud Spanner instance. Otherwise returns
         an empty set of permissions. Calling this method on a backup that does
-        not exist will result in a NOT\_FOUND error if the user has
+        not exist will result in a NOT_FOUND error if the user has
         ``spanner.backups.list`` permission on the containing instance.
 
         Returns:
@@ -360,8 +360,8 @@ def restore_database(self):
     def list_database_operations(self):
         """Return the gRPC stub for :meth:`DatabaseAdminClient.list_database_operations`.
 
-        Lists database ``longrunning-operations``. A database operation has a
-        name of the form
+        Lists database ``longrunning-operations``. A database operation has
+        a name of the form
         ``projects/<project>/instances/<instance>/databases/<database>/operations/<operation>``.
         The long-running operation ``metadata`` field type ``metadata.type_url``
         describes the type of the metadata. Operations returned include those
@@ -379,8 +379,8 @@ def list_database_operations(self):
     def list_backup_operations(self):
         """Return the gRPC stub for :meth:`DatabaseAdminClient.list_backup_operations`.
 
-        Lists the backup ``long-running operations`` in the given instance. A
-        backup operation has a name of the form
+        Lists the backup ``long-running operations`` in the given instance.
+        A backup operation has a name of the form
         ``projects/<project>/instances/<instance>/backups/<backup>/operations/<operation>``.
         The long-running operation ``metadata`` field type ``metadata.type_url``
         describes the type of the metadata. Operations returned include those

google/cloud/spanner_admin_instance_v1/gapic/enums.py

@@ -54,7 +54,8 @@ class ReplicaType(enum.IntEnum):
           -  Can vote whether to commit a write.
           -  Participate in leadership election.
           -  Are eligible to become a leader.
-          READ_ONLY (int): Read-only replicas only support reads (not writes). Read-only replicas:
+          READ_ONLY (int): Read-only replicas only support reads (not writes). Read-only
+          replicas:
 
           -  Maintain a full copy of your data.
           -  Serve reads.