google-api-python-client 2.140.0__py2.py3-none-any.whl → 2.142.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/spanner.v1.json

@@ -26,6 +26,11 @@
 "description": "Regional Endpoint",
 "endpointUrl": "https://spanner.me-central2.rep.googleapis.com/",
 "location": "me-central2"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://spanner.us-west1.rep.googleapis.com/",
+"location": "us-west1"
 }
 ],
 "fullyEncodeReservedExpansion": true,
@@ -169,7 +174,7 @@
 "instanceConfigs": {
 "methods": {
 "create": {
-"description": "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.",
+"description": "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.",
 "flatPath": "v1/projects/{projectsId}/instanceConfigs",
 "httpMethod": "POST",
 "id": "spanner.projects.instanceConfigs.create",
@@ -178,7 +183,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The name of the project in which to create the instance config. Values are of the form `projects/`.",
+"description": "Required. The name of the project in which to create the instance configuration. Values are of the form `projects/`.",
 "location": "path",
 "pattern": "^projects/[^/]+$",
 "required": true,
@@ -198,7 +203,7 @@
 ]
 },
 "delete": {
-"description": "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.",
+"description": "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.",
 "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}",
 "httpMethod": "DELETE",
 "id": "spanner.projects.instanceConfigs.delete",
@@ -207,7 +212,7 @@
 ],
 "parameters": {
 "etag": {
-"description": "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.",
+"description": "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.",
 "location": "query",
 "type": "string"
 },
@@ -297,7 +302,7 @@
 ]
 },
 "patch": {
-"description": "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.",
+"description": "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.",
 "flatPath": "v1/projects/{projectsId}/instanceConfigs/{instanceConfigsId}",
 "httpMethod": "PATCH",
 "id": "spanner.projects.instanceConfigs.patch",
@@ -748,7 +753,7 @@
 ]
 },
 "move": {
-"description": "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).",
+"description": "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).",
 "flatPath": "v1/projects/{projectsId}/instances/{instancesId}:move",
 "httpMethod": "POST",
 "id": "spanner.projects.instances.move",
@@ -1397,7 +1402,7 @@
 "databases": {
 "methods": {
 "changequorum": {
-"description": "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.",
+"description": "`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.",
 "flatPath": "v1/projects/{projectsId}/instances/{instancesId}/databases/{databasesId}:changequorum",
 "httpMethod": "POST",
 "id": "spanner.projects.instances.databases.changequorum",
@@ -1406,7 +1411,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`.",
+"description": "Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
 "required": true,
@@ -3254,7 +3259,7 @@
 }
 }
 },
-"revision": "20240719",
+"revision": "20240807",
 "rootUrl": "https://spanner.googleapis.com/",
 "schemas": {
 "AutoscalingConfig": {
@@ -3366,11 +3371,28 @@
 "readOnly": true,
 "type": "array"
 },
+"exclusiveSizeBytes": {
+"description": "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.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
 "expireTime": {
 "description": "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.",
 "format": "google-datetime",
 "type": "string"
 },
+"freeableSizeBytes": {
+"description": "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.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"incrementalBackupChainId": {
+"description": "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`.",
+"readOnly": true,
+"type": "string"
+},
 "maxExpireTime": {
 "description": "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`.",
 "format": "google-datetime",
@@ -3381,6 +3403,12 @@
 "description": "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/`.",
 "type": "string"
 },
+"oldestVersionTime": {
+"description": "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.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
 "referencingBackups": {
 "description": "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.",
 "items": {
@@ -3398,7 +3426,7 @@
 "type": "array"
 },
 "sizeBytes": {
-"description": "Output only. Size of the backup in bytes.",
+"description": "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.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
@@ -3463,6 +3491,10 @@
 "$ref": "FullBackupSpec",
 "description": "The schedule creates only full backups."
 },
+"incrementalBackupSpec": {
+"$ref": "IncrementalBackupSpec",
+"description": "The schedule creates incremental backup chains."
+},
 "name": {
 "description": "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.",
 "type": "string"
@@ -3635,16 +3667,16 @@
 "id": "ChangeQuorumRequest",
 "properties": {
 "etag": {
-"description": "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.",
+"description": "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.",
 "type": "string"
 },
 "name": {
-"description": "Required. Name of the database in which to apply the ChangeQuorum. Values are of the form `projects//instances//databases/`.",
+"description": "Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.",
 "type": "string"
 },
 "quorumType": {
 "$ref": "QuorumType",
-"description": "Required. The type of this Quorum."
+"description": "Required. The type of this quorum."
 }
 },
 "type": "object"
@@ -3989,7 +4021,7 @@
 "properties": {
 "instanceConfig": {
 "$ref": "InstanceConfig",
-"description": "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."
+"description": "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."
 },
 "instanceConfigId": {
 "description": "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.",
@@ -4190,7 +4222,7 @@
 },
 "quorumInfo": {
 "$ref": "QuorumInfo",
-"description": "Output only. Applicable only for databases that use dual region instance configurations. Contains information about the quorum.",
+"description": "Output only. Applicable only for databases that use dual-region instance configurations. Contains information about the quorum.",
 "readOnly": true
 },
 "reconciling": {
@@ -4680,6 +4712,12 @@
 },
 "type": "object"
 },
+"IncrementalBackupSpec": {
+"description": "The specification for incremental backup chains. An incremental backup stores the delta of changes between a previous backup and the database contents at a given version time. An incremental backup chain consists of a full backup and zero or more successive incremental backups. The first backup created for an incremental backup chain is always a full backup.",
+"id": "IncrementalBackupSpec",
+"properties": {},
+"type": "object"
+},
 "IndexAdvice": {
 "description": "Recommendation to add new indexes to run queries more efficiently.",
 "id": "IndexAdvice",
@@ -4750,6 +4788,22 @@
 "description": "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.",
 "type": "string"
 },
+"edition": {
+"description": "Optional. The `Edition` of the current instance.",
+"enum": [
+"EDITION_UNSPECIFIED",
+"STANDARD",
+"ENTERPRISE",
+"ENTERPRISE_PLUS"
+],
+"enumDescriptions": [
+"Edition not specified.",
+"Standard edition.",
+"Enterprise edition.",
+"Enterprise Plus edition."
+],
+"type": "string"
+},
 "endpointUris": {
 "description": "Deprecated. This field is not populated.",
 "items": {
@@ -4787,12 +4841,12 @@
 "type": "string"
 },
 "nodeCount": {
-"description": "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).",
+"description": "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).",
 "format": "int32",
 "type": "integer"
 },
 "processingUnits": {
-"description": "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.",
+"description": "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).",
 "format": "int32",
 "type": "integer"
 },
@@ -4829,7 +4883,7 @@
 "type": "string"
 },
 "configType": {
-"description": "Output only. Whether this instance configuration is a Google- or user-managed configuration.",
+"description": "Output only. Whether this instance configuration is a Google-managed or user-managed configuration.",
 "enum": [
 "TYPE_UNSPECIFIED",
 "GOOGLE_MANAGED",
@@ -4852,7 +4906,7 @@
 "type": "string"
 },
 "freeInstanceAvailability": {
-"description": "Output only. Describes whether free instances are available to be created in this instance config.",
+"description": "Output only. Describes whether free instances are available to be created in this instance configuration.",
 "enum": [
 "FREE_INSTANCE_AVAILABILITY_UNSPECIFIED",
 "AVAILABLE",
@@ -4862,9 +4916,9 @@
 ],
 "enumDescriptions": [
 "Not specified.",
-"Indicates that free instances are available to be created in this instance config.",
-"Indicates that free instances are not supported in this instance config.",
-"Indicates that free instances are currently not available to be created in this instance config.",
+"Indicates that free instances are available to be created in this instance configuration.",
+"Indicates that free instances are not supported in this instance configuration.",
+"Indicates that free instances are currently not available to be created in this instance configuration.",
 "Indicates that additional free instances cannot be created in this instance configuration because the project has reached its limit of free instances."
 ],
 "readOnly": true,
@@ -4905,16 +4959,16 @@
 "MULTI_REGION"
 ],
 "enumDescriptions": [
-"Not specified.",
-"An instance configuration tagged with REGION quorum type forms a write quorum in a single region.",
-"An instance configuration tagged with DUAL_REGION quorum type forms a write quorums with exactly two read-write regions in a multi-region configuration. This instance configurations requires reconfiguration in the event of regional failures.",
-"An instance configuration tagged with MULTI_REGION quorum type forms a write quorums from replicas are spread across more than one region in a multi-region configuration."
+"Quorum type not specified.",
+"An instance configuration tagged with `REGION` quorum type forms a write quorum in a single region.",
+"An instance configuration tagged with the `DUAL_REGION` quorum type forms a write quorum with exactly two read-write regions in a multi-region configuration. This instance configuration requires failover in the event of regional failures.",
+"An instance configuration tagged with the `MULTI_REGION` quorum type forms a write quorum from replicas that are spread across more than one region in a multi-region configuration."
 ],
 "readOnly": true,
 "type": "string"
 },
 "reconciling": {
-"description": "Output only. If true, the instance configuration is being created or updated. If false, there are no ongoing operations for the instance config.",
+"description": "Output only. If true, the instance configuration is being created or updated. If false, there are no ongoing operations for the instance configuration.",
 "readOnly": true,
 "type": "boolean"
 },
@@ -5008,7 +5062,8 @@
 "type": "integer"
 },
 "referencingBackups": {
-"description": "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.",
+"deprecated": true,
+"description": "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.",
 "items": {
 "type": "string"
 },
@@ -5297,7 +5352,7 @@
 "type": "string"
 },
 "operations": {
-"description": "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.",
+"description": "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.",
 "items": {
 "$ref": "Operation"
 },
@@ -5581,7 +5636,7 @@
 "id": "MoveInstanceRequest",
 "properties": {
 "targetConfig": {
-"description": "Required. The target instance configuration for the instance to move. Values are of the form `projects//instanceConfigs/`.",
+"description": "Required. The target instance configuration where to move the instance. Values are of the form `projects//instanceConfigs/`.",
 "type": "string"
 }
 },
@@ -6011,16 +6066,16 @@
 "type": "object"
 },
 "QuorumInfo": {
-"description": "Information about the dual region quorum.",
+"description": "Information about the dual-region quorum.",
 "id": "QuorumInfo",
 "properties": {
 "etag": {
-"description": "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.",
+"description": "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.",
 "readOnly": true,
 "type": "string"
 },
 "initiator": {
-"description": "Output only. Whether this ChangeQuorum is a Google or User initiated.",
+"description": "Output only. Whether this `ChangeQuorum` is Google or User initiated.",
 "enum": [
 "INITIATOR_UNSPECIFIED",
 "GOOGLE",
@@ -6028,8 +6083,8 @@
 ],
 "enumDescriptions": [
 "Unspecified.",
-"ChangeQuorum initiated by Google.",
-"ChangeQuorum initiated by User."
+"`ChangeQuorum` initiated by Google.",
+"`ChangeQuorum` initiated by User."
 ],
 "readOnly": true,
 "type": "string"
@@ -6049,16 +6104,16 @@
 "type": "object"
 },
 "QuorumType": {
-"description": "Information about the database quorum type. this applies only for dual region instance configs.",
+"description": "Information about the database quorum type. This only applies to dual-region instance configs.",
 "id": "QuorumType",
 "properties": {
 "dualRegion": {
 "$ref": "DualRegionQuorum",
-"description": "Dual region quorum type."
+"description": "Dual-region quorum type."
 },
 "singleRegion": {
 "$ref": "SingleRegionQuorum",
-"description": "Single region quorum type."
+"description": "Single-region quorum type."
 }
 },
 "type": "object"
@@ -6620,7 +6675,7 @@
 "id": "SingleRegionQuorum",
 "properties": {
 "servingLocation": {
-"description": "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.",
+"description": "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.",
 "type": "string"
 }
 },

googleapiclient/discovery_cache/documents/storage.v1.json

@@ -43,7 +43,7 @@
 "location": "me-central2"
 }
 ],
-"etag": "\"323732353932323032353837333633313231\"",
+"etag": "\"34373939373134303235393739323331393435\"",
 "icons": {
 "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png",
 "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png"
@@ -560,7 +560,7 @@
 "buckets": {
 "methods": {
 "delete": {
-"description": "Permanently deletes an empty bucket.",
+"description": "Deletes an empty bucket. Deletions are permanent unless soft delete is enabled on the bucket.",
 "httpMethod": "DELETE",
 "id": "storage.buckets.delete",
 "parameterOrder": [
@@ -612,6 +612,12 @@
 "required": true,
 "type": "string"
 },
+"generation": {
+"description": "If present, specifies the generation of the bucket. This is required if softDeleted is true.",
+"format": "int64",
+"location": "query",
+"type": "string"
+},
 "ifMetagenerationMatch": {
 "description": "Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value.",
 "format": "int64",
@@ -637,6 +643,11 @@
 "location": "query",
 "type": "string"
 },
+"softDeleted": {
+"description": "If true, return the soft-deleted version of this bucket. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).",
+"location": "query",
+"type": "boolean"
+},
 "userProject": {
 "description": "The project to be billed for this request. Required for Requester Pays buckets.",
 "location": "query",
@@ -860,6 +871,11 @@
 "location": "query",
 "type": "string"
 },
+"softDeleted": {
+"description": "If true, only soft-deleted bucket versions will be returned. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).",
+"location": "query",
+"type": "boolean"
+},
 "userProject": {
 "description": "The project to be billed for this request.",
 "location": "query",
@@ -1013,6 +1029,41 @@
 "https://www.googleapis.com/auth/devstorage.full_control"
 ]
 },
+"restore": {
+"description": "Restores a soft-deleted bucket.",
+"httpMethod": "POST",
+"id": "storage.buckets.restore",
+"parameterOrder": [
+"bucket",
+"generation"
+],
+"parameters": {
+"bucket": {
+"description": "Name of a bucket.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"generation": {
+"description": "Generation of a bucket.",
+"format": "int64",
+"location": "query",
+"required": true,
+"type": "string"
+},
+"userProject": {
+"description": "The project to be billed for this request. Required for Requester Pays buckets.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "b/{bucket}/restore",
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/devstorage.full_control",
+"https://www.googleapis.com/auth/devstorage.read_write"
+]
+},
 "setIamPolicy": {
 "description": "Updates an IAM policy for the specified bucket.",
 "httpMethod": "PUT",
@@ -2779,7 +2830,7 @@
 "type": "string"
 },
 "softDeleted": {
-"description": "If true, only soft-deleted object versions will be listed. The default is false. For more information, see Soft Delete.",
+"description": "If true, only soft-deleted object versions will be listed. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).",
 "location": "query",
 "type": "boolean"
 },
@@ -3041,7 +3092,7 @@
 "type": "string"
 },
 "softDeleted": {
-"description": "If true, only soft-deleted object versions will be listed. The default is false. For more information, see Soft Delete.",
+"description": "If true, only soft-deleted object versions will be listed. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).",
 "location": "query",
 "type": "boolean"
 },
@@ -3056,7 +3107,7 @@
 "type": "string"
 },
 "versions": {
-"description": "If true, lists all versions of an object as distinct results. The default is false. For more information, see Object Versioning.",
+"description": "If true, lists all versions of an object as distinct results. The default is false. For more information, see [Object Versioning](https://cloud.google.com/storage/docs/object-versioning).",
 "location": "query",
 "type": "boolean"
 }
@@ -3235,7 +3286,7 @@
 "type": "string"
 },
 "object": {
-"description": "Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.",
+"description": "Name of the object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).",
 "location": "path",
 "required": true,
 "type": "string"
@@ -3704,7 +3755,7 @@
 "type": "string"
 },
 "versions": {
-"description": "If true, lists all versions of an object as distinct results. The default is false. For more information, see Object Versioning.",
+"description": "If true, lists all versions of an object as distinct results. The default is false. For more information, see [Object Versioning](https://cloud.google.com/storage/docs/object-versioning).",
 "location": "query",
 "type": "boolean"
 }
@@ -4006,7 +4057,7 @@
 ]
 },
 "update": {
-"description": "Updates the state of an HMAC key. See the HMAC Key resource descriptor for valid states.",
+"description": "Updates the state of an HMAC key. See the [HMAC Key resource descriptor](https://cloud.google.com/storage/docs/json_api/v1/projects/hmacKeys/update#request-body) for valid states.",
 "httpMethod": "PUT",
 "id": "storage.projects.hmacKeys.update",
 "parameterOrder": [
@@ -4085,7 +4136,7 @@
 }
 }
 },
-"revision": "20240706",
+"revision": "20240809",
 "rootUrl": "https://storage.googleapis.com/",
 "schemas": {
 "AnywhereCache": {
@@ -4293,6 +4344,11 @@
 "description": "HTTP 1.1 Entity tag for the bucket.",
 "type": "string"
 },
+"generation": {
+"description": "The generation of this bucket.",
+"format": "int64",
+"type": "string"
+},
 "hierarchicalNamespace": {
 "description": "The bucket's hierarchical namespace configuration.",
 "properties": {
@@ -4404,7 +4460,7 @@
 "type": "object"
 },
 "lifecycle": {
-"description": "The bucket's lifecycle configuration. See lifecycle management for more information.",
+"description": "The bucket's lifecycle configuration. See [Lifecycle Management](https://cloud.google.com/storage/docs/lifecycle) for more information.",
 "properties": {
 "rule": {
 "description": "A lifecycle management rule, which is made of an action to take and the condition(s) under which the action will be taken.",
@@ -4503,7 +4559,7 @@
 "type": "object"
 },
 "location": {
-"description": "The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the developer's guide for the authoritative list.",
+"description": "The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the [Developer's Guide](https://cloud.google.com/storage/docs/locations) for the authoritative list.",
 "type": "string"
 },
 "locationType": {
@@ -4591,6 +4647,10 @@
 "description": "The Recovery Point Objective (RPO) of this bucket. Set to ASYNC_TURBO to turn on Turbo Replication on a bucket.",
 "type": "string"
 },
+"satisfiesPZI": {
+"description": "Reserved for future use.",
+"type": "boolean"
+},
 "satisfiesPZS": {
 "description": "Reserved for future use.",
 "type": "boolean"
@@ -4616,7 +4676,7 @@
 "type": "object"
 },
 "storageClass": {
-"description": "The bucket's default storage class, used whenever no storageClass is specified for a newly-created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, ARCHIVE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see storage classes.",
+"description": "The bucket's default storage class, used whenever no storageClass is specified for a newly-created object. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include MULTI_REGIONAL, REGIONAL, STANDARD, NEARLINE, COLDLINE, ARCHIVE, and DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket is created, it will default to STANDARD. For more information, see [Storage Classes](https://cloud.google.com/storage/docs/storage-classes).",
 "type": "string"
 },
 "timeCreated": {
@@ -4640,7 +4700,7 @@
 "type": "object"
 },
 "website": {
-"description": "The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site. See the Static Website Examples for more information.",
+"description": "The bucket's website configuration, controlling how the service behaves when accessing bucket contents as a web site. See the [Static Website Examples](https://cloud.google.com/storage/docs/static-website) for more information.",
 "properties": {
 "mainPageSuffix": {
 "description": "If the requested object path is missing, the service will ensure the path has a trailing '/', append this suffix, and attempt to retrieve the resulting object. This allows the creation of index.html objects to represent directory pages.",
@@ -5435,7 +5495,7 @@
 "type": "string"
 },
 "crc32c": {
-"description": "CRC32c checksum, as described in RFC 4960, Appendix B; encoded using base64 in big-endian byte order. For more information about using the CRC32c checksum, see Hashes and ETags: Best Practices.",
+"description": "CRC32c checksum, as described in RFC 4960, Appendix B; encoded using base64 in big-endian byte order. For more information about using the CRC32c checksum, see [Data Validation and Change Detection](https://cloud.google.com/storage/docs/data-validation).",
 "type": "string"
 },
 "customTime": {
@@ -5489,7 +5549,7 @@
 "type": "string"
 },
 "md5Hash": {
-"description": "MD5 hash of the data; encoded using base64. For more information about using the MD5 hash, see Hashes and ETags: Best Practices.",
+"description": "MD5 hash of the data; encoded using base64. For more information about using the MD5 hash, see [Data Validation and Change Detection](https://cloud.google.com/storage/docs/data-validation).",
 "type": "string"
 },
 "mediaLink": {