Skip to content

Commit 38ea295

Browse files
yoshi-automationyoshi-automation
committed
feat(spanner)!: update the API
BREAKING CHANGE: This release has breaking changes. #### spanner:v1 The following keys were deleted: - schemas.ClientContext.description - schemas.ClientContext.id - schemas.ClientContext.type - schemas.RequestOptions.properties.clientContext.$ref - schemas.RequestOptions.properties.clientContext.description The following keys were added: - schemas.Ack.description - schemas.Ack.id - schemas.Ack.properties.ignoreNotFound.description - schemas.Ack.properties.ignoreNotFound.type - schemas.Ack.properties.key.description - schemas.Ack.properties.key.items.type - schemas.Ack.properties.key.type - schemas.Ack.properties.queue.description - schemas.Ack.properties.queue.type - schemas.Ack.type - schemas.CompactDatabaseMetadata.description - schemas.CompactDatabaseMetadata.id - schemas.CompactDatabaseMetadata.properties.cancelTime.description - schemas.CompactDatabaseMetadata.properties.cancelTime.format - schemas.CompactDatabaseMetadata.properties.cancelTime.readOnly - schemas.CompactDatabaseMetadata.properties.cancelTime.type - schemas.CompactDatabaseMetadata.properties.database.description - schemas.CompactDatabaseMetadata.properties.database.readOnly - schemas.CompactDatabaseMetadata.properties.database.type - schemas.CompactDatabaseMetadata.properties.progress.$ref - schemas.CompactDatabaseMetadata.properties.progress.description - schemas.CompactDatabaseMetadata.properties.progress.readOnly - schemas.CompactDatabaseMetadata.type - schemas.Mutation.properties.ack.$ref - schemas.Mutation.properties.ack.description - schemas.Mutation.properties.send.$ref - schemas.Mutation.properties.send.description - schemas.Send.description - schemas.Send.id - schemas.Send.properties.deliverTime.description - schemas.Send.properties.deliverTime.format - schemas.Send.properties.deliverTime.type - schemas.Send.properties.key.description - schemas.Send.properties.key.items.type - schemas.Send.properties.key.type - schemas.Send.properties.payload.description - schemas.Send.properties.payload.type - schemas.Send.properties.queue.description - schemas.Send.properties.queue.type - schemas.Send.type The following keys were changed: - auth.oauth2.scopes.https://www.googleapis.com/auth/spanner.data.description - resources.projects.resources.instanceConfigs.resources.operations.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.instanceConfigs.resources.ssdCaches.resources.operations.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.instances.resources.backups.resources.operations.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.instances.resources.databases.resources.operations.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.instances.resources.instancePartitions.resources.operations.methods.list.parameters.returnPartialSuccess.description - resources.projects.resources.instances.resources.operations.methods.list.parameters.returnPartialSuccess.description - schemas.ListOperationsResponse.properties.unreachable.description
1 parent 46c47ea commit 38ea295

File tree

2 files changed

+165
-40
lines changed

2 files changed

+165
-40
lines changed

‎discovery/spanner-v1.json‎

Lines changed: 89 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
"description": "Administer your Spanner databases"
1010
},
1111
"https://www.googleapis.com/auth/spanner.data": {
12-
"description": "View and manage the contents of your Spanner databases"
12+
"description": "See, edit, configure, and delete your Google Cloud Spanner data and see the email address for your Google Account"
1313
}
1414
}
1515
}
@@ -505,7 +505,7 @@
505505
"type": "string"
506506
},
507507
"returnPartialSuccess": {
508-
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
508+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
509509
"location": "query",
510510
"type": "boolean"
511511
}
@@ -636,7 +636,7 @@
636636
"type": "string"
637637
},
638638
"returnPartialSuccess": {
639-
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
639+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
640640
"location": "query",
641641
"type": "boolean"
642642
}
@@ -1410,7 +1410,7 @@
14101410
"type": "string"
14111411
},
14121412
"returnPartialSuccess": {
1413-
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
1413+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
14141414
"location": "query",
14151415
"type": "boolean"
14161416
}
@@ -2345,7 +2345,7 @@
23452345
"type": "string"
23462346
},
23472347
"returnPartialSuccess": {
2348-
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
2348+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
23492349
"location": "query",
23502350
"type": "boolean"
23512351
}
@@ -3223,7 +3223,7 @@
32233223
"type": "string"
32243224
},
32253225
"returnPartialSuccess": {
3226-
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
3226+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
32273227
"location": "query",
32283228
"type": "boolean"
32293229
}
@@ -3354,7 +3354,7 @@
33543354
"type": "string"
33553355
},
33563356
"returnPartialSuccess": {
3357-
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
3357+
"description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
33583358
"location": "query",
33593359
"type": "boolean"
33603360
}
@@ -3436,9 +3436,31 @@
34363436
}
34373437
}
34383438
},
3439-
"revision": "20251121",
3439+
"revision": "20251205",
34403440
"rootUrl": "https://spanner.googleapis.com/",
34413441
"schemas": {
3442+
"Ack": {
3443+
"description": "Arguments to ack operations.",
3444+
"id": "Ack",
3445+
"properties": {
3446+
"ignoreNotFound": {
3447+
"description": "By default, an attempt to ack a message that does not exist will fail with a `NOT_FOUND` error. With `ignore_not_found` set to true, the ack will succeed even if the message does not exist. This is useful for unconditionally acking a message, even if it is missing or has already been acked.",
3448+
"type": "boolean"
3449+
},
3450+
"key": {
3451+
"description": "Required. The primary key of the message to be acked.",
3452+
"items": {
3453+
"type": "any"
3454+
},
3455+
"type": "array"
3456+
},
3457+
"queue": {
3458+
"description": "Required. The queue where the message to be acked is stored.",
3459+
"type": "string"
3460+
}
3461+
},
3462+
"type": "object"
3463+
},
34423464
"AdaptMessageRequest": {
34433465
"description": "Message sent by the client to the adapter.",
34443466
"id": "AdaptMessageRequest",
@@ -4047,12 +4069,6 @@
40474069
},
40484070
"type": "object"
40494071
},
4050-
"ClientContext": {
4051-
"description": "Container for various pieces of client-owned context attached to a request.",
4052-
"id": "ClientContext",
4053-
"properties": {},
4054-
"type": "object"
4055-
},
40564072
"ColumnMetadata": {
40574073
"description": "Metadata for a column.",
40584074
"id": "ColumnMetadata",
@@ -4154,6 +4170,29 @@
41544170
},
41554171
"type": "object"
41564172
},
4173+
"CompactDatabaseMetadata": {
4174+
"description": "Metadata type for the long-running operation returned by `CALL compact_all()`, which can be executed using ExecuteSql or ExecuteStreamingSql APIs.",
4175+
"id": "CompactDatabaseMetadata",
4176+
"properties": {
4177+
"cancelTime": {
4178+
"description": "Output only. The time at which cancellation of this operation was received. Operations.CancelOperation starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
4179+
"format": "google-datetime",
4180+
"readOnly": true,
4181+
"type": "string"
4182+
},
4183+
"database": {
4184+
"description": "Output only. The database being compacted.",
4185+
"readOnly": true,
4186+
"type": "string"
4187+
},
4188+
"progress": {
4189+
"$ref": "OperationProgress",
4190+
"description": "Output only. The progress of the compaction operation.",
4191+
"readOnly": true
4192+
}
4193+
},
4194+
"type": "object"
4195+
},
41574196
"ContextValue": {
41584197
"description": "A message representing context for a KeyRangeInfo, including a label, value, unit, and severity.",
41594198
"id": "ContextValue",
@@ -6065,7 +6104,7 @@
60656104
"type": "array"
60666105
},
60676106
"unreachable": {
6068-
"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
6107+
"description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.",
60696108
"items": {
60706109
"type": "string"
60716110
},
@@ -6338,6 +6377,10 @@
63386377
"description": "A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a Commit call.",
63396378
"id": "Mutation",
63406379
"properties": {
6380+
"ack": {
6381+
"$ref": "Ack",
6382+
"description": "Ack a message from a queue."
6383+
},
63416384
"delete": {
63426385
"$ref": "Delete",
63436386
"description": "Delete rows from a table. Succeeds whether or not the named rows were present."
@@ -6354,6 +6397,10 @@
63546397
"$ref": "Write",
63556398
"description": "Like insert, except that if the row already exists, it is deleted, and the column values provided are inserted instead. Unlike insert_or_update, this means any values not explicitly written become `NULL`. In an interleaved table, if you create the child table with the `ON DELETE CASCADE` annotation, then replacing a parent row also deletes the child rows. Otherwise, you must delete the child rows before you replace the parent row."
63566399
},
6400+
"send": {
6401+
"$ref": "Send",
6402+
"description": "Send a message to a queue."
6403+
},
63576404
"update": {
63586405
"$ref": "Write",
63596406
"description": "Update existing rows in a table. If any of the rows does not already exist, the transaction fails with error `NOT_FOUND`."
@@ -7121,10 +7168,6 @@
71217168
"description": "Common request options for various APIs.",
71227169
"id": "RequestOptions",
71237170
"properties": {
7124-
"clientContext": {
7125-
"$ref": "ClientContext",
7126-
"description": "Optional. Optional context that may be needed for some requests."
7127-
},
71287171
"priority": {
71297172
"description": "Priority for the request.",
71307173
"enum": [
@@ -7412,6 +7455,33 @@
74127455
},
74137456
"type": "object"
74147457
},
7458+
"Send": {
7459+
"description": "Arguments to send operations.",
7460+
"id": "Send",
7461+
"properties": {
7462+
"deliverTime": {
7463+
"description": "The time at which Spanner will begin attempting to deliver the message. If `deliver_time` is not set, Spanner will deliver the message immediately. If `deliver_time` is in the past, Spanner will replace it with a value closer to the current time.",
7464+
"format": "google-datetime",
7465+
"type": "string"
7466+
},
7467+
"key": {
7468+
"description": "Required. The primary key of the message to be sent.",
7469+
"items": {
7470+
"type": "any"
7471+
},
7472+
"type": "array"
7473+
},
7474+
"payload": {
7475+
"description": "The payload of the message.",
7476+
"type": "any"
7477+
},
7478+
"queue": {
7479+
"description": "Required. The queue to which the message will be sent.",
7480+
"type": "string"
7481+
}
7482+
},
7483+
"type": "object"
7484+
},
74157485
"Session": {
74167486
"description": "A session in the Cloud Spanner API.",
74177487
"id": "Session",

0 commit comments

Comments
 (0)