google-api-python-client 2.195.0__py3-none-any.whl → 2.197.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/spanner.v1.json

@@ -968,7 +968,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The instance of the backup operations. Values are of the form `projects//instances/`.",
+"description": "Required. The instance of the backup operations. Values are of the form `projects/{project}/instances/{instance}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+$",
 "required": true,
@@ -998,7 +998,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects//instances/`.",
+"description": "Required. The name of the destination instance that will contain the backup copy. Values are of the form: `projects/{project}/instances/{instance}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+$",
 "required": true,
@@ -1027,7 +1027,7 @@
 ],
 "parameters": {
 "backupId": {
-"description": "Required. The id of the backup to be created. The `backup_id` appended to `parent` forms the full backup name of the form `projects//instances//backups/`.",
+"description": "Required. The id of the backup to be created. The `backup_id` appended to `parent` forms the full backup name of the form `projects/{project}/instances/{instance}/backups/{backup_id}`.",
 "location": "query",
 "type": "string"
 },
@@ -1049,18 +1049,18 @@
 "type": "string"
 },
 "encryptionConfig.kmsKeyName": {
-"description": "Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.",
+"description": "Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{kms_key_name}`.",
 "location": "query",
 "type": "string"
 },
 "encryptionConfig.kmsKeyNames": {
-"description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.",
+"description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{kms_key_name}`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.",
 "location": "query",
 "repeated": true,
 "type": "string"
 },
 "parent": {
-"description": "Required. The name of the instance in which the backup is created. This must be the same instance that contains the database the backup is created from. The backup will be stored in the locations specified in the instance configuration of this instance. Values are of the form `projects//instances/`.",
+"description": "Required. The name of the instance in which the backup is created. This must be the same instance that contains the database the backup is created from. The backup will be stored in the locations specified in the instance configuration of this instance. Values are of the form `projects/{project}/instances/{instance}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+$",
 "required": true,
@@ -1089,7 +1089,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the backup to delete. Values are of the form `projects//instances//backups/`.",
+"description": "Required. Name of the backup to delete. Values are of the form `projects/{project}/instances/{instance}/backups/{backup}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+/backups/[^/]+$",
 "required": true,
@@ -1115,7 +1115,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the backup. Values are of the form `projects//instances//backups/`.",
+"description": "Required. Name of the backup. Values are of the form `projects/{project}/instances/{instance}/backups/{backup}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+/backups/[^/]+$",
 "required": true,
@@ -1186,7 +1186,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The instance to list backups from. Values are of the form `projects//instances/`.",
+"description": "Required. The instance to list backups from. Values are of the form `projects/{project}/instances/{instance}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+$",
 "required": true,
@@ -1212,7 +1212,7 @@
 ],
 "parameters": {
 "name": {
-"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/`.",
+"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/{project}/instances/{instance}/backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/instances/[^/]+/backups/[^/]+$",
 "required": true,
@@ -3436,7 +3436,7 @@
 }
 }
 },
-"revision": "20260330",
+"revision": "20260501",
 "rootUrl": "https://spanner.googleapis.com/",
 "schemas": {
 "Ack": {
@@ -3676,7 +3676,7 @@
 "type": "string"
 },
 "database": {
-"description": "Required for the CreateBackup operation. Name of the database from which this backup was created. This needs to be in the same instance as the backup. Values are of the form `projects//instances//databases/`.",
+"description": "Required for the CreateBackup operation. Name of the database from which this backup was created. This needs to be in the same instance as the backup. Values are of the form `projects/{project}/instances/{instance}/databases/{database}`.",
 "type": "string"
 },
 "databaseDialect": {
@@ -3761,7 +3761,7 @@
 "type": "string"
 },
 "name": {
-"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/`.",
+"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/{project}/instances/{instance}/backups/a-z*[a-z0-9]` The final segment of the name must be between 2 and 60 characters in length. The backup is stored in the location(s) specified in the instance configuration of the instance containing the backup, identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}`.",
 "type": "string"
 },
 "oldestVersionTime": {
@@ -3771,7 +3771,7 @@
 "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.",
+"description": "Output only. The names of the destination backups being created by copying this source backup. The backup names are of the form `projects/{project}/instances/{instance}/backups/{backup}`. Referencing backups may exist in different instances. The existence of any referencing backup prevents the backup from being deleted. When the copy operation is done (either successfully completed or cancelled or the destination backup is deleted), the reference to the backup is removed.",
 "items": {
 "type": "string"
 },
@@ -3779,7 +3779,7 @@
 "type": "array"
 },
 "referencingDatabases": {
-"description": "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.",
+"description": "Output only. The names of the restored databases that reference the backup. The database names are of the form `projects/{project}/instances/{instance}/databases/{database}`. Referencing databases may exist in different instances. The existence of any referencing database prevents the backup from being deleted. When a restored database from the backup enters the `READY` state, the reference to the backup is removed.",
 "items": {
 "type": "string"
 },
@@ -3845,7 +3845,7 @@
 "id": "BackupInstancePartition",
 "properties": {
 "instancePartition": {
-"description": "A unique identifier for the instance partition. Values are of the form `projects//instances//instancePartitions/`",
+"description": "A unique identifier for the instance partition. Values are of the form `projects/{project}/instances/{instance}/instancePartitions/{instance_partition_id}`",
 "type": "string"
 }
 },
@@ -4301,11 +4301,11 @@
 "type": "string"
 },
 "kmsKeyName": {
-"description": "Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.",
+"description": "Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{kms_key_name}`.",
 "type": "string"
 },
 "kmsKeyNames": {
-"description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.",
+"description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{kms_key_name}`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.",
 "items": {
 "type": "string"
 },
@@ -4324,7 +4324,7 @@
 "type": "string"
 },
 "name": {
-"description": "The name of the backup being created through the copy operation. Values are of the form `projects//instances//backups/`.",
+"description": "The name of the backup being created through the copy operation. Values are of the form `projects/{project}/instances/{instance}/backups/{backup}`.",
 "type": "string"
 },
 "progress": {
@@ -4332,7 +4332,7 @@
 "description": "The progress of the CopyBackup operation."
 },
 "sourceBackup": {
-"description": "The name of the source backup that is being copied. Values are of the form `projects//instances//backups/`.",
+"description": "The name of the source backup that is being copied. Values are of the form `projects/{project}/instances/{instance}/backups/{backup}`.",
 "type": "string"
 }
 },
@@ -4343,7 +4343,7 @@
 "id": "CopyBackupRequest",
 "properties": {
 "backupId": {
-"description": "Required. The id of the backup copy. The `backup_id` appended to `parent` forms the full backup_uri of the form `projects//instances//backups/`.",
+"description": "Required. The id of the backup copy. The `backup_id` appended to `parent` forms the full backup_uri of the form `projects/{project}/instances/{instance}/backups/{backup}`.",
 "type": "string"
 },
 "encryptionConfig": {
@@ -4356,7 +4356,7 @@
 "type": "string"
 },
 "sourceBackup": {
-"description": "Required. The source backup to be copied. The source backup needs to be in READY state for it to be copied. Once CopyBackup is in progress, the source backup cannot be deleted or cleaned up on expiration until CopyBackup is finished. Values are of the form: `projects//instances//backups/`.",
+"description": "Required. The source backup to be copied. The source backup needs to be in READY state for it to be copied. Once CopyBackup is in progress, the source backup cannot be deleted or cleaned up on expiration until CopyBackup is finished. Values are of the form: `projects/{project}/instances/{instance}/backups/{backup}`.",
 "type": "string"
 }
 },
@@ -4383,11 +4383,11 @@
 "type": "string"
 },
 "kmsKeyName": {
-"description": "Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//keyRings//cryptoKeys/`.",
+"description": "Optional. This field is maintained for backwards compatibility. For new callers, we recommend using `kms_key_names` to specify the KMS key. Only use `kms_key_name` if the location of the KMS key matches the database instance's configuration (location) exactly. For example, if the KMS location is in `us-central1` or `nam3`, then the database instance must also be in `us-central1` or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored database. Set this field only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{kms_key_name}`.",
 "type": "string"
 },
 "kmsKeyNames": {
-"description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.",
+"description": "Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{kms_key_name}`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.",
 "items": {
 "type": "string"
 },