google-api-python-client 2.141.0__py2.py3-none-any.whl → 2.143.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/serviceusage.v1.json

@@ -426,7 +426,7 @@
 }
 }
 },
-"revision": "20240712",
+"revision": "20240811",
 "rootUrl": "https://serviceusage.googleapis.com/",
 "schemas": {
 "AddEnableRulesMetadata": {
@@ -488,6 +488,83 @@
 },
 "type": "object"
 },
+"Analysis": {
+"description": "A message to group the analysis information.",
+"id": "Analysis",
+"properties": {
+"analysis": {
+"$ref": "AnalysisResult",
+"description": "Output only. Analysis result of updating a policy.",
+"readOnly": true
+},
+"analysisType": {
+"description": "Output only. The type of analysis.",
+"enum": [
+"ANALYSIS_TYPE_UNSPECIFIED",
+"ANALYSIS_TYPE_DEPENDENCY",
+"ANALYSIS_TYPE_RESOURCE_USAGE"
+],
+"enumDescriptions": [
+"Unspecified analysis type. Do not use.",
+"The analysis of service dependencies.",
+"The analysis of service resource usage."
+],
+"readOnly": true,
+"type": "string"
+},
+"displayName": {
+"description": "Output only. The user friendly display name of the analysis type. E.g. service dependency analysis, service resource usage analysis, etc.",
+"readOnly": true,
+"type": "string"
+},
+"service": {
+"description": "The names of the service that has analysis result of warnings or blockers. Example: `services/storage.googleapis.com`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AnalysisResult": {
+"description": "An analysis result including blockers and warnings.",
+"id": "AnalysisResult",
+"properties": {
+"blockers": {
+"description": "Blocking information that would prevent the policy changes at runtime.",
+"items": {
+"$ref": "Impact"
+},
+"type": "array"
+},
+"warnings": {
+"description": "Warning information indicating that the policy changes might be unsafe, but will not block the changes at runtime.",
+"items": {
+"$ref": "Impact"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"AnalyzeConsumerPolicyMetadata": {
+"description": "Metadata for the `AnalyzeConsumerPolicy` method.",
+"id": "AnalyzeConsumerPolicyMetadata",
+"properties": {},
+"type": "object"
+},
+"AnalyzeConsumerPolicyResponse": {
+"description": "The response of analyzing a consumer policy update.",
+"id": "AnalyzeConsumerPolicyResponse",
+"properties": {
+"analysis": {
+"description": "The list of analyses returned from performing the intended policy update analysis. The analysis is grouped by service name and different analysis types. The empty analysis list means that the consumer policy can be updated without any warnings or blockers.",
+"items": {
+"$ref": "Analysis"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "Api": {
 "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.",
 "id": "Api",
@@ -2020,6 +2097,31 @@
 },
 "type": "object"
 },
+"Impact": {
+"description": "A message to group impacts of updating a policy.",
+"id": "Impact",
+"properties": {
+"detail": {
+"description": "Output only. User friendly impact detail in a free form message.",
+"readOnly": true,
+"type": "string"
+},
+"impactType": {
+"description": "Output only. The type of impact.",
+"enum": [
+"IMPACT_TYPE_UNSPECIFIED",
+"DEPENDENCY_MISSING_DEPENDENCIES"
+],
+"enumDescriptions": [
+"Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...",
+"Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY"
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "ImportAdminOverridesMetadata": {
 "description": "Metadata message that provides information such as progress, partial failures, and similar information on each GetOperation call of LRO returned by ImportAdminOverrides.",
 "id": "ImportAdminOverridesMetadata",

googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json

@@ -964,7 +964,7 @@
 }
 }
 },
-"revision": "20240712",
+"revision": "20240811",
 "rootUrl": "https://serviceusage.googleapis.com/",
 "schemas": {
 "AddEnableRulesMetadata": {
@@ -1026,6 +1026,83 @@
 },
 "type": "object"
 },
+"Analysis": {
+"description": "A message to group the analysis information.",
+"id": "Analysis",
+"properties": {
+"analysis": {
+"$ref": "AnalysisResult",
+"description": "Output only. Analysis result of updating a policy.",
+"readOnly": true
+},
+"analysisType": {
+"description": "Output only. The type of analysis.",
+"enum": [
+"ANALYSIS_TYPE_UNSPECIFIED",
+"ANALYSIS_TYPE_DEPENDENCY",
+"ANALYSIS_TYPE_RESOURCE_USAGE"
+],
+"enumDescriptions": [
+"Unspecified analysis type. Do not use.",
+"The analysis of service dependencies.",
+"The analysis of service resource usage."
+],
+"readOnly": true,
+"type": "string"
+},
+"displayName": {
+"description": "Output only. The user friendly display name of the analysis type. E.g. service dependency analysis, service resource usage analysis, etc.",
+"readOnly": true,
+"type": "string"
+},
+"service": {
+"description": "The names of the service that has analysis result of warnings or blockers. Example: `services/storage.googleapis.com`.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"AnalysisResult": {
+"description": "An analysis result including blockers and warnings.",
+"id": "AnalysisResult",
+"properties": {
+"blockers": {
+"description": "Blocking information that would prevent the policy changes at runtime.",
+"items": {
+"$ref": "Impact"
+},
+"type": "array"
+},
+"warnings": {
+"description": "Warning information indicating that the policy changes might be unsafe, but will not block the changes at runtime.",
+"items": {
+"$ref": "Impact"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"AnalyzeConsumerPolicyMetadata": {
+"description": "Metadata for the `AnalyzeConsumerPolicy` method.",
+"id": "AnalyzeConsumerPolicyMetadata",
+"properties": {},
+"type": "object"
+},
+"AnalyzeConsumerPolicyResponse": {
+"description": "The response of analyzing a consumer policy update.",
+"id": "AnalyzeConsumerPolicyResponse",
+"properties": {
+"analysis": {
+"description": "The list of analyses returned from performing the intended policy update analysis. The analysis is grouped by service name and different analysis types. The empty analysis list means that the consumer policy can be updated without any warnings or blockers.",
+"items": {
+"$ref": "Analysis"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "Api": {
 "description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.",
 "id": "Api",
@@ -2597,6 +2674,31 @@
 },
 "type": "object"
 },
+"Impact": {
+"description": "A message to group impacts of updating a policy.",
+"id": "Impact",
+"properties": {
+"detail": {
+"description": "Output only. User friendly impact detail in a free form message.",
+"readOnly": true,
+"type": "string"
+},
+"impactType": {
+"description": "Output only. The type of impact.",
+"enum": [
+"IMPACT_TYPE_UNSPECIFIED",
+"DEPENDENCY_MISSING_DEPENDENCIES"
+],
+"enumDescriptions": [
+"Reserved Blocks (Block n contains codes from 100n to 100(n+1) -1 Block 0 - Special/Admin codes Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY Block 2 - Impact Type of ANALYSIS_TYPE_RESOURCE_USAGE ...",
+"Block 1 - Impact Type of ANALYSIS_TYPE_DEPENDENCY"
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "ImportAdminOverridesMetadata": {
 "description": "Metadata message that provides information such as progress, partial failures, and similar information on each GetOperation call of LRO returned by ImportAdminOverrides.",
 "id": "ImportAdminOverridesMetadata",

googleapiclient/discovery_cache/documents/solar.v1.json

@@ -114,6 +114,20 @@
 "id": "solar.buildingInsights.findClosest",
 "parameterOrder": [],
 "parameters": {
+"experiments": {
+"description": "Optional. Specifies the pre-GA features to enable.",
+"enum": [
+"EXPERIMENT_UNSPECIFIED",
+"EXPANDED_COVERAGE"
+],
+"enumDescriptions": [
+"No experiments are specified.",
+"Expands the geographic region available for querying solar data."
+],
+"location": "query",
+"repeated": true,
+"type": "string"
+},
 "location.latitude": {
 "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].",
 "format": "double",
@@ -132,12 +146,14 @@
 "IMAGERY_QUALITY_UNSPECIFIED",
 "HIGH",
 "MEDIUM",
-"LOW"
+"LOW",
+"BASE"
 ],
 "enumDescriptions": [
 "No quality is known.",
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "location": "query",
@@ -168,6 +184,20 @@
 "location": "query",
 "type": "boolean"
 },
+"experiments": {
+"description": "Optional. Specifies the pre-GA experiments to enable.",
+"enum": [
+"EXPERIMENT_UNSPECIFIED",
+"EXPANDED_COVERAGE"
+],
+"enumDescriptions": [
+"No experiments are specified.",
+"Expands the geographic region available for querying solar data."
+],
+"location": "query",
+"repeated": true,
+"type": "string"
+},
 "location.latitude": {
 "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].",
 "format": "double",
@@ -198,12 +228,14 @@
 "IMAGERY_QUALITY_UNSPECIFIED",
 "HIGH",
 "MEDIUM",
-"LOW"
+"LOW",
+"BASE"
 ],
 "enumDescriptions": [
 "No quality is known.",
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "location": "query",
@@ -267,7 +299,7 @@
 }
 }
 },
-"revision": "20240707",
+"revision": "20240820",
 "rootUrl": "https://solar.googleapis.com/",
 "schemas": {
 "BuildingInsights": {
@@ -300,12 +332,14 @@
 "IMAGERY_QUALITY_UNSPECIFIED",
 "HIGH",
 "MEDIUM",
-"LOW"
+"LOW",
+"BASE"
 ],
 "enumDescriptions": [
 "No quality is known.",
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "type": "string"
@@ -394,12 +428,14 @@
 "IMAGERY_QUALITY_UNSPECIFIED",
 "HIGH",
 "MEDIUM",
-"LOW"
+"LOW",
+"BASE"
 ],
 "enumDescriptions": [
 "No quality is known.",
 "Solar data is derived from aerial imagery captured at low-altitude and processed at 0.1 m/pixel.",
 "Solar data is derived from enhanced aerial imagery captured at high-altitude and processed at 0.25 m/pixel.",
+"Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel.",
 "Solar data is derived from enhanced satellite imagery processed at 0.25 m/pixel."
 ],
 "type": "string"

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",
@@ -1095,7 +1100,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "An expression that filters the list of returned backups. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Backup are eligible for filtering: * `name` * `database` * `state` * `create_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `version_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `size_bytes` You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `name:Howl` - The backup's name contains the string \"howl\". * `database:prod` - The database's name contains the string \"prod\". * `state:CREATING` - The backup is pending creation. * `state:READY` - The backup is fully created and ready for use. * `(name:howl) AND (create_time < \\\"2018-03-28T14:50:00Z\\\")` - The backup name contains the string \"howl\" and `create_time` of the backup is before 2018-03-28T14:50:00Z. * `expire_time < \\\"2018-03-28T14:50:00Z\\\"` - The backup `expire_time` is before 2018-03-28T14:50:00Z. * `size_bytes > 10000000000` - The backup's size is greater than 10GB",
+"description": "An expression that filters the list of returned backups. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Backup are eligible for filtering: * `name` * `database` * `state` * `create_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `version_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `size_bytes` * `backup_schedules` You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `name:Howl` - The backup's name contains the string \"howl\". * `database:prod` - The database's name contains the string \"prod\". * `state:CREATING` - The backup is pending creation. * `state:READY` - The backup is fully created and ready for use. * `(name:howl) AND (create_time < \\\"2018-03-28T14:50:00Z\\\")` - The backup name contains the string \"howl\" and `create_time` of the backup is before 2018-03-28T14:50:00Z. * `expire_time < \\\"2018-03-28T14:50:00Z\\\"` - The backup `expire_time` is before 2018-03-28T14:50:00Z. * `size_bytes > 10000000000` - The backup's size is greater than 10GB * `backup_schedules:daily` - The backup is created from a schedule with \"daily\" in its name.",
 "location": "query",
 "type": "string"
 },
@@ -3254,7 +3259,7 @@
 }
 }
 },
-"revision": "20240731",
+"revision": "20240814",
 "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"
@@ -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.",
@@ -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,
@@ -4914,7 +4968,7 @@
 "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"
 },
@@ -5298,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"
 },
@@ -5582,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"
 }
 },