google-cloud-spanner 3.57.0__tar.gz → 3.59.0__tar.gz

{google_cloud_spanner-3.57.0/google_cloud_spanner.egg-info → google_cloud_spanner-3.59.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-spanner
-Version: 3.57.0
+Version: 3.59.0
 Summary: Google Cloud Spanner API client library
 Home-page: https://github.com/googleapis/python-spanner
 Author: Google LLC
@@ -12,15 +12,13 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
-Requires-Python: >=3.7
+Requires-Python: >=3.9
 License-File: LICENSE
 Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.0
 Requires-Dist: google-cloud-core<3.0.0,>=1.4.4
@@ -110,14 +108,15 @@ dependencies.
 
 Supported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.7
+Python >= 3.9
 
 Deprecated Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 Python == 2.7.
 Python == 3.5.
 Python == 3.6.
-
+Python == 3.7.
+Python == 3.8.
 
 Mac/Linux
 ^^^^^^^^^

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/README.rst

@@ -56,14 +56,15 @@ dependencies.
 
 Supported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^
-Python >= 3.7
+Python >= 3.9
 
 Deprecated Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 Python == 2.7.
 Python == 3.5.
 Python == 3.6.
-
+Python == 3.7.
+Python == 3.8.
 
 Mac/Linux
 ^^^^^^^^^

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/google/cloud/spanner_admin_database_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "3.57.0"  # {x-release-please-version}
+__version__ = "3.59.0"  # {x-release-please-version}

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/google/cloud/spanner_admin_database_v1/services/database_admin/async_client.py

@@ -84,10 +84,10 @@ class DatabaseAdminAsyncClient:
 
     The Cloud Spanner Database Admin API can be used to:
 
-    -  create, drop, and list databases
-    -  update the schema of pre-existing databases
-    -  create, delete, copy and list backups for a database
-    -  restore a database from an existing backup
+    - create, drop, and list databases
+    - update the schema of pre-existing databases
+    - create, delete, copy and list backups for a database
+    - restore a database from an existing backup
     """
 
     _client: DatabaseAdminClient
@@ -749,26 +749,26 @@ class DatabaseAdminAsyncClient:
 
         While the operation is pending:
 
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field is set to true.
-        -  Cancelling the operation is best-effort. If the cancellation
-           succeeds, the operation metadata's
-           [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
-           is set, the updates are reverted, and the operation
-           terminates with a ``CANCELLED`` status.
-        -  New UpdateDatabase requests will return a
-           ``FAILED_PRECONDITION`` error until the pending operation is
-           done (returns successfully or with error).
-        -  Reading the database via the API continues to give the
-           pre-request values.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field is set to true.
+        - Cancelling the operation is best-effort. If the cancellation
+          succeeds, the operation metadata's
+          [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
+          is set, the updates are reverted, and the operation terminates
+          with a ``CANCELLED`` status.
+        - New UpdateDatabase requests will return a
+          ``FAILED_PRECONDITION`` error until the pending operation is
+          done (returns successfully or with error).
+        - Reading the database via the API continues to give the
+          pre-request values.
 
         Upon completion of the returned operation:
 
-        -  The new values are in effect and readable via the API.
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field becomes false.
+        - The new values are in effect and readable via the API.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field becomes false.
 
         The returned [long-running
         operation][google.longrunning.Operation] will have a name of the
@@ -1384,19 +1384,19 @@ class DatabaseAdminAsyncClient:
                    constraints based on attributes of the request, the
                    resource, or both. To learn which resources support
                    conditions in their IAM policies, see the [IAM
-                   documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+                   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
 
                    **JSON example:**
 
-                   :literal:`\`     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
+                   :literal:``     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
 
                    **YAML example:**
 
-                   :literal:`\`     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
+                   :literal:``     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
 
                    For a description of IAM and its features, see the
                    [IAM
-                   documentation](\ https://cloud.google.com/iam/docs/).
+                   documentation](https://cloud.google.com/iam/docs/).
 
         """
         # Create or coerce a protobuf request object.
@@ -1531,19 +1531,19 @@ class DatabaseAdminAsyncClient:
                    constraints based on attributes of the request, the
                    resource, or both. To learn which resources support
                    conditions in their IAM policies, see the [IAM
-                   documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+                   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
 
                    **JSON example:**
 
-                   :literal:`\`     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
+                   :literal:``     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
 
                    **YAML example:**
 
-                   :literal:`\`     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
+                   :literal:``     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
 
                    For a description of IAM and its features, see the
                    [IAM
-                   documentation](\ https://cloud.google.com/iam/docs/).
+                   documentation](https://cloud.google.com/iam/docs/).
 
         """
         # Create or coerce a protobuf request object.
@@ -2226,7 +2226,7 @@ class DatabaseAdminAsyncClient:
                 required. Other fields are ignored. Update is only
                 supported for the following fields:
 
-                -  ``backup.expire_time``.
+                - ``backup.expire_time``.
 
                 This corresponds to the ``backup`` field
                 on the ``request`` instance; if ``request`` is provided, this

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/google/cloud/spanner_admin_database_v1/services/database_admin/client.py

@@ -127,10 +127,10 @@ class DatabaseAdminClient(metaclass=DatabaseAdminClientMeta):
 
     The Cloud Spanner Database Admin API can be used to:
 
-    -  create, drop, and list databases
-    -  update the schema of pre-existing databases
-    -  create, delete, copy and list backups for a database
-    -  restore a database from an existing backup
+    - create, drop, and list databases
+    - update the schema of pre-existing databases
+    - create, delete, copy and list backups for a database
+    - restore a database from an existing backup
     """
 
     @staticmethod
@@ -1297,26 +1297,26 @@ class DatabaseAdminClient(metaclass=DatabaseAdminClientMeta):
 
         While the operation is pending:
 
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field is set to true.
-        -  Cancelling the operation is best-effort. If the cancellation
-           succeeds, the operation metadata's
-           [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
-           is set, the updates are reverted, and the operation
-           terminates with a ``CANCELLED`` status.
-        -  New UpdateDatabase requests will return a
-           ``FAILED_PRECONDITION`` error until the pending operation is
-           done (returns successfully or with error).
-        -  Reading the database via the API continues to give the
-           pre-request values.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field is set to true.
+        - Cancelling the operation is best-effort. If the cancellation
+          succeeds, the operation metadata's
+          [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
+          is set, the updates are reverted, and the operation terminates
+          with a ``CANCELLED`` status.
+        - New UpdateDatabase requests will return a
+          ``FAILED_PRECONDITION`` error until the pending operation is
+          done (returns successfully or with error).
+        - Reading the database via the API continues to give the
+          pre-request values.
 
         Upon completion of the returned operation:
 
-        -  The new values are in effect and readable via the API.
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field becomes false.
+        - The new values are in effect and readable via the API.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field becomes false.
 
         The returned [long-running
         operation][google.longrunning.Operation] will have a name of the
@@ -1920,19 +1920,19 @@ class DatabaseAdminClient(metaclass=DatabaseAdminClientMeta):
                    constraints based on attributes of the request, the
                    resource, or both. To learn which resources support
                    conditions in their IAM policies, see the [IAM
-                   documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+                   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
 
                    **JSON example:**
 
-                   :literal:`\`     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
+                   :literal:``     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
 
                    **YAML example:**
 
-                   :literal:`\`     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
+                   :literal:``     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
 
                    For a description of IAM and its features, see the
                    [IAM
-                   documentation](\ https://cloud.google.com/iam/docs/).
+                   documentation](https://cloud.google.com/iam/docs/).
 
         """
         # Create or coerce a protobuf request object.
@@ -2068,19 +2068,19 @@ class DatabaseAdminClient(metaclass=DatabaseAdminClientMeta):
                    constraints based on attributes of the request, the
                    resource, or both. To learn which resources support
                    conditions in their IAM policies, see the [IAM
-                   documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+                   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
 
                    **JSON example:**
 
-                   :literal:`\`     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
+                   :literal:``     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
 
                    **YAML example:**
 
-                   :literal:`\`     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
+                   :literal:``     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
 
                    For a description of IAM and its features, see the
                    [IAM
-                   documentation](\ https://cloud.google.com/iam/docs/).
+                   documentation](https://cloud.google.com/iam/docs/).
 
         """
         # Create or coerce a protobuf request object.
@@ -2756,7 +2756,7 @@ class DatabaseAdminClient(metaclass=DatabaseAdminClientMeta):
                 required. Other fields are ignored. Update is only
                 supported for the following fields:
 
-                -  ``backup.expire_time``.
+                - ``backup.expire_time``.
 
                 This corresponds to the ``backup`` field
                 on the ``request`` instance; if ``request`` is provided, this

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc.py

@@ -126,10 +126,10 @@ class DatabaseAdminGrpcTransport(DatabaseAdminTransport):
 
     The Cloud Spanner Database Admin API can be used to:
 
-    -  create, drop, and list databases
-    -  update the schema of pre-existing databases
-    -  create, delete, copy and list backups for a database
-    -  restore a database from an existing backup
+    - create, drop, and list databases
+    - update the schema of pre-existing databases
+    - create, delete, copy and list backups for a database
+    - restore a database from an existing backup
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation
@@ -464,26 +464,26 @@ class DatabaseAdminGrpcTransport(DatabaseAdminTransport):
 
         While the operation is pending:
 
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field is set to true.
-        -  Cancelling the operation is best-effort. If the cancellation
-           succeeds, the operation metadata's
-           [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
-           is set, the updates are reverted, and the operation
-           terminates with a ``CANCELLED`` status.
-        -  New UpdateDatabase requests will return a
-           ``FAILED_PRECONDITION`` error until the pending operation is
-           done (returns successfully or with error).
-        -  Reading the database via the API continues to give the
-           pre-request values.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field is set to true.
+        - Cancelling the operation is best-effort. If the cancellation
+          succeeds, the operation metadata's
+          [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
+          is set, the updates are reverted, and the operation terminates
+          with a ``CANCELLED`` status.
+        - New UpdateDatabase requests will return a
+          ``FAILED_PRECONDITION`` error until the pending operation is
+          done (returns successfully or with error).
+        - Reading the database via the API continues to give the
+          pre-request values.
 
         Upon completion of the returned operation:
 
-        -  The new values are in effect and readable via the API.
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field becomes false.
+        - The new values are in effect and readable via the API.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field becomes false.
 
         The returned [long-running
         operation][google.longrunning.Operation] will have a name of the

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc_asyncio.py

@@ -132,10 +132,10 @@ class DatabaseAdminGrpcAsyncIOTransport(DatabaseAdminTransport):
 
     The Cloud Spanner Database Admin API can be used to:
 
-    -  create, drop, and list databases
-    -  update the schema of pre-existing databases
-    -  create, delete, copy and list backups for a database
-    -  restore a database from an existing backup
+    - create, drop, and list databases
+    - update the schema of pre-existing databases
+    - create, delete, copy and list backups for a database
+    - restore a database from an existing backup
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation
@@ -475,26 +475,26 @@ class DatabaseAdminGrpcAsyncIOTransport(DatabaseAdminTransport):
 
         While the operation is pending:
 
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field is set to true.
-        -  Cancelling the operation is best-effort. If the cancellation
-           succeeds, the operation metadata's
-           [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
-           is set, the updates are reverted, and the operation
-           terminates with a ``CANCELLED`` status.
-        -  New UpdateDatabase requests will return a
-           ``FAILED_PRECONDITION`` error until the pending operation is
-           done (returns successfully or with error).
-        -  Reading the database via the API continues to give the
-           pre-request values.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field is set to true.
+        - Cancelling the operation is best-effort. If the cancellation
+          succeeds, the operation metadata's
+          [cancel_time][google.spanner.admin.database.v1.UpdateDatabaseMetadata.cancel_time]
+          is set, the updates are reverted, and the operation terminates
+          with a ``CANCELLED`` status.
+        - New UpdateDatabase requests will return a
+          ``FAILED_PRECONDITION`` error until the pending operation is
+          done (returns successfully or with error).
+        - Reading the database via the API continues to give the
+          pre-request values.
 
         Upon completion of the returned operation:
 
-        -  The new values are in effect and readable via the API.
-        -  The database's
-           [reconciling][google.spanner.admin.database.v1.Database.reconciling]
-           field becomes false.
+        - The new values are in effect and readable via the API.
+        - The database's
+          [reconciling][google.spanner.admin.database.v1.Database.reconciling]
+          field becomes false.
 
         The returned [long-running
         operation][google.longrunning.Operation] will have a name of the

{google_cloud_spanner-3.57.0 → google_cloud_spanner-3.59.0}/google/cloud/spanner_admin_database_v1/services/database_admin/transports/rest.py

@@ -1584,10 +1584,10 @@ class DatabaseAdminRestTransport(_BaseDatabaseAdminRestTransport):
 
     The Cloud Spanner Database Admin API can be used to:
 
-    -  create, drop, and list databases
-    -  update the schema of pre-existing databases
-    -  create, delete, copy and list backups for a database
-    -  restore a database from an existing backup
+    - create, drop, and list databases
+    - update the schema of pre-existing databases
+    - create, delete, copy and list backups for a database
+    - restore a database from an existing backup
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation