@googleapis/spanner 12.4.0 → 13.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/v1.d.ts CHANGED
@@ -259,7 +259,7 @@ export declare namespace spanner_v1 {
259
259
  */
260
260
  createTime?: string | null;
261
261
  /**
262
- * 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/`.
262
+ * 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\}`.
263
263
  */
264
264
  database?: string | null;
265
265
  /**
@@ -303,7 +303,7 @@ export declare namespace spanner_v1 {
303
303
  */
304
304
  minimumRestorableEdition?: string | null;
305
305
  /**
306
- * 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/`.
306
+ * 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\}`.
307
307
  */
308
308
  name?: string | null;
309
309
  /**
@@ -311,11 +311,11 @@ export declare namespace spanner_v1 {
311
311
  */
312
312
  oldestVersionTime?: string | null;
313
313
  /**
314
- * 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.
314
+ * 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.
315
315
  */
316
316
  referencingBackups?: string[] | null;
317
317
  /**
318
- * 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.
318
+ * 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.
319
319
  */
320
320
  referencingDatabases?: string[] | null;
321
321
  /**
@@ -357,7 +357,7 @@ export declare namespace spanner_v1 {
357
357
  */
358
358
  export interface Schema$BackupInstancePartition {
359
359
  /**
360
- * A unique identifier for the instance partition. Values are of the form `projects//instances//instancePartitions/`
360
+ * A unique identifier for the instance partition. Values are of the form `projects/{project\}/instances/{instance\}/instancePartitions/{instance_partition_id\}`
361
361
  */
362
362
  instancePartition?: string | null;
363
363
  }
@@ -447,7 +447,7 @@ export declare namespace spanner_v1 {
447
447
  */
448
448
  export interface Schema$BatchWriteResponse {
449
449
  /**
450
- * The commit timestamp of the transaction that applied this batch. Present if `status` is `OK`, absent otherwise.
450
+ * 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.
451
451
  */
452
452
  commitTimestamp?: string | null;
453
453
  /**
@@ -646,10 +646,18 @@ export declare namespace spanner_v1 {
646
646
  * The Cloud Spanner timestamp at which the transaction committed.
647
647
  */
648
648
  commitTimestamp?: string | null;
649
+ /**
650
+ * The isolation level used for the read-write transaction.
651
+ */
652
+ isolationLevel?: string | null;
649
653
  /**
650
654
  * If specified, transaction has not committed yet. You must retry the commit with the new precommit token.
651
655
  */
652
656
  precommitToken?: Schema$MultiplexedSessionPrecommitToken;
657
+ /**
658
+ * The read lock mode used for the read-write transaction.
659
+ */
660
+ readLockMode?: string | null;
653
661
  /**
654
662
  * If `TransactionOptions.isolation_level` is set to `IsolationLevel.REPEATABLE_READ`, then the snapshot timestamp is the timestamp at which all reads in the transaction ran. This timestamp is never returned.
655
663
  */
@@ -711,11 +719,11 @@ export declare namespace spanner_v1 {
711
719
  */
712
720
  encryptionType?: string | null;
713
721
  /**
714
- * 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/`.
722
+ * 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\}`.
715
723
  */
716
724
  kmsKeyName?: string | null;
717
725
  /**
718
- * 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.
726
+ * 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.
719
727
  */
720
728
  kmsKeyNames?: string[] | null;
721
729
  }
@@ -728,7 +736,7 @@ export declare namespace spanner_v1 {
728
736
  */
729
737
  cancelTime?: string | null;
730
738
  /**
731
- * The name of the backup being created through the copy operation. Values are of the form `projects//instances//backups/`.
739
+ * The name of the backup being created through the copy operation. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
732
740
  */
733
741
  name?: string | null;
734
742
  /**
@@ -736,7 +744,7 @@ export declare namespace spanner_v1 {
736
744
  */
737
745
  progress?: Schema$OperationProgress;
738
746
  /**
739
- * The name of the source backup that is being copied. Values are of the form `projects//instances//backups/`.
747
+ * The name of the source backup that is being copied. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
740
748
  */
741
749
  sourceBackup?: string | null;
742
750
  }
@@ -745,7 +753,7 @@ export declare namespace spanner_v1 {
745
753
  */
746
754
  export interface Schema$CopyBackupRequest {
747
755
  /**
748
- * Required. The id of the backup copy. The `backup_id` appended to `parent` forms the full backup_uri of the form `projects//instances//backups/`.
756
+ * 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\}`.
749
757
  */
750
758
  backupId?: string | null;
751
759
  /**
@@ -757,7 +765,7 @@ export declare namespace spanner_v1 {
757
765
  */
758
766
  expireTime?: string | null;
759
767
  /**
760
- * 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/`.
768
+ * 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\}`.
761
769
  */
762
770
  sourceBackup?: string | null;
763
771
  }
@@ -770,11 +778,11 @@ export declare namespace spanner_v1 {
770
778
  */
771
779
  encryptionType?: string | null;
772
780
  /**
773
- * 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/`.
781
+ * 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\}`.
774
782
  */
775
783
  kmsKeyName?: string | null;
776
784
  /**
777
- * 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.
785
+ * 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.
778
786
  */
779
787
  kmsKeyNames?: string[] | null;
780
788
  }
@@ -1676,11 +1684,11 @@ export declare namespace spanner_v1 {
1676
1684
  */
1677
1685
  name?: string | null;
1678
1686
  /**
1679
- * The number of nodes allocated to this instance partition. Users can set the `node_count` field to specify the target number of nodes allocated to the instance partition. This may be zero in API responses for instance partitions that are not yet in state `READY`.
1687
+ * The number of nodes allocated to this instance partition. Users can set the `node_count` field to specify the target number of nodes allocated to the instance partition. If autoscaling is enabled, node_count is treated as an OUTPUT_ONLY field and reflects the current number of nodes allocated to the instance partition. This may be zero in API responses for instance partitions that are not yet in state `READY`.
1680
1688
  */
1681
1689
  nodeCount?: number | null;
1682
1690
  /**
1683
- * The number of processing units allocated to this instance partition. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance partition. This might be zero in API responses for instance partitions that are not yet in the `READY` state.
1691
+ * The number of processing units allocated to this instance partition. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance partition. If autoscaling is enabled, processing_units is treated as an OUTPUT_ONLY field and reflects the current number of processing units allocated to the instance partition. This might be zero in API responses for instance partitions that are not yet in the `READY` state.
1684
1692
  */
1685
1693
  processingUnits?: number | null;
1686
1694
  /**
@@ -2710,7 +2718,7 @@ export declare namespace spanner_v1 {
2710
2718
  */
2711
2719
  multiplexedSessionPreviousTransactionId?: string | null;
2712
2720
  /**
2713
- * Read lock mode for the transaction.
2721
+ * The read lock mode for the transaction.
2714
2722
  */
2715
2723
  readLockMode?: string | null;
2716
2724
  }
@@ -5419,7 +5427,7 @@ export declare namespace spanner_v1 {
5419
5427
  * pageSize: 'placeholder-value',
5420
5428
  * // If non-empty, `page_token` should contain a next_page_token from a previous ListBackupOperationsResponse to the same `parent` and with the same `filter`.
5421
5429
  * pageToken: 'placeholder-value',
5422
- * // Required. The instance of the backup operations. Values are of the form `projects//instances/`.
5430
+ * // Required. The instance of the backup operations. Values are of the form `projects/{project\}/instances/{instance\}`.
5423
5431
  * parent: 'projects/my-project/instances/my-instance',
5424
5432
  * });
5425
5433
  * console.log(res.data);
@@ -5464,7 +5472,7 @@ export declare namespace spanner_v1 {
5464
5472
  */
5465
5473
  pageToken?: string;
5466
5474
  /**
5467
- * Required. The instance of the backup operations. Values are of the form `projects//instances/`.
5475
+ * Required. The instance of the backup operations. Values are of the form `projects/{project\}/instances/{instance\}`.
5468
5476
  */
5469
5477
  parent?: string;
5470
5478
  }
@@ -5506,7 +5514,7 @@ export declare namespace spanner_v1 {
5506
5514
  *
5507
5515
  * // Do the magic
5508
5516
  * const res = await spanner.projects.instances.backups.copy({
5509
- * // Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects//instances/`.
5517
+ * // Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects/{project\}/instances/{instance\}`.
5510
5518
  * parent: 'projects/my-project/instances/my-instance',
5511
5519
  *
5512
5520
  * // Request body metadata
@@ -5584,15 +5592,15 @@ export declare namespace spanner_v1 {
5584
5592
  *
5585
5593
  * // Do the magic
5586
5594
  * const res = await spanner.projects.instances.backups.create({
5587
- * // 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/`.
5595
+ * // 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\}`.
5588
5596
  * backupId: 'placeholder-value',
5589
5597
  * // Required. The encryption type of the backup.
5590
5598
  * 'encryptionConfig.encryptionType': 'placeholder-value',
5591
- * // 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/`.
5599
+ * // 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\}`.
5592
5600
  * 'encryptionConfig.kmsKeyName': 'placeholder-value',
5593
- * // 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.
5601
+ * // 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.
5594
5602
  * 'encryptionConfig.kmsKeyNames': 'placeholder-value',
5595
- * // 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/`.
5603
+ * // 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\}`.
5596
5604
  * parent: 'projects/my-project/instances/my-instance',
5597
5605
  *
5598
5606
  * // Request body metadata
@@ -5686,7 +5694,7 @@ export declare namespace spanner_v1 {
5686
5694
  *
5687
5695
  * // Do the magic
5688
5696
  * const res = await spanner.projects.instances.backups.delete({
5689
- * // Required. Name of the backup to delete. Values are of the form `projects//instances//backups/`.
5697
+ * // Required. Name of the backup to delete. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
5690
5698
  * name: 'projects/my-project/instances/my-instance/backups/my-backup',
5691
5699
  * });
5692
5700
  * console.log(res.data);
@@ -5747,7 +5755,7 @@ export declare namespace spanner_v1 {
5747
5755
  *
5748
5756
  * // Do the magic
5749
5757
  * const res = await spanner.projects.instances.backups.get({
5750
- * // Required. Name of the backup. Values are of the form `projects//instances//backups/`.
5758
+ * // Required. Name of the backup. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
5751
5759
  * name: 'projects/my-project/instances/my-instance/backups/my-backup',
5752
5760
  * });
5753
5761
  * console.log(res.data);
@@ -5908,7 +5916,7 @@ export declare namespace spanner_v1 {
5908
5916
  * pageSize: 'placeholder-value',
5909
5917
  * // If non-empty, `page_token` should contain a next_page_token from a previous ListBackupsResponse to the same `parent` and with the same `filter`.
5910
5918
  * pageToken: 'placeholder-value',
5911
- * // Required. The instance to list backups from. Values are of the form `projects//instances/`.
5919
+ * // Required. The instance to list backups from. Values are of the form `projects/{project\}/instances/{instance\}`.
5912
5920
  * parent: 'projects/my-project/instances/my-instance',
5913
5921
  * });
5914
5922
  * console.log(res.data);
@@ -5972,7 +5980,7 @@ export declare namespace spanner_v1 {
5972
5980
  *
5973
5981
  * // Do the magic
5974
5982
  * const res = await spanner.projects.instances.backups.patch({
5975
- * // 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/`.
5983
+ * // 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\}`.
5976
5984
  * name: 'projects/my-project/instances/my-instance/backups/my-backup',
5977
5985
  * // 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.
5978
5986
  * updateMask: 'placeholder-value',
@@ -6196,7 +6204,7 @@ export declare namespace spanner_v1 {
6196
6204
  }
6197
6205
  export interface Params$Resource$Projects$Instances$Backups$Copy extends StandardParameters {
6198
6206
  /**
6199
- * Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects//instances/`.
6207
+ * Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects/{project\}/instances/{instance\}`.
6200
6208
  */
6201
6209
  parent?: string;
6202
6210
  /**
@@ -6206,7 +6214,7 @@ export declare namespace spanner_v1 {
6206
6214
  }
6207
6215
  export interface Params$Resource$Projects$Instances$Backups$Create extends StandardParameters {
6208
6216
  /**
6209
- * 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/`.
6217
+ * 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\}`.
6210
6218
  */
6211
6219
  backupId?: string;
6212
6220
  /**
@@ -6214,15 +6222,15 @@ export declare namespace spanner_v1 {
6214
6222
  */
6215
6223
  'encryptionConfig.encryptionType'?: string;
6216
6224
  /**
6217
- * 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/`.
6225
+ * 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\}`.
6218
6226
  */
6219
6227
  'encryptionConfig.kmsKeyName'?: string;
6220
6228
  /**
6221
- * 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.
6229
+ * 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.
6222
6230
  */
6223
6231
  'encryptionConfig.kmsKeyNames'?: string[];
6224
6232
  /**
6225
- * 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/`.
6233
+ * 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\}`.
6226
6234
  */
6227
6235
  parent?: string;
6228
6236
  /**
@@ -6232,13 +6240,13 @@ export declare namespace spanner_v1 {
6232
6240
  }
6233
6241
  export interface Params$Resource$Projects$Instances$Backups$Delete extends StandardParameters {
6234
6242
  /**
6235
- * Required. Name of the backup to delete. Values are of the form `projects//instances//backups/`.
6243
+ * Required. Name of the backup to delete. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
6236
6244
  */
6237
6245
  name?: string;
6238
6246
  }
6239
6247
  export interface Params$Resource$Projects$Instances$Backups$Get extends StandardParameters {
6240
6248
  /**
6241
- * Required. Name of the backup. Values are of the form `projects//instances//backups/`.
6249
+ * Required. Name of the backup. Values are of the form `projects/{project\}/instances/{instance\}/backups/{backup\}`.
6242
6250
  */
6243
6251
  name?: string;
6244
6252
  }
@@ -6266,13 +6274,13 @@ export declare namespace spanner_v1 {
6266
6274
  */
6267
6275
  pageToken?: string;
6268
6276
  /**
6269
- * Required. The instance to list backups from. Values are of the form `projects//instances/`.
6277
+ * Required. The instance to list backups from. Values are of the form `projects/{project\}/instances/{instance\}`.
6270
6278
  */
6271
6279
  parent?: string;
6272
6280
  }
6273
6281
  export interface Params$Resource$Projects$Instances$Backups$Patch extends StandardParameters {
6274
6282
  /**
6275
- * 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/`.
6283
+ * 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\}`.
6276
6284
  */
6277
6285
  name?: string;
6278
6286
  /**
@@ -9475,7 +9483,9 @@ export declare namespace spanner_v1 {
9475
9483
  * // {
9476
9484
  * // "commitStats": {},
9477
9485
  * // "commitTimestamp": "my_commitTimestamp",
9486
+ * // "isolationLevel": "my_isolationLevel",
9478
9487
  * // "precommitToken": {},
9488
+ * // "readLockMode": "my_readLockMode",
9479
9489
  * // "snapshotTimestamp": "my_snapshotTimestamp"
9480
9490
  * // }
9481
9491
  * }