@maxim_mazurok/gapi.client.spanner-v1 0.0.20240719 → 0.0.20240807

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.
Files changed (2) hide show
  1. package/index.d.ts +43 -30
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -9,7 +9,7 @@
9
9
  // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
10
10
  // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
11
11
  // Generated from: https://spanner.googleapis.com/$discovery/rest?version=v1
12
- // Revision: 20240719
12
+ // Revision: 20240807
13
13
 
14
14
  /// <reference types="gapi.client" />
15
15
 
@@ -59,17 +59,25 @@ declare namespace gapi.client {
59
59
  encryptionInfo?: EncryptionInfo;
60
60
  /** Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined. */
61
61
  encryptionInformation?: EncryptionInfo[];
62
+ /** Output only. For a backup in an incremental backup chain, this is the storage space needed to keep the data that has changed since the previous backup. For all other backups, this is always the size of the backup. This value may change if backups on the same chain get deleted or expired. This field can be used to calculate the total storage space used by a set of backups. For example, the total space used by all backups of a database can be computed by summing up this field. */
63
+ exclusiveSizeBytes?: string;
62
64
  /** Required for the CreateBackup operation. The expiration time of the backup, with microseconds granularity that must be at least 6 hours and at most 366 days from the time the CreateBackup request is processed. Once the `expire_time` has passed, the backup is eligible to be automatically deleted by Cloud Spanner to free the resources used by the backup. */
63
65
  expireTime?: string;
66
+ /** Output only. The number of bytes that will be freed by deleting this backup. This value will be zero if, for example, this backup is part of an incremental backup chain and younger backups in the chain require that we keep its data. For backups not in an incremental backup chain, this is always the size of the backup. This value may change if backups on the same chain get created, deleted or expired. */
67
+ freeableSizeBytes?: string;
68
+ /** Output only. Populated only for backups in an incremental backup chain. Backups share the same chain id if and only if they belong to the same incremental backup chain. Use this field to determine which backups are part of the same incremental backup chain. The ordering of backups in the chain can be determined by ordering the backup `version_time`. */
69
+ incrementalBackupChainId?: string;
64
70
  /** Output only. The max allowed expiration time of the backup, with microseconds granularity. A backup's expiration time can be configured in multiple APIs: CreateBackup, UpdateBackup, CopyBackup. When updating or copying an existing backup, the expiration time specified must be less than `Backup.max_expire_time`. */
65
71
  maxExpireTime?: string;
66
72
  /** 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/`. */
67
73
  name?: string;
74
+ /** Output only. Data deleted at a time older than this is guaranteed not to be retained in order to support this backup. For a backup in an incremental backup chain, this is the version time of the oldest backup that exists or ever existed in the chain. For all other backups, this is the version time of the backup. This field can be used to understand what data is being retained by the backup system. */
75
+ oldestVersionTime?: string;
68
76
  /** 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. */
69
77
  referencingBackups?: string[];
70
78
  /** 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. */
71
79
  referencingDatabases?: string[];
72
- /** Output only. Size of the backup in bytes. */
80
+ /** Output only. Size of the backup in bytes. For a backup in an incremental backup chain, this is the sum of the `exclusive_size_bytes` of itself and all older backups in the chain. */
73
81
  sizeBytes?: string;
74
82
  /** Output only. The current state of the backup. */
75
83
  state?: string;
@@ -91,6 +99,8 @@ declare namespace gapi.client {
91
99
  encryptionConfig?: CreateBackupEncryptionConfig;
92
100
  /** The schedule creates only full backups. */
93
101
  fullBackupSpec?: any;
102
+ /** The schedule creates incremental backup chains. */
103
+ incrementalBackupSpec?: any;
94
104
  /** Identifier. Output only for the CreateBackupSchedule operation. Required for the UpdateBackupSchedule operation. A globally unique identifier for the backup schedule which cannot be changed. Values are of the form `projects//instances//databases//backupSchedules/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. */
95
105
  name?: string;
96
106
  /** Optional. The retention duration of a backup that must be at least 6 hours and at most 366 days. The backup is eligible to be automatically deleted once the retention period has elapsed. */
@@ -153,11 +163,11 @@ declare namespace gapi.client {
153
163
  startTime?: string;
154
164
  }
155
165
  interface ChangeQuorumRequest {
156
- /** Optional. The etag is the hash of the QuorumInfo. The ChangeQuorum operation will only be performed if the etag matches that of the QuorumInfo in the current database resource. Otherwise the API will return an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition. */
166
+ /** Optional. The etag is the hash of the `QuorumInfo`. The `ChangeQuorum` operation is only performed if the etag matches that of the `QuorumInfo` in the current database resource. Otherwise the API returns an `ABORTED` error. The etag is used for optimistic concurrency control as a way to help prevent simultaneous change quorum requests that could create a race condition. */
157
167
  etag?: string;
158
- /** Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`. */
168
+ /** Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`. */
159
169
  name?: string;
160
- /** Required. The type of this Quorum. */
170
+ /** Required. The type of this quorum. */
161
171
  quorumType?: QuorumType;
162
172
  }
163
173
  interface ChildLink {
@@ -273,7 +283,7 @@ declare namespace gapi.client {
273
283
  progress?: InstanceOperationProgress;
274
284
  }
275
285
  interface CreateInstanceConfigRequest {
276
- /** Required. The InstanceConfig proto of the configuration to create. instance_config.name must be `/instanceConfigs/`. instance_config.base_config must be a Google-managed configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3. */
286
+ /** Required. The `InstanceConfig` proto of the configuration to create. `instance_config.name` must be `/instanceConfigs/`. `instance_config.base_config` must be a Google-managed configuration name, e.g. /instanceConfigs/us-east1, /instanceConfigs/nam3. */
277
287
  instanceConfig?: InstanceConfig;
278
288
  /** Required. The ID of the instance configuration to create. Valid identifiers are of the form `custom-[-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in length. The `custom-` prefix is required to avoid name conflicts with Google-managed configurations. */
279
289
  instanceConfigId?: string;
@@ -343,7 +353,7 @@ declare namespace gapi.client {
343
353
  encryptionInfo?: EncryptionInfo[];
344
354
  /** Required. The name of the database. Values are of the form `projects//instances//databases/`, where `` is as specified in the `CREATE DATABASE` statement. This name can be passed to other API methods to identify the database. */
345
355
  name?: string;
346
- /** Output only. Applicable only for databases that use dual region instance configurations. Contains information about the quorum. */
356
+ /** Output only. Applicable only for databases that use dual-region instance configurations. Contains information about the quorum. */
347
357
  quorumInfo?: QuorumInfo;
348
358
  /** Output only. If true, the database is being updated. If false, there are no ongoing update operations for the database. */
349
359
  reconciling?: boolean;
@@ -503,6 +513,7 @@ declare namespace gapi.client {
503
513
  /** The directed read replica selector. */
504
514
  replicaSelections?: ReplicaSelection[];
505
515
  }
516
+ interface IncrementalBackupSpec {}
506
517
  interface IndexAdvice {
507
518
  /** Optional. DDL statements to add new indexes that will improve the query. */
508
519
  ddl?: string[];
@@ -526,6 +537,8 @@ declare namespace gapi.client {
526
537
  createTime?: string;
527
538
  /** Required. The descriptive name for this instance as it appears in UIs. Must be unique per project and between 4 and 30 characters in length. */
528
539
  displayName?: string;
540
+ /** Optional. The `Edition` of the current instance. */
541
+ edition?: string;
529
542
  /** Deprecated. This field is not populated. */
530
543
  endpointUris?: string[];
531
544
  /** Free instance metadata. Only populated for free instances. */
@@ -536,9 +549,9 @@ declare namespace gapi.client {
536
549
  labels?: {[P in string]: string};
537
550
  /** Required. A unique identifier for the instance, which cannot be changed after the instance is created. Values are of the form `projects//instances/a-z*[a-z0-9]`. The final segment of the name must be between 2 and 64 characters in length. */
538
551
  name?: string;
539
- /** The number of nodes allocated to this instance. At most, one of either `node_count` or `processing_units` should be present in the message. Users can set the node_count field to specify the target number of nodes allocated to the instance. If autoscaling is enabled, node_count is treated as an OUTPUT_ONLY field and reflects the current number of nodes allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes, and processing units](https://cloud.google.com/spanner/docs/compute-capacity). */
552
+ /** The number of nodes allocated to this instance. At most, one of either `node_count` or `processing_units` should be present in the message. Users can set the `node_count` field to specify the target number of nodes allocated to the instance. If autoscaling is enabled, `node_count` is treated as an `OUTPUT_ONLY` field and reflects the current number of nodes allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes, and processing units](https://cloud.google.com/spanner/docs/compute-capacity). */
540
553
  nodeCount?: number;
541
- /** The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. 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. This might be zero in API responses for instances that are not yet in the `READY` state. See [the documentation](https://cloud.google.com/spanner/docs/compute-capacity) for more information about nodes and processing units. */
554
+ /** The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. 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. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes and processing units](https://cloud.google.com/spanner/docs/compute-capacity). */
542
555
  processingUnits?: number;
543
556
  /** Output only. The current instance state. For CreateInstance, the state must be either omitted or set to `CREATING`. For UpdateInstance, the state must be either omitted or set to `READY`. */
544
557
  state?: string;
@@ -548,13 +561,13 @@ declare namespace gapi.client {
548
561
  interface InstanceConfig {
549
562
  /** Base configuration name, e.g. projects//instanceConfigs/nam3, based on which this configuration is created. Only set for user-managed configurations. `base_config` must refer to a configuration of type `GOOGLE_MANAGED` in the same project as this configuration. */
550
563
  baseConfig?: string;
551
- /** Output only. Whether this instance configuration is a Google- or user-managed configuration. */
564
+ /** Output only. Whether this instance configuration is a Google-managed or user-managed configuration. */
552
565
  configType?: string;
553
566
  /** The name of this instance configuration as it appears in UIs. */
554
567
  displayName?: string;
555
568
  /** etag is used for optimistic concurrency control as a way to help prevent simultaneous updates of a instance configuration from overwriting each other. It is strongly suggested that systems make use of the etag in the read-modify-write cycle to perform instance configuration updates in order to avoid race conditions: An etag is returned in the response which contains instance configurations, and systems are expected to put that etag in the request to update instance configuration to ensure that their change is applied to the same version of the instance configuration. If no etag is provided in the call to update the instance configuration, then the existing instance configuration is overwritten blindly. */
556
569
  etag?: string;
557
- /** Output only. Describes whether free instances are available to be created in this instance config. */
570
+ /** Output only. Describes whether free instances are available to be created in this instance configuration. */
558
571
  freeInstanceAvailability?: string;
559
572
  /** Cloud Labels are a flexible and lightweight mechanism for organizing cloud resources into groups that reflect a customer's organizational needs and deployment strategies. Cloud Labels can be used to filter collections of resources. They can be used to control how resource metrics are aggregated. And they can be used as arguments to policy management rules (e.g. route, firewall, load balancing, etc.). * Label keys must be between 1 and 63 characters long and must conform to the following regular expression: `a-z{0,62}`. * Label values must be between 0 and 63 characters long and must conform to the regular expression `[a-z0-9_-]{0,63}`. * No more than 64 labels can be associated with a given resource. See https://goo.gl/xmQnxf for more information on and examples of labels. If you plan to use labels in your own code, please note that additional characters may be allowed in the future. Therefore, you are advised to use an internal label representation, such as JSON, which doesn't rely upon specific characters being disallowed. For example, representing labels as the string: name + "_" + value would prove problematic if we were to allow "_" in a future release. */
560
573
  labels?: {[P in string]: string};
@@ -566,7 +579,7 @@ declare namespace gapi.client {
566
579
  optionalReplicas?: ReplicaInfo[];
567
580
  /** Output only. The `QuorumType` of the instance configuration. */
568
581
  quorumType?: string;
569
- /** Output only. If true, the instance configuration is being created or updated. If false, there are no ongoing operations for the instance config. */
582
+ /** Output only. If true, the instance configuration is being created or updated. If false, there are no ongoing operations for the instance configuration. */
570
583
  reconciling?: boolean;
571
584
  /** The geographic placement of nodes in this instance configuration and their replication properties. To create user-managed configurations, input `replicas` must include all replicas in `replicas` of the `base_config` and include one or more replicas in the `optional_replicas` of the `base_config`. */
572
585
  replicas?: ReplicaInfo[];
@@ -598,7 +611,7 @@ declare namespace gapi.client {
598
611
  nodeCount?: number;
599
612
  /** 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. */
600
613
  processingUnits?: number;
601
- /** Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted. */
614
+ /** Output only. Deprecated: This field is not populated. Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted. */
602
615
  referencingBackups?: string[];
603
616
  /** Output only. The names of the databases that reference this instance partition. Referencing databases should share the parent instance. The existence of any referencing database prevents the instance partition from being deleted. */
604
617
  referencingDatabases?: string[];
@@ -690,7 +703,7 @@ declare namespace gapi.client {
690
703
  interface ListInstanceConfigOperationsResponse {
691
704
  /** `next_page_token` can be sent in a subsequent ListInstanceConfigOperations call to fetch more of the matching metadata. */
692
705
  nextPageToken?: string;
693
- /** The list of matching instance configuration long-running operations. Each operation's name will be prefixed by the instance config's name. The operation's metadata field type `metadata.type_url` describes the type of the metadata. */
706
+ /** The list of matching instance configuration long-running operations. Each operation's name will be prefixed by the name of the instance configuration. The operation's metadata field type `metadata.type_url` describes the type of the metadata. */
694
707
  operations?: Operation[];
695
708
  }
696
709
  interface ListInstanceConfigsResponse {
@@ -784,7 +797,7 @@ declare namespace gapi.client {
784
797
  cols?: number[];
785
798
  }
786
799
  interface MoveInstanceRequest {
787
- /** Required. The target instance configuration for the instance to move. Values are of the form `projects//instanceConfigs/`. */
800
+ /** Required. The target instance configuration where to move the instance. Values are of the form `projects//instanceConfigs/`. */
788
801
  targetConfig?: string;
789
802
  }
790
803
  interface Mutation {
@@ -937,9 +950,9 @@ declare namespace gapi.client {
937
950
  queryAdvice?: QueryAdvisorResult;
938
951
  }
939
952
  interface QuorumInfo {
940
- /** Output only. The etag is used for optimistic concurrency control as a way to help prevent simultaneous ChangeQuorum requests that could create a race condition. */
953
+ /** Output only. The etag is used for optimistic concurrency control as a way to help prevent simultaneous `ChangeQuorum` requests that might create a race condition. */
941
954
  etag?: string;
942
- /** Output only. Whether this ChangeQuorum is a Google or User initiated. */
955
+ /** Output only. Whether this `ChangeQuorum` is Google or User initiated. */
943
956
  initiator?: string;
944
957
  /** Output only. The type of this quorum. See QuorumType for more information about quorum type specifications. */
945
958
  quorumType?: QuorumType;
@@ -947,9 +960,9 @@ declare namespace gapi.client {
947
960
  startTime?: string;
948
961
  }
949
962
  interface QuorumType {
950
- /** Dual region quorum type. */
963
+ /** Dual-region quorum type. */
951
964
  dualRegion?: any;
952
- /** Single region quorum type. */
965
+ /** Single-region quorum type. */
953
966
  singleRegion?: SingleRegionQuorum;
954
967
  }
955
968
  interface ReadOnly {
@@ -1131,7 +1144,7 @@ declare namespace gapi.client {
1131
1144
  subqueries?: {[P in string]: number};
1132
1145
  }
1133
1146
  interface SingleRegionQuorum {
1134
- /** Required. The location of the serving region, e.g. "us-central1". The location must be one of the regions within the dual region instance configuration of your database. The list of valid locations is available via [GetInstanceConfig[InstanceAdmin.GetInstanceConfig] API. This should only be used if you plan to change quorum in single-region quorum type. */
1147
+ /** Required. The location of the serving region, e.g. "us-central1". The location must be one of the regions within the dual-region instance configuration of your database. The list of valid locations is available using the GetInstanceConfig API. This should only be used if you plan to change quorum to the single-region quorum type. */
1135
1148
  servingLocation?: string;
1136
1149
  }
1137
1150
  interface Statement {
@@ -1585,7 +1598,7 @@ declare namespace gapi.client {
1585
1598
  operations: OperationsResource;
1586
1599
  }
1587
1600
  interface InstanceConfigsResource {
1588
- /** Creates an instance configuration and begins preparing it to be used. The returned long-running operation can be used to track the progress of preparing the new instance config. The instance configuration name is assigned by the caller. If the named instance configuration already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`. Immediately after the request returns: * The instance configuration is readable via the API, with all requested attributes. The instance config's reconciling field is set to true. Its state is `CREATING`. While the operation is pending: * Cancelling the operation renders the instance configuration immediately unreadable via the API. * Except for deleting the creating resource, all other attempts to modify the instance configuration are rejected. Upon completion of the returned operation: * Instances can be created using the instance configuration. * The instance config's reconciling field becomes false. Its state becomes `READY`. The returned long-running operation will have a name of the format `/operations/` and can be used to track creation of the instance config. The metadata field type is CreateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.create` permission on the resource parent. */
1601
+ /** Creates an instance configuration and begins preparing it to be used. The returned long-running operation can be used to track the progress of preparing the new instance configuration. The instance configuration name is assigned by the caller. If the named instance configuration already exists, `CreateInstanceConfig` returns `ALREADY_EXISTS`. Immediately after the request returns: * The instance configuration is readable via the API, with all requested attributes. The instance configuration's reconciling field is set to true. Its state is `CREATING`. While the operation is pending: * Cancelling the operation renders the instance configuration immediately unreadable via the API. * Except for deleting the creating resource, all other attempts to modify the instance configuration are rejected. Upon completion of the returned operation: * Instances can be created using the instance configuration. * The instance configuration's reconciling field becomes false. Its state becomes `READY`. The returned long-running operation will have a name of the format `/operations/` and can be used to track creation of the instance configuration. The metadata field type is CreateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.create` permission on the resource parent. */
1589
1602
  create(request: {
1590
1603
  /** V1 error format. */
1591
1604
  '$.xgafv'?: string;
@@ -1601,7 +1614,7 @@ declare namespace gapi.client {
1601
1614
  key?: string;
1602
1615
  /** OAuth 2.0 token for the current user. */
1603
1616
  oauth_token?: string;
1604
- /** Required. The name of the project in which to create the instance config. Values are of the form `projects/`. */
1617
+ /** Required. The name of the project in which to create the instance configuration. Values are of the form `projects/`. */
1605
1618
  parent: string;
1606
1619
  /** Returns response with indentations and line breaks. */
1607
1620
  prettyPrint?: boolean;
@@ -1630,7 +1643,7 @@ declare namespace gapi.client {
1630
1643
  key?: string;
1631
1644
  /** OAuth 2.0 token for the current user. */
1632
1645
  oauth_token?: string;
1633
- /** Required. The name of the project in which to create the instance config. Values are of the form `projects/`. */
1646
+ /** Required. The name of the project in which to create the instance configuration. Values are of the form `projects/`. */
1634
1647
  parent: string;
1635
1648
  /** Returns response with indentations and line breaks. */
1636
1649
  prettyPrint?: boolean;
@@ -1643,7 +1656,7 @@ declare namespace gapi.client {
1643
1656
  },
1644
1657
  body: CreateInstanceConfigRequest
1645
1658
  ): Request<Operation>;
1646
- /** Deletes the instance config. Deletion is only allowed when no instances are using the configuration. If any instances are using the config, returns `FAILED_PRECONDITION`. Only user-managed configurations can be deleted. Authorization requires `spanner.instanceConfigs.delete` permission on the resource name. */
1659
+ /** Deletes the instance configuration. Deletion is only allowed when no instances are using the configuration. If any instances are using the configuration, returns `FAILED_PRECONDITION`. Only user-managed configurations can be deleted. Authorization requires `spanner.instanceConfigs.delete` permission on the resource name. */
1647
1660
  delete(request?: {
1648
1661
  /** V1 error format. */
1649
1662
  '$.xgafv'?: string;
@@ -1653,7 +1666,7 @@ declare namespace gapi.client {
1653
1666
  alt?: string;
1654
1667
  /** JSONP */
1655
1668
  callback?: string;
1656
- /** Used for optimistic concurrency control as a way to help prevent simultaneous deletes of an instance configuration from overwriting each other. If not empty, the API only deletes the instance configuration when the etag provided matches the current status of the requested instance config. Otherwise, deletes the instance configuration without checking the current status of the requested instance config. */
1669
+ /** Used for optimistic concurrency control as a way to help prevent simultaneous deletes of an instance configuration from overwriting each other. If not empty, the API only deletes the instance configuration when the etag provided matches the current status of the requested instance configuration. Otherwise, deletes the instance configuration without checking the current status of the requested instance configuration. */
1657
1670
  etag?: string;
1658
1671
  /** Selector specifying which fields to include in a partial response. */
1659
1672
  fields?: string;
@@ -1732,7 +1745,7 @@ declare namespace gapi.client {
1732
1745
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
1733
1746
  uploadType?: string;
1734
1747
  }): Request<ListInstanceConfigsResponse>;
1735
- /** Updates an instance config. The returned long-running operation can be used to track the progress of updating the instance. If the named instance configuration does not exist, returns `NOT_FOUND`. Only user-managed configurations can be updated. Immediately after the request returns: * The instance config's reconciling field is set to true. While the operation is pending: * Cancelling the operation sets its metadata's cancel_time. The operation is guaranteed to succeed at undoing all changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance configuration are rejected. * Reading the instance configuration via the API continues to give the pre-request values. Upon completion of the returned operation: * Creating instances using the instance configuration uses the new values. * The instance config's new values are readable via the API. * The instance config's reconciling field becomes false. The returned long-running operation will have a name of the format `/operations/` and can be used to track the instance configuration modification. The metadata field type is UpdateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.update` permission on the resource name. */
1748
+ /** Updates an instance configuration. The returned long-running operation can be used to track the progress of updating the instance. If the named instance configuration does not exist, returns `NOT_FOUND`. Only user-managed configurations can be updated. Immediately after the request returns: * The instance configuration's reconciling field is set to true. While the operation is pending: * Cancelling the operation sets its metadata's cancel_time. The operation is guaranteed to succeed at undoing all changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance configuration are rejected. * Reading the instance configuration via the API continues to give the pre-request values. Upon completion of the returned operation: * Creating instances using the instance configuration uses the new values. * The new values of the instance configuration are readable via the API. * The instance configuration's reconciling field becomes false. The returned long-running operation will have a name of the format `/operations/` and can be used to track the instance configuration modification. The metadata field type is UpdateInstanceConfigMetadata. The response field type is InstanceConfig, if successful. Authorization requires `spanner.instanceConfigs.update` permission on the resource name. */
1736
1749
  patch(request: {
1737
1750
  /** V1 error format. */
1738
1751
  '$.xgafv'?: string;
@@ -3677,7 +3690,7 @@ declare namespace gapi.client {
3677
3690
  ): Request<PartialResultSet>;
3678
3691
  }
3679
3692
  interface DatabasesResource {
3680
- /** ChangeQuorum is strictly restricted to databases that use dual region instance configurations. Initiates a background operation to change quorum a database from dual-region mode to single-region mode and vice versa. The returned long-running operation will have a name of the format `projects//instances//databases//operations/` and can be used to track execution of the ChangeQuorum. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database. */
3693
+ /** `ChangeQuorum` is strictly restricted to databases that use dual-region instance configurations. Initiates a background operation to change the quorum of a database from dual-region mode to single-region mode or vice versa. The returned long-running operation has a name of the format `projects//instances//databases//operations/` and can be used to track execution of the `ChangeQuorum`. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database. */
3681
3694
  changequorum(request: {
3682
3695
  /** V1 error format. */
3683
3696
  '$.xgafv'?: string;
@@ -3691,7 +3704,7 @@ declare namespace gapi.client {
3691
3704
  fields?: string;
3692
3705
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
3693
3706
  key?: string;
3694
- /** Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`. */
3707
+ /** Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`. */
3695
3708
  name: string;
3696
3709
  /** OAuth 2.0 token for the current user. */
3697
3710
  oauth_token?: string;
@@ -3720,7 +3733,7 @@ declare namespace gapi.client {
3720
3733
  fields?: string;
3721
3734
  /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
3722
3735
  key?: string;
3723
- /** Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`. */
3736
+ /** Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`. */
3724
3737
  name: string;
3725
3738
  /** OAuth 2.0 token for the current user. */
3726
3739
  oauth_token?: string;
@@ -4868,7 +4881,7 @@ declare namespace gapi.client {
4868
4881
  /** Legacy upload protocol for media (e.g. "media", "multipart"). */
4869
4882
  uploadType?: string;
4870
4883
  }): Request<ListInstancesResponse>;
4871
- /** Moves the instance to the target instance config. The returned long-running operation can be used to track the progress of moving the instance. `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets any of the following criteria: * Has an ongoing move to a different instance config * Has backups * Has an ongoing update * Is under free trial * Contains any CMEK-enabled databases While the operation is pending: * All other attempts to modify the instance, including changes to its compute capacity, are rejected. * The following database and backup admin operations are rejected: * DatabaseAdmin.CreateDatabase, * DatabaseAdmin.UpdateDatabaseDdl (Disabled if default_leader is specified in the request.) * DatabaseAdmin.RestoreDatabase * DatabaseAdmin.CreateBackup * DatabaseAdmin.CopyBackup * Both the source and target instance configurations are subject to hourly compute and storage charges. * The instance may experience higher read-write latencies and a higher transaction abort rate. However, moving an instance does not cause any downtime. The returned long-running operation will have a name of the format `/operations/` and can be used to track the move instance operation. The metadata field type is MoveInstanceMetadata. The response field type is Instance, if successful. Cancelling the operation sets its metadata's cancel_time. Cancellation is not immediate since it involves moving any data previously moved to target instance configuration back to the original instance config. The same operation can be used to track the progress of the cancellation. Upon successful completion of the cancellation, the operation terminates with `CANCELLED` status. Upon completion(if not cancelled) of the returned operation: * Instance would be successfully moved to the target instance config. * You are billed for compute and storage in target instance config. Authorization requires `spanner.instances.update` permission on the resource instance. For more details, please see [documentation](https://cloud.google.com/spanner/docs/move-instance). */
4884
+ /** Moves an instance to the target instance configuration. You can use the returned long-running operation to track the progress of moving the instance. `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets any of the following criteria: * Is undergoing a move to a different instance configuration * Has backups * Has an ongoing update * Contains any CMEK-enabled databases * Is a free trial instance While the operation is pending: * All other attempts to modify the instance, including changes to its compute capacity, are rejected. * The following database and backup admin operations are rejected: * `DatabaseAdmin.CreateDatabase` * `DatabaseAdmin.UpdateDatabaseDdl` (disabled if default_leader is specified in the request.) * `DatabaseAdmin.RestoreDatabase` * `DatabaseAdmin.CreateBackup` * `DatabaseAdmin.CopyBackup` * Both the source and target instance configurations are subject to hourly compute and storage charges. * The instance might experience higher read-write latencies and a higher transaction abort rate. However, moving an instance doesn't cause any downtime. The returned long-running operation has a name of the format `/operations/` and can be used to track the move instance operation. The metadata field type is MoveInstanceMetadata. The response field type is Instance, if successful. Cancelling the operation sets its metadata's cancel_time. Cancellation is not immediate because it involves moving any data previously moved to the target instance configuration back to the original instance configuration. You can use this operation to track the progress of the cancellation. Upon successful completion of the cancellation, the operation terminates with `CANCELLED` status. If not cancelled, upon completion of the returned operation: * The instance successfully moves to the target instance configuration. * You are billed for compute and storage in target instance configuration. Authorization requires the `spanner.instances.update` permission on the resource instance. For more details, see [Move an instance](https://cloud.google.com/spanner/docs/move-instance). */
4872
4885
  move(request: {
4873
4886
  /** V1 error format. */
4874
4887
  '$.xgafv'?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maxim_mazurok/gapi.client.spanner-v1",
3
- "version": "0.0.20240719",
3
+ "version": "0.0.20240807",
4
4
  "description": "TypeScript typings for Cloud Spanner API v1",
5
5
  "repository": {
6
6
  "type": "git",