@googleapis/spanner 12.3.1 → 12.4.1

package/build/v1.d.ts

@@ -195,6 +195,18 @@ export declare namespace spanner_v1 {
          * Optional. If specified, overrides the autoscaling target high_priority_cpu_utilization_percent in the top-level autoscaling configuration for the selected replicas.
          */
         autoscalingTargetHighPriorityCpuUtilizationPercent?: number | null;
+        /**
+         * Optional. If specified, overrides the autoscaling target `total_cpu_utilization_percent` in the top-level autoscaling configuration for the selected replicas.
+         */
+        autoscalingTargetTotalCpuUtilizationPercent?: number | null;
+        /**
+         * Optional. If true, disables high priority CPU autoscaling for the selected replicas and ignores high_priority_cpu_utilization_percent in the top-level autoscaling configuration. When setting this field to true, setting autoscaling_target_high_priority_cpu_utilization_percent field to a non-zero value for the same replica is not supported. If false, the autoscaling_target_high_priority_cpu_utilization_percent field in the replica will be used if set to a non-zero value. Otherwise, the high_priority_cpu_utilization_percent field in the top-level autoscaling configuration will be used. Setting both disable_high_priority_cpu_autoscaling and disable_total_cpu_autoscaling to true for the same replica is not supported.
+         */
+        disableHighPriorityCpuAutoscaling?: boolean | null;
+        /**
+         * Optional. If true, disables total CPU autoscaling for the selected replicas and ignores total_cpu_utilization_percent in the top-level autoscaling configuration. When setting this field to true, setting autoscaling_target_total_cpu_utilization_percent field to a non-zero value for the same replica is not supported. If false, the autoscaling_target_total_cpu_utilization_percent field in the replica will be used if set to a non-zero value. Otherwise, the total_cpu_utilization_percent field in the top-level autoscaling configuration will be used. Setting both disable_high_priority_cpu_autoscaling and disable_total_cpu_autoscaling to true for the same replica is not supported.
+         */
+        disableTotalCpuAutoscaling?: boolean | null;
     }
     /**
      * The autoscaling limits for the instance. Users can define the minimum and maximum compute capacity allocated to the instance, and the autoscaler will only scale within that range. Users can either use nodes or processing units to specify the limits, but should use the same unit to set both the min_limit and max_limit.
@@ -222,13 +234,17 @@ export declare namespace spanner_v1 {
      */
     export interface Schema$AutoscalingTargets {
         /**
-         * Required. The target high priority cpu utilization percentage that the autoscaler should be trying to achieve for the instance. This number is on a scale from 0 (no utilization) to 100 (full utilization). The valid range is [10, 90] inclusive.
+         * Optional. The target high priority cpu utilization percentage that the autoscaler should be trying to achieve for the instance. This number is on a scale from 0 (no utilization) to 100 (full utilization). The valid range is [10, 90] inclusive. If not specified or set to 0, the autoscaler skips scaling based on high priority CPU utilization.
          */
         highPriorityCpuUtilizationPercent?: number | null;
         /**
          * Required. The target storage utilization percentage that the autoscaler should be trying to achieve for the instance. This number is on a scale from 0 (no utilization) to 100 (full utilization). The valid range is [10, 99] inclusive.
          */
         storageUtilizationPercent?: number | null;
+        /**
+         * Optional. The target total CPU utilization percentage that the autoscaler should be trying to achieve for the instance. This number is on a scale from 0 (no utilization) to 100 (full utilization). The valid range is [10, 90] inclusive. If not specified or set to 0, the autoscaler skips scaling based on total CPU utilization. If both `high_priority_cpu_utilization_percent` and `total_cpu_utilization_percent` are specified, the autoscaler provisions the larger of the two required compute capacities to satisfy both targets.
+         */
+        totalCpuUtilizationPercent?: number | null;
     }
     /**
      * A backup of a Cloud Spanner database.
@@ -243,7 +259,7 @@ export declare namespace spanner_v1 {
          */
         createTime?: string | null;
         /**
-         * Required for the CreateBackup operation. Name of the database from which this backup was created. This needs to be in the same instance as the backup. Values are of the form `projects//instances//databases/`.
+         * Required for the CreateBackup operation. Name of the database from which this backup was created. This needs to be in the same instance as the backup. Values are of the form `projects/{project\}/instances/{instance\}/databases/{database\}`.
          */
         database?: string | null;
         /**
@@ -283,7 +299,11 @@ export declare namespace spanner_v1 {
          */
         maxExpireTime?: string | null;
         /**
-         * Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects//instances/`.
+         * Output only. The minimum edition required to successfully restore the backup. Populated only if the edition is Enterprise or Enterprise Plus.
+         */
+        minimumRestorableEdition?: string | null;
+        /**
+         * Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project\}/instances/{instance\}/backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects/{project\}/instances/{instance\}`.
          */
         name?: string | null;
         /**
@@ -291,11 +311,11 @@ export declare namespace spanner_v1 {
          */
         oldestVersionTime?: string | null;
         /**
-         * Output only. The names of the destination backups being created by copying this source backup. The backup names are of the form `projects//instances//backups/`. Referencing backups may exist in different instances. The existence of any referencing backup prevents the backup from being deleted. When the copy operation is done (either successfully completed or cancelled or the destination backup is deleted), the reference to the backup is removed.
+         * Output only. The names of the destination backups being created by copying this source backup. The backup names are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`. Referencing backups may exist in different instances. The existence of any referencing backup prevents the backup from being deleted. When the copy operation is done (either successfully completed or cancelled or the destination backup is deleted), the reference to the backup is removed.
          */
         referencingBackups?: string[] | null;
         /**
-         * Output only. The names of the restored databases that reference the backup. The database names are of the form `projects//instances//databases/`. Referencing databases may exist in different instances. The existence of any referencing database prevents the backup from being deleted. When a restored database from the backup enters the `READY` state, the reference to the backup is removed.
+         * Output only. The names of the restored databases that reference the backup. The database names are of the form `projects/{project\}/instances/{instance\}/databases/{database\}`. Referencing databases may exist in different instances. The existence of any referencing database prevents the backup from being deleted. When a restored database from the backup enters the `READY` state, the reference to the backup is removed.
          */
         referencingDatabases?: string[] | null;
         /**
@@ -337,7 +357,7 @@ export declare namespace spanner_v1 {
      */
     export interface Schema$BackupInstancePartition {
         /**
-         * A unique identifier for the instance partition. Values are of the form `projects//instances//instancePartitions/`
+         * A unique identifier for the instance partition. Values are of the form `projects/{project\}/instances/{instance\}/instancePartitions/{instance_partition_id\}`
          */
         instancePartition?: string | null;
     }
@@ -427,7 +447,7 @@ export declare namespace spanner_v1 {
      */
     export interface Schema$BatchWriteResponse {
         /**
-         * The commit timestamp of the transaction that applied this batch. Present if `status` is `OK`, absent otherwise.
+         * The commit timestamp of the transaction that applied this batch. Present if status is OK and the mutation groups were applied, absent otherwise. For mutation groups with conditions, a status=OK and missing commit_timestamp means that the mutation groups were not applied due to the condition not being satisfied after evaluation.
          */
         commitTimestamp?: string | null;
         /**
@@ -549,6 +569,17 @@ export declare namespace spanner_v1 {
          */
         variable?: string | null;
     }
+    /**
+     * Container for various pieces of client-owned context attached to a request.
+     */
+    export interface Schema$ClientContext {
+        /**
+         * Optional. Map of parameter name to value for this request. These values will be returned by any SECURE_CONTEXT() calls invoked by this request (e.g., by queries against Parameterized Secure Views).
+         */
+        secureContext?: {
+            [key: string]: any;
+        } | null;
+    }
     /**
      * Metadata for a column.
      */
@@ -680,11 +711,11 @@ export declare namespace spanner_v1 {
          */
         encryptionType?: string | null;
         /**
-         * Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+         * Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`.
          */
         kmsKeyName?: string | null;
         /**
-         * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
+         * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
          */
         kmsKeyNames?: string[] | null;
     }
@@ -697,7 +728,7 @@ export declare namespace spanner_v1 {
          */
         cancelTime?: string | null;
         /**
-         * The name of the backup being created through the copy operation. Values are of the form `projects//instances//backups/`.
+         * The name of the backup being created through the copy operation. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          */
         name?: string | null;
         /**
@@ -705,7 +736,7 @@ export declare namespace spanner_v1 {
          */
         progress?: Schema$OperationProgress;
         /**
-         * The name of the source backup that is being copied. Values are of the form `projects//instances//backups/`.
+         * The name of the source backup that is being copied. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          */
         sourceBackup?: string | null;
     }
@@ -714,7 +745,7 @@ export declare namespace spanner_v1 {
      */
     export interface Schema$CopyBackupRequest {
         /**
-         * Required. The id of the backup copy. The `backup_id` appended to `parent` forms the full backup_uri of the form `projects//instances//backups/`.
+         * Required. The id of the backup copy. The `backup_id` appended to `parent` forms the full backup_uri of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          */
         backupId?: string | null;
         /**
@@ -726,7 +757,7 @@ export declare namespace spanner_v1 {
          */
         expireTime?: string | null;
         /**
-         * Required. The source backup to be copied. The source backup needs to be in READY state for it to be copied. Once CopyBackup is in progress, the source backup cannot be deleted or cleaned up on expiration until CopyBackup is finished. Values are of the form: `projects//instances//backups/`.
+         * Required. The source backup to be copied. The source backup needs to be in READY state for it to be copied. Once CopyBackup is in progress, the source backup cannot be deleted or cleaned up on expiration until CopyBackup is finished. Values are of the form: `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          */
         sourceBackup?: string | null;
     }
@@ -739,11 +770,11 @@ export declare namespace spanner_v1 {
          */
         encryptionType?: string | null;
         /**
-         * Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+         * Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`.
          */
         kmsKeyName?: string | null;
         /**
-         * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
+         * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
          */
         kmsKeyNames?: string[] | null;
     }
@@ -2353,13 +2384,13 @@ export declare namespace spanner_v1 {
      */
     export interface Schema$PartitionQueryRequest {
         /**
-         * Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names can contain letters, numbers, and underscores. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `"WHERE id \> @msg_id AND id < @msg_id + 100"` It's an error to execute a SQL statement with unbound parameters.
+         * Optional. Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names can contain letters, numbers, and underscores. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `"WHERE id \> @msg_id AND id < @msg_id + 100"` It's an error to execute a SQL statement with unbound parameters.
          */
         params?: {
             [key: string]: any;
         } | null;
         /**
-         * It isn't always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL query parameters. See the definition of Type for more information about SQL types.
+         * Optional. It isn't always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL query parameters. See the definition of Type for more information about SQL types.
          */
         paramTypes?: {
             [key: string]: Schema$Type;
@@ -2679,7 +2710,7 @@ export declare namespace spanner_v1 {
          */
         multiplexedSessionPreviousTransactionId?: string | null;
         /**
-         * Read lock mode for the transaction.
+         * The read lock mode for the transaction.
          */
         readLockMode?: string | null;
     }
@@ -2731,6 +2762,10 @@ export declare namespace spanner_v1 {
      * Common request options for various APIs.
      */
     export interface Schema$RequestOptions {
+        /**
+         * Optional. Optional context that may be needed for some requests.
+         */
+        clientContext?: Schema$ClientContext;
         /**
          * Priority for the request.
          */
@@ -5384,7 +5419,7 @@ export declare namespace spanner_v1 {
          *     pageSize: 'placeholder-value',
          *     // If non-empty, `page_token` should contain a next_page_token from a previous ListBackupOperationsResponse to the same `parent` and with the same `filter`.
          *     pageToken: 'placeholder-value',
-         *     // Required. The instance of the backup operations. Values are of the form `projects//instances/`.
+         *     // Required. The instance of the backup operations. Values are of the form `projects/{project\}/instances/{instance\}`.
          *     parent: 'projects/my-project/instances/my-instance',
          *   });
          *   console.log(res.data);
@@ -5429,7 +5464,7 @@ export declare namespace spanner_v1 {
          */
         pageToken?: string;
         /**
-         * Required. The instance of the backup operations. Values are of the form `projects//instances/`.
+         * Required. The instance of the backup operations. Values are of the form `projects/{project\}/instances/{instance\}`.
          */
         parent?: string;
     }
@@ -5471,7 +5506,7 @@ export declare namespace spanner_v1 {
          *
          *   // Do the magic
          *   const res = await spanner.projects.instances.backups.copy({
-         *     // Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects//instances/`.
+         *     // Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects/{project\}/instances/{instance\}`.
          *     parent: 'projects/my-project/instances/my-instance',
          *
          *     // Request body metadata
@@ -5549,15 +5584,15 @@ export declare namespace spanner_v1 {
          *
          *   // Do the magic
          *   const res = await spanner.projects.instances.backups.create({
-         *     // Required. The id of the backup to be created. The `backup_id` appended to `parent` forms the full backup name of the form `projects//instances//backups/`.
+         *     // 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\}`.
          *     backupId: 'placeholder-value',
          *     // Required. The encryption type of the backup.
          *     'encryptionConfig.encryptionType': 'placeholder-value',
-         *     // Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+         *     // Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`.
          *     'encryptionConfig.kmsKeyName': 'placeholder-value',
-         *     // Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
+         *     // Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
          *     'encryptionConfig.kmsKeyNames': 'placeholder-value',
-         *     // Required. The name of the instance in which the backup is created. This must be the same instance that contains the database the backup is created from. The backup will be stored in the locations specified in the instance configuration of this instance. Values are of the form `projects//instances/`.
+         *     // Required. The name of the instance in which the backup is created. This must be the same instance that contains the database the backup is created from. The backup will be stored in the locations specified in the instance configuration of this instance. Values are of the form `projects/{project\}/instances/{instance\}`.
          *     parent: 'projects/my-project/instances/my-instance',
          *
          *     // Request body metadata
@@ -5576,6 +5611,7 @@ export declare namespace spanner_v1 {
          *       //   "incrementalBackupChainId": "my_incrementalBackupChainId",
          *       //   "instancePartitions": [],
          *       //   "maxExpireTime": "my_maxExpireTime",
+         *       //   "minimumRestorableEdition": "my_minimumRestorableEdition",
          *       //   "name": "my_name",
          *       //   "oldestVersionTime": "my_oldestVersionTime",
          *       //   "referencingBackups": [],
@@ -5650,7 +5686,7 @@ export declare namespace spanner_v1 {
          *
          *   // Do the magic
          *   const res = await spanner.projects.instances.backups.delete({
-         *     // Required. Name of the backup to delete. Values are of the form `projects//instances//backups/`.
+         *     // Required. Name of the backup to delete. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          *     name: 'projects/my-project/instances/my-instance/backups/my-backup',
          *   });
          *   console.log(res.data);
@@ -5711,7 +5747,7 @@ export declare namespace spanner_v1 {
          *
          *   // Do the magic
          *   const res = await spanner.projects.instances.backups.get({
-         *     // Required. Name of the backup. Values are of the form `projects//instances//backups/`.
+         *     // Required. Name of the backup. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          *     name: 'projects/my-project/instances/my-instance/backups/my-backup',
          *   });
          *   console.log(res.data);
@@ -5730,6 +5766,7 @@ export declare namespace spanner_v1 {
          *   //   "incrementalBackupChainId": "my_incrementalBackupChainId",
          *   //   "instancePartitions": [],
          *   //   "maxExpireTime": "my_maxExpireTime",
+         *   //   "minimumRestorableEdition": "my_minimumRestorableEdition",
          *   //   "name": "my_name",
          *   //   "oldestVersionTime": "my_oldestVersionTime",
          *   //   "referencingBackups": [],
@@ -5871,7 +5908,7 @@ export declare namespace spanner_v1 {
          *     pageSize: 'placeholder-value',
          *     // If non-empty, `page_token` should contain a next_page_token from a previous ListBackupsResponse to the same `parent` and with the same `filter`.
          *     pageToken: 'placeholder-value',
-         *     // Required. The instance to list backups from. Values are of the form `projects//instances/`.
+         *     // Required. The instance to list backups from. Values are of the form `projects/{project\}/instances/{instance\}`.
          *     parent: 'projects/my-project/instances/my-instance',
          *   });
          *   console.log(res.data);
@@ -5935,7 +5972,7 @@ export declare namespace spanner_v1 {
          *
          *   // Do the magic
          *   const res = await spanner.projects.instances.backups.patch({
-         *     // Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects//instances/`.
+         *     // Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project\}/instances/{instance\}/backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects/{project\}/instances/{instance\}`.
          *     name: 'projects/my-project/instances/my-instance/backups/my-backup',
          *     // Required. A mask specifying which fields (for example, `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.
          *     updateMask: 'placeholder-value',
@@ -5956,6 +5993,7 @@ export declare namespace spanner_v1 {
          *       //   "incrementalBackupChainId": "my_incrementalBackupChainId",
          *       //   "instancePartitions": [],
          *       //   "maxExpireTime": "my_maxExpireTime",
+         *       //   "minimumRestorableEdition": "my_minimumRestorableEdition",
          *       //   "name": "my_name",
          *       //   "oldestVersionTime": "my_oldestVersionTime",
          *       //   "referencingBackups": [],
@@ -5982,6 +6020,7 @@ export declare namespace spanner_v1 {
          *   //   "incrementalBackupChainId": "my_incrementalBackupChainId",
          *   //   "instancePartitions": [],
          *   //   "maxExpireTime": "my_maxExpireTime",
+         *   //   "minimumRestorableEdition": "my_minimumRestorableEdition",
          *   //   "name": "my_name",
          *   //   "oldestVersionTime": "my_oldestVersionTime",
          *   //   "referencingBackups": [],
@@ -6157,7 +6196,7 @@ export declare namespace spanner_v1 {
     }
     export interface Params$Resource$Projects$Instances$Backups$Copy extends StandardParameters {
         /**
-         * Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects//instances/`.
+         * Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects/{project\}/instances/{instance\}`.
          */
         parent?: string;
         /**
@@ -6167,7 +6206,7 @@ export declare namespace spanner_v1 {
     }
     export interface Params$Resource$Projects$Instances$Backups$Create extends StandardParameters {
         /**
-         * Required. The id of the backup to be created. The `backup_id` appended to `parent` forms the full backup name of the form `projects//instances//backups/`.
+         * 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\}`.
          */
         backupId?: string;
         /**
@@ -6175,15 +6214,15 @@ export declare namespace spanner_v1 {
          */
         'encryptionConfig.encryptionType'?: string;
         /**
-         * Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
+         * Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`.
          */
         'encryptionConfig.kmsKeyName'?: string;
         /**
-         * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
+         * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project\}/locations/{location\}/keyRings/{key_ring\}/cryptoKeys/{kms_key_name\}`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
          */
         'encryptionConfig.kmsKeyNames'?: string[];
         /**
-         * Required. The name of the instance in which the backup is created. This must be the same instance that contains the database the backup is created from. The backup will be stored in the locations specified in the instance configuration of this instance. Values are of the form `projects//instances/`.
+         * Required. The name of the instance in which the backup is created. This must be the same instance that contains the database the backup is created from. The backup will be stored in the locations specified in the instance configuration of this instance. Values are of the form `projects/{project\}/instances/{instance\}`.
          */
         parent?: string;
         /**
@@ -6193,13 +6232,13 @@ export declare namespace spanner_v1 {
     }
     export interface Params$Resource$Projects$Instances$Backups$Delete extends StandardParameters {
         /**
-         * Required. Name of the backup to delete. Values are of the form `projects//instances//backups/`.
+         * Required. Name of the backup to delete. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          */
         name?: string;
     }
     export interface Params$Resource$Projects$Instances$Backups$Get extends StandardParameters {
         /**
-         * Required. Name of the backup. Values are of the form `projects//instances//backups/`.
+         * Required. Name of the backup. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
          */
         name?: string;
     }
@@ -6227,13 +6266,13 @@ export declare namespace spanner_v1 {
          */
         pageToken?: string;
         /**
-         * Required. The instance to list backups from. Values are of the form `projects//instances/`.
+         * Required. The instance to list backups from. Values are of the form `projects/{project\}/instances/{instance\}`.
          */
         parent?: string;
     }
     export interface Params$Resource$Projects$Instances$Backups$Patch extends StandardParameters {
         /**
-         * Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects//instances//backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects//instances/`.
+         * Output only for the CreateBackup operation. Required for the UpdateBackup operation. A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project\}/instances/{instance\}/backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects/{project\}/instances/{instance\}`.
          */
         name?: string;
         /**