| Index: discovery/googleapis/spanner__v1.json
|
| diff --git a/discovery/googleapis/spanner__v1.json b/discovery/googleapis/spanner__v1.json
|
| index 97a8ac9765c9daefb5d82ce11186b88d87117701..f0dde70f4eb6c783ec7c60427bd8687a45cc19da 100644
|
| --- a/discovery/googleapis/spanner__v1.json
|
| +++ b/discovery/googleapis/spanner__v1.json
|
| @@ -2,8 +2,14 @@
|
| "auth": {
|
| "oauth2": {
|
| "scopes": {
|
| + "https://www.googleapis.com/auth/spanner.admin": {
|
| + "description": "Administer your Spanner databases"
|
| + },
|
| "https://www.googleapis.com/auth/cloud-platform": {
|
| "description": "View and manage your data across Google Cloud Platform services"
|
| + },
|
| + "https://www.googleapis.com/auth/spanner.data": {
|
| + "description": "View and manage the contents of your Spanner databases"
|
| }
|
| }
|
| }
|
| @@ -25,24 +31,18 @@
|
| "ownerDomain": "google.com",
|
| "ownerName": "Google",
|
| "parameters": {
|
| - "upload_protocol": {
|
| - "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
|
| + "uploadType": {
|
| + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "prettyPrint": {
|
| - "default": "true",
|
| - "description": "Returns response with indentations and line breaks.",
|
| - "location": "query",
|
| - "type": "boolean"
|
| - },
|
| "fields": {
|
| "description": "Selector specifying which fields to include in a partial response.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "uploadType": {
|
| - "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
|
| + "callback": {
|
| + "description": "JSONP",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| @@ -59,11 +59,6 @@
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "callback": {
|
| - "description": "JSONP",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "alt": {
|
| "default": "json",
|
| "description": "Data format for response.",
|
| @@ -110,12 +105,88 @@
|
| "description": "OAuth bearer token.",
|
| "location": "query",
|
| "type": "string"
|
| + },
|
| + "upload_protocol": {
|
| + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "prettyPrint": {
|
| + "default": "true",
|
| + "description": "Returns response with indentations and line breaks.",
|
| + "location": "query",
|
| + "type": "boolean"
|
| }
|
| },
|
| "protocol": "rest",
|
| "resources": {
|
| "projects": {
|
| "resources": {
|
| + "instanceConfigs": {
|
| + "methods": {
|
| + "get": {
|
| + "description": "Gets information about a particular instance configuration.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instanceConfigs.get",
|
| + "parameterOrder": [
|
| + "name"
|
| + ],
|
| + "parameters": {
|
| + "name": {
|
| + "description": "Required. The name of the requested instance configuration. Values are of\nthe form `projects/<project>/instanceConfigs/<config>`.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instanceConfigs/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v1/{+name}",
|
| + "response": {
|
| + "$ref": "InstanceConfig"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + },
|
| + "list": {
|
| + "description": "Lists the supported instance configurations for a given project.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instanceConfigs.list",
|
| + "parameterOrder": [
|
| + "parent"
|
| + ],
|
| + "parameters": {
|
| + "parent": {
|
| + "description": "Required. The name of the project for which a list of supported instance\nconfigurations is requested. Values are of the form\n`projects/<project>`.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + },
|
| + "pageToken": {
|
| + "description": "If non-empty, `page_token` should contain a\nnext_page_token\nfrom a previous ListInstanceConfigsResponse.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "pageSize": {
|
| + "description": "Number of instance configurations to be returned in the response. If 0 or\nless, defaults to the server's maximum allowed page size.",
|
| + "format": "int32",
|
| + "location": "query",
|
| + "type": "integer"
|
| + }
|
| + },
|
| + "path": "v1/{+parent}/instanceConfigs",
|
| + "response": {
|
| + "$ref": "ListInstanceConfigsResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + }
|
| + }
|
| + },
|
| "instances": {
|
| "methods": {
|
| "list": {
|
| @@ -155,7 +226,8 @@
|
| "$ref": "ListInstancesResponse"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "create": {
|
| @@ -182,7 +254,8 @@
|
| "$ref": "Operation"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "setIamPolicy": {
|
| @@ -209,7 +282,8 @@
|
| "$ref": "Policy"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "getIamPolicy": {
|
| @@ -236,7 +310,8 @@
|
| "$ref": "Policy"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "patch": {
|
| @@ -263,7 +338,8 @@
|
| "$ref": "Operation"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "get": {
|
| @@ -287,7 +363,8 @@
|
| "$ref": "Instance"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "testIamPermissions": {
|
| @@ -314,7 +391,8 @@
|
| "$ref": "TestIamPermissionsResponse"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "delete": {
|
| @@ -338,126 +416,14 @@
|
| "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| }
|
| },
|
| "resources": {
|
| "databases": {
|
| "methods": {
|
| - "getDdl": {
|
| - "description": "Returns the schema of a Cloud Spanner database as a list of formatted\nDDL statements. This method does not show pending schema updates, those may\nbe queried using the Operations API.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instances.databases.getDdl",
|
| - "parameterOrder": [
|
| - "database"
|
| - ],
|
| - "parameters": {
|
| - "database": {
|
| - "description": "Required. The database whose schema we wish to get.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+database}/ddl",
|
| - "response": {
|
| - "$ref": "GetDatabaseDdlResponse"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "list": {
|
| - "description": "Lists Cloud Spanner databases.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instances.databases.list",
|
| - "parameterOrder": [
|
| - "parent"
|
| - ],
|
| - "parameters": {
|
| - "parent": {
|
| - "description": "Required. The instance whose databases should be listed.\nValues are of the form `projects/<project>/instances/<instance>`.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - },
|
| - "pageToken": {
|
| - "description": "If non-empty, `page_token` should contain a\nnext_page_token from a\nprevious ListDatabasesResponse.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "pageSize": {
|
| - "description": "Number of databases to be returned in the response. If 0 or less,\ndefaults to the server's maximum allowed page size.",
|
| - "format": "int32",
|
| - "location": "query",
|
| - "type": "integer"
|
| - }
|
| - },
|
| - "path": "v1/{+parent}/databases",
|
| - "response": {
|
| - "$ref": "ListDatabasesResponse"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "create": {
|
| - "description": "Creates a new Cloud Spanner database and starts to prepare it for serving.\nThe returned long-running operation will\nhave a name of the format `<database_name>/operations/<operation_id>` and\ncan be used to track preparation of the database. The\nmetadata field type is\nCreateDatabaseMetadata. The\nresponse field type is\nDatabase, if successful.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.databases.create",
|
| - "parameterOrder": [
|
| - "parent"
|
| - ],
|
| - "parameters": {
|
| - "parent": {
|
| - "description": "Required. The name of the instance that will serve the new database.\nValues are of the form `projects/<project>/instances/<instance>`.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+parent}/databases",
|
| - "request": {
|
| - "$ref": "CreateDatabaseRequest"
|
| - },
|
| - "response": {
|
| - "$ref": "Operation"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "setIamPolicy": {
|
| - "description": "Sets the access control policy on a database resource. Replaces any\nexisting policy.\n\nAuthorization requires `spanner.databases.setIamPolicy` permission on\nresource.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.databases.setIamPolicy",
|
| - "parameterOrder": [
|
| - "resource"
|
| - ],
|
| - "parameters": {
|
| - "resource": {
|
| - "description": "REQUIRED: The Cloud Spanner resource for which the policy is being set. The format is `projects/<project ID>/instances/<instance ID>` for instance resources and `projects/<project ID>/instances/<instance ID>/databases/<database ID>` for databases resources.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+resource}:setIamPolicy",
|
| - "request": {
|
| - "$ref": "SetIamPolicyRequest"
|
| - },
|
| - "response": {
|
| - "$ref": "Policy"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| "getIamPolicy": {
|
| "description": "Gets the access control policy for a database resource. Returns an empty\npolicy if a database exists but does not have a policy set.\n\nAuthorization requires `spanner.databases.getIamPolicy` permission on\nresource.",
|
| "httpMethod": "POST",
|
| @@ -482,7 +448,8 @@
|
| "$ref": "Policy"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "get": {
|
| @@ -506,7 +473,8 @@
|
| "$ref": "Database"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "dropDatabase": {
|
| @@ -530,7 +498,8 @@
|
| "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "updateDdl": {
|
| @@ -557,7 +526,8 @@
|
| "$ref": "Operation"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "testIamPermissions": {
|
| @@ -584,129 +554,240 @@
|
| "$ref": "TestIamPermissionsResponse"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| - }
|
| - },
|
| - "resources": {
|
| - "operations": {
|
| - "methods": {
|
| - "cancel": {
|
| - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.databases.operations.cancel",
|
| - "parameterOrder": [
|
| - "name"
|
| - ],
|
| - "parameters": {
|
| - "name": {
|
| - "description": "The name of the operation resource to be cancelled.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+name}:cancel",
|
| - "response": {
|
| - "$ref": "Empty"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "delete": {
|
| - "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.",
|
| - "httpMethod": "DELETE",
|
| - "id": "spanner.projects.instances.databases.operations.delete",
|
| - "parameterOrder": [
|
| - "name"
|
| - ],
|
| - "parameters": {
|
| - "name": {
|
| - "description": "The name of the operation resource to be deleted.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+name}",
|
| - "response": {
|
| - "$ref": "Empty"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "list": {
|
| - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding below allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instances.databases.operations.list",
|
| + },
|
| + "getDdl": {
|
| + "description": "Returns the schema of a Cloud Spanner database as a list of formatted\nDDL statements. This method does not show pending schema updates, those may\nbe queried using the Operations API.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instances.databases.getDdl",
|
| + "parameterOrder": [
|
| + "database"
|
| + ],
|
| + "parameters": {
|
| + "database": {
|
| + "description": "Required. The database whose schema we wish to get.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v1/{+database}/ddl",
|
| + "response": {
|
| + "$ref": "GetDatabaseDdlResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + },
|
| + "list": {
|
| + "description": "Lists Cloud Spanner databases.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instances.databases.list",
|
| + "parameterOrder": [
|
| + "parent"
|
| + ],
|
| + "parameters": {
|
| + "pageToken": {
|
| + "description": "If non-empty, `page_token` should contain a\nnext_page_token from a\nprevious ListDatabasesResponse.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "pageSize": {
|
| + "description": "Number of databases to be returned in the response. If 0 or less,\ndefaults to the server's maximum allowed page size.",
|
| + "format": "int32",
|
| + "location": "query",
|
| + "type": "integer"
|
| + },
|
| + "parent": {
|
| + "description": "Required. The instance whose databases should be listed.\nValues are of the form `projects/<project>/instances/<instance>`.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v1/{+parent}/databases",
|
| + "response": {
|
| + "$ref": "ListDatabasesResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + },
|
| + "create": {
|
| + "description": "Creates a new Cloud Spanner database and starts to prepare it for serving.\nThe returned long-running operation will\nhave a name of the format `<database_name>/operations/<operation_id>` and\ncan be used to track preparation of the database. The\nmetadata field type is\nCreateDatabaseMetadata. The\nresponse field type is\nDatabase, if successful.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.databases.create",
|
| + "parameterOrder": [
|
| + "parent"
|
| + ],
|
| + "parameters": {
|
| + "parent": {
|
| + "description": "Required. The name of the instance that will serve the new database.\nValues are of the form `projects/<project>/instances/<instance>`.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v1/{+parent}/databases",
|
| + "request": {
|
| + "$ref": "CreateDatabaseRequest"
|
| + },
|
| + "response": {
|
| + "$ref": "Operation"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + },
|
| + "setIamPolicy": {
|
| + "description": "Sets the access control policy on a database resource. Replaces any\nexisting policy.\n\nAuthorization requires `spanner.databases.setIamPolicy` permission on\nresource.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.databases.setIamPolicy",
|
| + "parameterOrder": [
|
| + "resource"
|
| + ],
|
| + "parameters": {
|
| + "resource": {
|
| + "description": "REQUIRED: The Cloud Spanner resource for which the policy is being set. The format is `projects/<project ID>/instances/<instance ID>` for instance resources and `projects/<project ID>/instances/<instance ID>/databases/<database ID>` for databases resources.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v1/{+resource}:setIamPolicy",
|
| + "request": {
|
| + "$ref": "SetIamPolicyRequest"
|
| + },
|
| + "response": {
|
| + "$ref": "Policy"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + }
|
| + },
|
| + "resources": {
|
| + "sessions": {
|
| + "methods": {
|
| + "executeStreamingSql": {
|
| + "description": "Like ExecuteSql, except returns the result\nset as a stream. Unlike ExecuteSql, there\nis no limit on the size of the returned result set. However, no\nindividual row in the result set can exceed 100 MiB, and no\ncolumn value can exceed 10 MiB.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.databases.sessions.executeStreamingSql",
|
| "parameterOrder": [
|
| - "name"
|
| + "session"
|
| ],
|
| "parameters": {
|
| - "filter": {
|
| - "description": "The standard list filter.",
|
| - "location": "query",
|
| + "session": {
|
| + "description": "Required. The session in which the SQL query should be performed.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| + "required": true,
|
| "type": "string"
|
| - },
|
| - "name": {
|
| - "description": "The name of the operation collection.",
|
| + }
|
| + },
|
| + "path": "v1/{+session}:executeStreamingSql",
|
| + "request": {
|
| + "$ref": "ExecuteSqlRequest"
|
| + },
|
| + "response": {
|
| + "$ref": "PartialResultSet"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| + ]
|
| + },
|
| + "commit": {
|
| + "description": "Commits a transaction. The request includes the mutations to be\napplied to rows in the database.\n\n`Commit` might return an `ABORTED` error. This can occur at any time;\ncommonly, the cause is conflicts with concurrent\ntransactions. However, it can also happen for a variety of other\nreasons. If `Commit` returns `ABORTED`, the caller should re-attempt\nthe transaction from the beginning, re-using the same session.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.databases.sessions.commit",
|
| + "parameterOrder": [
|
| + "session"
|
| + ],
|
| + "parameters": {
|
| + "session": {
|
| + "description": "Required. The session in which the transaction to be committed is running.",
|
| "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations$",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| "required": true,
|
| "type": "string"
|
| - },
|
| - "pageToken": {
|
| - "description": "The standard list page token.",
|
| - "location": "query",
|
| + }
|
| + },
|
| + "path": "v1/{+session}:commit",
|
| + "request": {
|
| + "$ref": "CommitRequest"
|
| + },
|
| + "response": {
|
| + "$ref": "CommitResponse"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| + ]
|
| + },
|
| + "beginTransaction": {
|
| + "description": "Begins a new transaction. This step can often be skipped:\nRead, ExecuteSql and\nCommit can begin a new transaction as a\nside-effect.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.databases.sessions.beginTransaction",
|
| + "parameterOrder": [
|
| + "session"
|
| + ],
|
| + "parameters": {
|
| + "session": {
|
| + "description": "Required. The session in which the transaction runs.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| + "required": true,
|
| "type": "string"
|
| - },
|
| - "pageSize": {
|
| - "description": "The standard list page size.",
|
| - "format": "int32",
|
| - "location": "query",
|
| - "type": "integer"
|
| }
|
| },
|
| - "path": "v1/{+name}",
|
| + "path": "v1/{+session}:beginTransaction",
|
| + "request": {
|
| + "$ref": "BeginTransactionRequest"
|
| + },
|
| "response": {
|
| - "$ref": "ListOperationsResponse"
|
| + "$ref": "Transaction"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| },
|
| - "get": {
|
| - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instances.databases.operations.get",
|
| + "delete": {
|
| + "description": "Ends a session, releasing server resources associated with it.",
|
| + "httpMethod": "DELETE",
|
| + "id": "spanner.projects.instances.databases.sessions.delete",
|
| "parameterOrder": [
|
| "name"
|
| ],
|
| "parameters": {
|
| "name": {
|
| - "description": "The name of the operation resource.",
|
| + "description": "Required. The name of the session to delete.",
|
| "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations/[^/]+$",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| "path": "v1/{+name}",
|
| "response": {
|
| - "$ref": "Operation"
|
| + "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| - }
|
| - }
|
| - },
|
| - "sessions": {
|
| - "methods": {
|
| + },
|
| "executeSql": {
|
| "description": "Executes an SQL query, returning all rows in a single reply. This\nmethod cannot be used to return a result set larger than 10 MiB;\nif the query yields more data than that, the query fails with\na `FAILED_PRECONDITION` error.\n\nQueries inside read-write transactions might return `ABORTED`. If\nthis occurs, the application should restart the transaction from\nthe beginning. See Transaction for more details.\n\nLarger result sets can be fetched in streaming fashion by calling\nExecuteStreamingSql instead.",
|
| "httpMethod": "POST",
|
| @@ -731,7 +812,8 @@
|
| "$ref": "ResultSet"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| },
|
| "rollback": {
|
| @@ -758,7 +840,8 @@
|
| "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| },
|
| "streamingRead": {
|
| @@ -785,7 +868,8 @@
|
| "$ref": "PartialResultSet"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| },
|
| "create": {
|
| @@ -809,7 +893,8 @@
|
| "$ref": "Session"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| },
|
| "read": {
|
| @@ -836,7 +921,8 @@
|
| "$ref": "ResultSet"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| },
|
| "get": {
|
| @@ -860,112 +946,128 @@
|
| "$ref": "Session"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.data"
|
| ]
|
| - },
|
| - "delete": {
|
| - "description": "Ends a session, releasing server resources associated with it.",
|
| - "httpMethod": "DELETE",
|
| - "id": "spanner.projects.instances.databases.sessions.delete",
|
| + }
|
| + }
|
| + },
|
| + "operations": {
|
| + "methods": {
|
| + "cancel": {
|
| + "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.databases.operations.cancel",
|
| "parameterOrder": [
|
| "name"
|
| ],
|
| "parameters": {
|
| "name": {
|
| - "description": "Required. The name of the session to delete.",
|
| + "description": "The name of the operation resource to be cancelled.",
|
| "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations/[^/]+$",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v1/{+name}",
|
| + "path": "v1/{+name}:cancel",
|
| "response": {
|
| "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| - "beginTransaction": {
|
| - "description": "Begins a new transaction. This step can often be skipped:\nRead, ExecuteSql and\nCommit can begin a new transaction as a\nside-effect.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.databases.sessions.beginTransaction",
|
| + "delete": {
|
| + "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.",
|
| + "httpMethod": "DELETE",
|
| + "id": "spanner.projects.instances.databases.operations.delete",
|
| "parameterOrder": [
|
| - "session"
|
| + "name"
|
| ],
|
| "parameters": {
|
| - "session": {
|
| - "description": "Required. The session in which the transaction runs.",
|
| + "name": {
|
| + "description": "The name of the operation resource to be deleted.",
|
| "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations/[^/]+$",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v1/{+session}:beginTransaction",
|
| - "request": {
|
| - "$ref": "BeginTransactionRequest"
|
| - },
|
| + "path": "v1/{+name}",
|
| "response": {
|
| - "$ref": "Transaction"
|
| + "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| - "commit": {
|
| - "description": "Commits a transaction. The request includes the mutations to be\napplied to rows in the database.\n\n`Commit` might return an `ABORTED` error. This can occur at any time;\ncommonly, the cause is conflicts with concurrent\ntransactions. However, it can also happen for a variety of other\nreasons. If `Commit` returns `ABORTED`, the caller should re-attempt\nthe transaction from the beginning, re-using the same session.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.databases.sessions.commit",
|
| + "get": {
|
| + "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instances.databases.operations.get",
|
| "parameterOrder": [
|
| - "session"
|
| + "name"
|
| ],
|
| "parameters": {
|
| - "session": {
|
| - "description": "Required. The session in which the transaction to be committed is running.",
|
| + "name": {
|
| + "description": "The name of the operation resource.",
|
| "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations/[^/]+$",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v1/{+session}:commit",
|
| - "request": {
|
| - "$ref": "CommitRequest"
|
| - },
|
| + "path": "v1/{+name}",
|
| "response": {
|
| - "$ref": "CommitResponse"
|
| + "$ref": "Operation"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| - "executeStreamingSql": {
|
| - "description": "Like ExecuteSql, except returns the result\nset as a stream. Unlike ExecuteSql, there\nis no limit on the size of the returned result set. However, no\nindividual row in the result set can exceed 100 MiB, and no\ncolumn value can exceed 10 MiB.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.databases.sessions.executeStreamingSql",
|
| + "list": {
|
| + "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instances.databases.operations.list",
|
| "parameterOrder": [
|
| - "session"
|
| + "name"
|
| ],
|
| "parameters": {
|
| - "session": {
|
| - "description": "Required. The session in which the SQL query should be performed.",
|
| + "pageToken": {
|
| + "description": "The standard list page token.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| + "name": {
|
| + "description": "The name of the operation's parent resource.",
|
| "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/sessions/[^/]+$",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/databases/[^/]+/operations$",
|
| "required": true,
|
| "type": "string"
|
| + },
|
| + "pageSize": {
|
| + "description": "The standard list page size.",
|
| + "format": "int32",
|
| + "location": "query",
|
| + "type": "integer"
|
| + },
|
| + "filter": {
|
| + "description": "The standard list filter.",
|
| + "location": "query",
|
| + "type": "string"
|
| }
|
| },
|
| - "path": "v1/{+session}:executeStreamingSql",
|
| - "request": {
|
| - "$ref": "ExecuteSqlRequest"
|
| - },
|
| + "path": "v1/{+name}",
|
| "response": {
|
| - "$ref": "PartialResultSet"
|
| + "$ref": "ListOperationsResponse"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| }
|
| }
|
| @@ -974,40 +1076,16 @@
|
| },
|
| "operations": {
|
| "methods": {
|
| - "cancel": {
|
| - "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.",
|
| - "httpMethod": "POST",
|
| - "id": "spanner.projects.instances.operations.cancel",
|
| - "parameterOrder": [
|
| - "name"
|
| - ],
|
| - "parameters": {
|
| - "name": {
|
| - "description": "The name of the operation resource to be cancelled.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instances/[^/]+/operations/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+name}:cancel",
|
| - "response": {
|
| - "$ref": "Empty"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "delete": {
|
| - "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.",
|
| - "httpMethod": "DELETE",
|
| - "id": "spanner.projects.instances.operations.delete",
|
| + "get": {
|
| + "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.",
|
| + "httpMethod": "GET",
|
| + "id": "spanner.projects.instances.operations.get",
|
| "parameterOrder": [
|
| "name"
|
| ],
|
| "parameters": {
|
| "name": {
|
| - "description": "The name of the operation resource to be deleted.",
|
| + "description": "The name of the operation resource.",
|
| "location": "path",
|
| "pattern": "^projects/[^/]+/instances/[^/]+/operations/[^/]+$",
|
| "required": true,
|
| @@ -1016,42 +1094,43 @@
|
| },
|
| "path": "v1/{+name}",
|
| "response": {
|
| - "$ref": "Empty"
|
| + "$ref": "Operation"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| "list": {
|
| - "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding below allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`.",
|
| + "description": "Lists operations that match the specified filter in the request. If the\nserver doesn't support this method, it returns `UNIMPLEMENTED`.\n\nNOTE: the `name` binding allows API services to override the binding\nto use different resource name schemes, such as `users/*/operations`. To\noverride the binding, API services can add a binding such as\n`\"/v1/{name=users/*}/operations\"` to their service configuration.\nFor backwards compatibility, the default name includes the operations\ncollection id, however overriding users must ensure the name binding\nis the parent resource, without the operations collection id.",
|
| "httpMethod": "GET",
|
| "id": "spanner.projects.instances.operations.list",
|
| "parameterOrder": [
|
| "name"
|
| ],
|
| "parameters": {
|
| - "pageSize": {
|
| - "description": "The standard list page size.",
|
| - "format": "int32",
|
| - "location": "query",
|
| - "type": "integer"
|
| - },
|
| "filter": {
|
| "description": "The standard list filter.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| + "pageToken": {
|
| + "description": "The standard list page token.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| "name": {
|
| - "description": "The name of the operation collection.",
|
| + "description": "The name of the operation's parent resource.",
|
| "location": "path",
|
| "pattern": "^projects/[^/]+/instances/[^/]+/operations$",
|
| "required": true,
|
| "type": "string"
|
| },
|
| - "pageToken": {
|
| - "description": "The standard list page token.",
|
| + "pageSize": {
|
| + "description": "The standard list page size.",
|
| + "format": "int32",
|
| "location": "query",
|
| - "type": "string"
|
| + "type": "integer"
|
| }
|
| },
|
| "path": "v1/{+name}",
|
| @@ -1059,212 +1138,113 @@
|
| "$ref": "ListOperationsResponse"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| },
|
| - "get": {
|
| - "description": "Gets the latest state of a long-running operation. Clients can use this\nmethod to poll the operation result at intervals as recommended by the API\nservice.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instances.operations.get",
|
| + "cancel": {
|
| + "description": "Starts asynchronous cancellation on a long-running operation. The server\nmakes a best effort to cancel the operation, but success is not\nguaranteed. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`. Clients can use\nOperations.GetOperation or\nother methods to check whether the cancellation succeeded or whether the\noperation completed despite cancellation. On successful cancellation,\nthe operation is not deleted; instead, it becomes an operation with\nan Operation.error value with a google.rpc.Status.code of 1,\ncorresponding to `Code.CANCELLED`.",
|
| + "httpMethod": "POST",
|
| + "id": "spanner.projects.instances.operations.cancel",
|
| "parameterOrder": [
|
| "name"
|
| ],
|
| "parameters": {
|
| "name": {
|
| - "description": "The name of the operation resource.",
|
| + "description": "The name of the operation resource to be cancelled.",
|
| "location": "path",
|
| "pattern": "^projects/[^/]+/instances/[^/]+/operations/[^/]+$",
|
| "required": true,
|
| "type": "string"
|
| }
|
| },
|
| - "path": "v1/{+name}",
|
| + "path": "v1/{+name}:cancel",
|
| "response": {
|
| - "$ref": "Operation"
|
| + "$ref": "Empty"
|
| },
|
| "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| ]
|
| - }
|
| - }
|
| - }
|
| - }
|
| - },
|
| - "instanceConfigs": {
|
| - "methods": {
|
| - "list": {
|
| - "description": "Lists the supported instance configurations for a given project.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instanceConfigs.list",
|
| - "parameterOrder": [
|
| - "parent"
|
| - ],
|
| - "parameters": {
|
| - "pageToken": {
|
| - "description": "If non-empty, `page_token` should contain a\nnext_page_token\nfrom a previous ListInstanceConfigsResponse.",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| - "pageSize": {
|
| - "description": "Number of instance configurations to be returned in the response. If 0 or\nless, defaults to the server's maximum allowed page size.",
|
| - "format": "int32",
|
| - "location": "query",
|
| - "type": "integer"
|
| },
|
| - "parent": {
|
| - "description": "Required. The name of the project for which a list of supported instance\nconfigurations is requested. Values are of the form\n`projects/<project>`.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+parent}/instanceConfigs",
|
| - "response": {
|
| - "$ref": "ListInstanceConfigsResponse"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| - },
|
| - "get": {
|
| - "description": "Gets information about a particular instance configuration.",
|
| - "httpMethod": "GET",
|
| - "id": "spanner.projects.instanceConfigs.get",
|
| - "parameterOrder": [
|
| - "name"
|
| - ],
|
| - "parameters": {
|
| - "name": {
|
| - "description": "Required. The name of the requested instance configuration. Values are of\nthe form `projects/<project>/instanceConfigs/<config>`.",
|
| - "location": "path",
|
| - "pattern": "^projects/[^/]+/instanceConfigs/[^/]+$",
|
| - "required": true,
|
| - "type": "string"
|
| - }
|
| - },
|
| - "path": "v1/{+name}",
|
| - "response": {
|
| - "$ref": "InstanceConfig"
|
| - },
|
| - "scopes": [
|
| - "https://www.googleapis.com/auth/cloud-platform"
|
| - ]
|
| + "delete": {
|
| + "description": "Deletes a long-running operation. This method indicates that the client is\nno longer interested in the operation result. It does not cancel the\noperation. If the server doesn't support this method, it returns\n`google.rpc.Code.UNIMPLEMENTED`.",
|
| + "httpMethod": "DELETE",
|
| + "id": "spanner.projects.instances.operations.delete",
|
| + "parameterOrder": [
|
| + "name"
|
| + ],
|
| + "parameters": {
|
| + "name": {
|
| + "description": "The name of the operation resource to be deleted.",
|
| + "location": "path",
|
| + "pattern": "^projects/[^/]+/instances/[^/]+/operations/[^/]+$",
|
| + "required": true,
|
| + "type": "string"
|
| + }
|
| + },
|
| + "path": "v1/{+name}",
|
| + "response": {
|
| + "$ref": "Empty"
|
| + },
|
| + "scopes": [
|
| + "https://www.googleapis.com/auth/cloud-platform",
|
| + "https://www.googleapis.com/auth/spanner.admin"
|
| + ]
|
| + }
|
| + }
|
| }
|
| }
|
| }
|
| }
|
| }
|
| },
|
| - "revision": "20170531",
|
| + "revision": "20170613",
|
| "rootUrl": "https://spanner.googleapis.com/",
|
| "schemas": {
|
| - "PartialResultSet": {
|
| - "description": "Partial results from a streaming read or SQL query. Streaming reads and\nSQL queries better tolerate large result sets, large rows, and large\nvalues, but are a little trickier to consume.",
|
| - "id": "PartialResultSet",
|
| + "TransactionSelector": {
|
| + "description": "This message is used to select the transaction in which a\nRead or\nExecuteSql call runs.\n\nSee TransactionOptions for more information about transactions.",
|
| + "id": "TransactionSelector",
|
| "properties": {
|
| - "chunkedValue": {
|
| - "description": "If true, then the final value in values is chunked, and must\nbe combined with more values from subsequent `PartialResultSet`s\nto obtain a complete field value.",
|
| - "type": "boolean"
|
| - },
|
| - "metadata": {
|
| - "$ref": "ResultSetMetadata",
|
| - "description": "Metadata about the result set, such as row type information.\nOnly present in the first response."
|
| - },
|
| - "values": {
|
| - "description": "A streamed result set consists of a stream of values, which might\nbe split into many `PartialResultSet` messages to accommodate\nlarge rows and/or large values. Every N complete values defines a\nrow, where N is equal to the number of entries in\nmetadata.row_type.fields.\n\nMost values are encoded based on type as described\nhere.\n\nIt is possible that the last value in values is \"chunked\",\nmeaning that the rest of the value is sent in subsequent\n`PartialResultSet`(s). This is denoted by the chunked_value\nfield. Two or more chunked values can be merged to form a\ncomplete value as follows:\n\n * `bool/number/null`: cannot be chunked\n * `string`: concatenate the strings\n * `list`: concatenate the lists. If the last element in a list is a\n `string`, `list`, or `object`, merge it with the first element in\n the next list by applying these rules recursively.\n * `object`: concatenate the (field name, field value) pairs. If a\n field name is duplicated, then apply these rules recursively\n to merge the field values.\n\nSome examples of merging:\n\n # Strings are concatenated.\n \"foo\", \"bar\" => \"foobar\"\n\n # Lists of non-strings are concatenated.\n [2, 3], [4] => [2, 3, 4]\n\n # Lists are concatenated, but the last and first elements are merged\n # because they are strings.\n [\"a\", \"b\"], [\"c\", \"d\"] => [\"a\", \"bc\", \"d\"]\n\n # Lists are concatenated, but the last and first elements are merged\n # because they are lists. Recursively, the last and first elements\n # of the inner lists are merged because they are strings.\n [\"a\", [\"b\", \"c\"]], [[\"d\"], \"e\"] => [\"a\", [\"b\", \"cd\"], \"e\"]\n\n # Non-overlapping object fields are combined.\n {\"a\": \"1\"}, {\"b\": \"2\"} => {\"a\": \"1\", \"b\": 2\"}\n\n # Overlapping object fields are merged.\n {\"a\": \"1\"}, {\"a\": \"2\"} => {\"a\": \"12\"}\n\n # Examples of merging objects containing lists of strings.\n {\"a\": [\"1\"]}, {\"a\": [\"2\"]} => {\"a\": [\"12\"]}\n\nFor a more complete example, suppose a streaming SQL query is\nyielding a result set whose rows contain a single string\nfield. The following `PartialResultSet`s might be yielded:\n\n {\n \"metadata\": { ... }\n \"values\": [\"Hello\", \"W\"]\n \"chunked_value\": true\n \"resume_token\": \"Af65...\"\n }\n {\n \"values\": [\"orl\"]\n \"chunked_value\": true\n \"resume_token\": \"Bqp2...\"\n }\n {\n \"values\": [\"d\"]\n \"resume_token\": \"Zx1B...\"\n }\n\nThis sequence of `PartialResultSet`s encodes two rows, one\ncontaining the field value `\"Hello\"`, and a second containing the\nfield value `\"World\" = \"W\" + \"orl\" + \"d\"`.",
|
| - "items": {
|
| - "type": "any"
|
| - },
|
| - "type": "array"
|
| - },
|
| - "resumeToken": {
|
| - "description": "Streaming calls might be interrupted for a variety of reasons, such\nas TCP connection loss. If this occurs, the stream of results can\nbe resumed by re-sending the original request and including\n`resume_token`. Note that executing any other transaction in the\nsame session invalidates the token.",
|
| + "id": {
|
| + "description": "Execute the read or SQL query in a previously-started transaction.",
|
| "format": "byte",
|
| "type": "string"
|
| },
|
| - "stats": {
|
| - "$ref": "ResultSetStats",
|
| - "description": "Query plan and execution statistics for the query that produced this\nstreaming result set. These can be requested by setting\nExecuteSqlRequest.query_mode and are sent\nonly once with the last response in the stream."
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| - "UpdateInstanceMetadata": {
|
| - "description": "Metadata type for the operation returned by\nUpdateInstance.",
|
| - "id": "UpdateInstanceMetadata",
|
| - "properties": {
|
| - "cancelTime": {
|
| - "description": "The time at which this operation was cancelled. If set, this operation is\nin the process of undoing itself (which is guaranteed to succeed) and\ncannot be cancelled again.",
|
| - "format": "google-datetime",
|
| - "type": "string"
|
| - },
|
| - "endTime": {
|
| - "description": "The time at which this operation failed or was completed successfully.",
|
| - "format": "google-datetime",
|
| - "type": "string"
|
| - },
|
| - "instance": {
|
| - "$ref": "Instance",
|
| - "description": "The desired end state of the update."
|
| + "singleUse": {
|
| + "$ref": "TransactionOptions",
|
| + "description": "Execute the read or SQL query in a temporary transaction.\nThis is the most efficient way to execute a transaction that\nconsists of a single SQL query."
|
| },
|
| - "startTime": {
|
| - "description": "The time at which UpdateInstance\nrequest was received.",
|
| - "format": "google-datetime",
|
| - "type": "string"
|
| + "begin": {
|
| + "$ref": "TransactionOptions",
|
| + "description": "Begin a new transaction and execute this read or SQL query in\nit. The transaction ID of the new transaction is returned in\nResultSetMetadata.transaction, which is a Transaction."
|
| }
|
| },
|
| "type": "object"
|
| },
|
| - "ListOperationsResponse": {
|
| - "description": "The response message for Operations.ListOperations.",
|
| - "id": "ListOperationsResponse",
|
| + "Mutation": {
|
| + "description": "A modification to one or more Cloud Spanner rows. Mutations can be\napplied to a Cloud Spanner database by sending them in a\nCommit call.",
|
| + "id": "Mutation",
|
| "properties": {
|
| - "nextPageToken": {
|
| - "description": "The standard List next-page token.",
|
| - "type": "string"
|
| + "update": {
|
| + "$ref": "Write",
|
| + "description": "Update existing rows in a table. If any of the rows does not\nalready exist, the transaction fails with error `NOT_FOUND`."
|
| },
|
| - "operations": {
|
| - "description": "A list of operations that matches the specified filter in the request.",
|
| - "items": {
|
| - "$ref": "Operation"
|
| - },
|
| - "type": "array"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| - "ResultSetMetadata": {
|
| - "description": "Metadata about a ResultSet or PartialResultSet.",
|
| - "id": "ResultSetMetadata",
|
| - "properties": {
|
| - "transaction": {
|
| - "$ref": "Transaction",
|
| - "description": "If the read or SQL query began a transaction as a side-effect, the\ninformation about the new transaction is yielded here."
|
| + "replace": {
|
| + "$ref": "Write",
|
| + "description": "Like insert, except that if the row already exists, it is\ndeleted, and the column values provided are inserted\ninstead. Unlike insert_or_update, this means any values not\nexplicitly written become `NULL`."
|
| },
|
| - "rowType": {
|
| - "$ref": "StructType",
|
| - "description": "Indicates the field names and types for the rows in the result\nset. For example, a SQL query like `\"SELECT UserId, UserName FROM\nUsers\"` could return a `row_type` value like:\n\n \"fields\": [\n { \"name\": \"UserId\", \"type\": { \"code\": \"INT64\" } },\n { \"name\": \"UserName\", \"type\": { \"code\": \"STRING\" } },\n ]"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| - "TransactionSelector": {
|
| - "description": "This message is used to select the transaction in which a\nRead or\nExecuteSql call runs.\n\nSee TransactionOptions for more information about transactions.",
|
| - "id": "TransactionSelector",
|
| - "properties": {
|
| - "singleUse": {
|
| - "$ref": "TransactionOptions",
|
| - "description": "Execute the read or SQL query in a temporary transaction.\nThis is the most efficient way to execute a transaction that\nconsists of a single SQL query."
|
| + "delete": {
|
| + "$ref": "Delete",
|
| + "description": "Delete rows from a table. Succeeds whether or not the named\nrows were present."
|
| },
|
| - "begin": {
|
| - "$ref": "TransactionOptions",
|
| - "description": "Begin a new transaction and execute this read or SQL query in\nit. The transaction ID of the new transaction is returned in\nResultSetMetadata.transaction, which is a Transaction."
|
| + "insertOrUpdate": {
|
| + "$ref": "Write",
|
| + "description": "Like insert, except that if the row already exists, then\nits column values are overwritten with the ones provided. Any\ncolumn values not explicitly written are preserved."
|
| },
|
| - "id": {
|
| - "description": "Execute the read or SQL query in a previously-started transaction.",
|
| - "format": "byte",
|
| - "type": "string"
|
| + "insert": {
|
| + "$ref": "Write",
|
| + "description": "Insert new rows in a table. If any of the rows already exist,\nthe write or transaction fails with error `ALREADY_EXISTS`."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1280,6 +1260,10 @@
|
| },
|
| "type": "array"
|
| },
|
| + "all": {
|
| + "description": "For convenience `all` can be set to `true` to indicate that this\n`KeySet` matches all keys in the table or index. Note that any keys\nspecified in `keys` or `ranges` are only yielded once.",
|
| + "type": "boolean"
|
| + },
|
| "keys": {
|
| "description": "A list of specific keys. Entries in `keys` should have exactly as\nmany elements as there are columns in the primary or index key\nwith which this `KeySet` is used. Individual key values are\nencoded as described here.",
|
| "items": {
|
| @@ -1289,37 +1273,6 @@
|
| "type": "array"
|
| },
|
| "type": "array"
|
| - },
|
| - "all": {
|
| - "description": "For convenience `all` can be set to `true` to indicate that this\n`KeySet` matches all keys in the table or index. Note that any keys\nspecified in `keys` or `ranges` are only yielded once.",
|
| - "type": "boolean"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| - "Mutation": {
|
| - "description": "A modification to one or more Cloud Spanner rows. Mutations can be\napplied to a Cloud Spanner database by sending them in a\nCommit call.",
|
| - "id": "Mutation",
|
| - "properties": {
|
| - "insert": {
|
| - "$ref": "Write",
|
| - "description": "Insert new rows in a table. If any of the rows already exist,\nthe write or transaction fails with error `ALREADY_EXISTS`."
|
| - },
|
| - "insertOrUpdate": {
|
| - "$ref": "Write",
|
| - "description": "Like insert, except that if the row already exists, then\nits column values are overwritten with the ones provided. Any\ncolumn values not explicitly written are preserved."
|
| - },
|
| - "update": {
|
| - "$ref": "Write",
|
| - "description": "Update existing rows in a table. If any of the rows does not\nalready exist, the transaction fails with error `NOT_FOUND`."
|
| - },
|
| - "replace": {
|
| - "$ref": "Write",
|
| - "description": "Like insert, except that if the row already exists, it is\ndeleted, and the column values provided are inserted\ninstead. Unlike insert_or_update, this means any values not\nexplicitly written become `NULL`."
|
| - },
|
| - "delete": {
|
| - "$ref": "Delete",
|
| - "description": "Delete rows from a table. Succeeds whether or not the named\nrows were present."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1342,6 +1295,10 @@
|
| "description": "A Cloud Spanner database.",
|
| "id": "Database",
|
| "properties": {
|
| + "name": {
|
| + "description": "Required. The name of the database. Values are of the form\n`projects/<project>/instances/<instance>/databases/<database>`,\nwhere `<database>` is as specified in the `CREATE DATABASE`\nstatement. This name can be passed to other API methods to\nidentify the database.",
|
| + "type": "string"
|
| + },
|
| "state": {
|
| "description": "Output only. The current database state.",
|
| "enum": [
|
| @@ -1355,10 +1312,6 @@
|
| "The database is fully created and ready for use."
|
| ],
|
| "type": "string"
|
| - },
|
| - "name": {
|
| - "description": "Required. The name of the database. Values are of the form\n`projects/<project>/instances/<instance>/databases/<database>`,\nwhere `<database>` is as specified in the `CREATE DATABASE`\nstatement. This name can be passed to other API methods to\nidentify the database.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1367,6 +1320,22 @@
|
| "description": "An isolated set of Cloud Spanner resources on which databases can be hosted.",
|
| "id": "Instance",
|
| "properties": {
|
| + "displayName": {
|
| + "description": "Required. The descriptive name for this instance as it appears in UIs.\nMust be unique per project and between 4 and 30 characters in length.",
|
| + "type": "string"
|
| + },
|
| + "nodeCount": {
|
| + "description": "Required. The number of nodes allocated to this instance. This may be zero\nin API responses for instances that are not yet in state `READY`.",
|
| + "format": "int32",
|
| + "type": "integer"
|
| + },
|
| + "labels": {
|
| + "additionalProperties": {
|
| + "type": "string"
|
| + },
|
| + "description": "Cloud Labels are a flexible and lightweight mechanism for organizing cloud\nresources into groups that reflect a customer's organizational needs and\ndeployment strategies. Cloud Labels can be used to filter collections of\nresources. They can be used to control how resource metrics are aggregated.\nAnd they can be used as arguments to policy management rules (e.g. route,\nfirewall, load balancing, etc.).\n\n * Label keys must be between 1 and 63 characters long and must conform to\n the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.\n * Label values must be between 0 and 63 characters long and must conform\n to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.\n * No more than 64 labels can be associated with a given resource.\n\nSee https://goo.gl/xmQnxf for more information on and examples of labels.\n\nIf you plan to use labels in your own code, please note that additional\ncharacters may be allowed in the future. And so you are advised to use an\ninternal label representation, such as JSON, which doesn't rely upon\nspecific characters being disallowed. For example, representing labels\nas the string: name + \"_\" + value would prove problematic if we were to\nallow \"_\" in a future release.",
|
| + "type": "object"
|
| + },
|
| "config": {
|
| "description": "Required. The name of the instance's configuration. Values are of the form\n`projects/<project>/instanceConfigs/<configuration>`. See\nalso InstanceConfig and\nListInstanceConfigs.",
|
| "type": "string"
|
| @@ -1388,22 +1357,6 @@
|
| "name": {
|
| "description": "Required. A unique identifier for the instance, which cannot be changed\nafter the instance is created. Values are of the form\n`projects/<project>/instances/a-z*[a-z0-9]`. The final\nsegment of the name must be between 6 and 30 characters in length.",
|
| "type": "string"
|
| - },
|
| - "displayName": {
|
| - "description": "Required. The descriptive name for this instance as it appears in UIs.\nMust be unique per project and between 4 and 30 characters in length.",
|
| - "type": "string"
|
| - },
|
| - "nodeCount": {
|
| - "description": "Required. The number of nodes allocated to this instance. This may be zero\nin API responses for instances that are not yet in state `READY`.",
|
| - "format": "int32",
|
| - "type": "integer"
|
| - },
|
| - "labels": {
|
| - "additionalProperties": {
|
| - "type": "string"
|
| - },
|
| - "description": "Cloud Labels are a flexible and lightweight mechanism for organizing cloud\nresources into groups that reflect a customer's organizational needs and\ndeployment strategies. Cloud Labels can be used to filter collections of\nresources. They can be used to control how resource metrics are aggregated.\nAnd they can be used as arguments to policy management rules (e.g. route,\nfirewall, load balancing, etc.).\n\n * Label keys must be between 1 and 63 characters long and must conform to\n the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.\n * Label values must be between 0 and 63 characters long and must conform\n to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.\n * No more than 64 labels can be associated with a given resource.\n\nSee https://goo.gl/xmQnxf for more information on and examples of labels.\n\nIf you plan to use labels in your own code, please note that additional\ncharacters may be allowed in the future. And so you are advised to use an\ninternal label representation, such as JSON, which doesn't rely upon\nspecific characters being disallowed. For example, representing labels\nas the string: name + \"_\" + value would prove problematic if we were to\nallow \"_\" in a future release.",
|
| - "type": "object"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1412,14 +1365,14 @@
|
| "description": "Request message for `SetIamPolicy` method.",
|
| "id": "SetIamPolicyRequest",
|
| "properties": {
|
| - "policy": {
|
| - "$ref": "Policy",
|
| - "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An empty policy is a\nvalid policy but certain Cloud Platform services (such as Projects)\nmight reject them."
|
| - },
|
| "updateMask": {
|
| "description": "OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only\nthe fields in the mask will be modified. If no mask is provided, the\nfollowing default mask is used:\npaths: \"bindings, etag\"\nThis field is only used by Cloud IAM.",
|
| "format": "google-fieldmask",
|
| "type": "string"
|
| + },
|
| + "policy": {
|
| + "$ref": "Policy",
|
| + "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An empty policy is a\nvalid policy but certain Cloud Platform services (such as Projects)\nmight reject them."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1501,13 +1454,13 @@
|
| "description": "Options for counters",
|
| "id": "CounterOptions",
|
| "properties": {
|
| - "metric": {
|
| - "description": "The metric to update.",
|
| - "type": "string"
|
| - },
|
| "field": {
|
| "description": "The field value to attribute.",
|
| "type": "string"
|
| + },
|
| + "metric": {
|
| + "description": "The metric to update.",
|
| + "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1555,6 +1508,20 @@
|
| },
|
| "type": "object"
|
| },
|
| + "TestIamPermissionsRequest": {
|
| + "description": "Request message for `TestIamPermissions` method.",
|
| + "id": "TestIamPermissionsRequest",
|
| + "properties": {
|
| + "permissions": {
|
| + "description": "REQUIRED: The set of permissions to check for 'resource'.\nPermissions with wildcards (such as '*', 'spanner.*', 'spanner.instances.*') are not allowed.",
|
| + "items": {
|
| + "type": "string"
|
| + },
|
| + "type": "array"
|
| + }
|
| + },
|
| + "type": "object"
|
| + },
|
| "ResultSetStats": {
|
| "description": "Additional statistics about a ResultSet or PartialResultSet.",
|
| "id": "ResultSetStats",
|
| @@ -1574,20 +1541,6 @@
|
| },
|
| "type": "object"
|
| },
|
| - "TestIamPermissionsRequest": {
|
| - "description": "Request message for `TestIamPermissions` method.",
|
| - "id": "TestIamPermissionsRequest",
|
| - "properties": {
|
| - "permissions": {
|
| - "description": "REQUIRED: The set of permissions to check for 'resource'.\nPermissions with wildcards (such as '*', 'spanner.*', 'spanner.instances.*') are not allowed.",
|
| - "items": {
|
| - "type": "string"
|
| - },
|
| - "type": "array"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| "CommitResponse": {
|
| "description": "The response for Commit.",
|
| "id": "CommitResponse",
|
| @@ -1604,6 +1557,10 @@
|
| "description": "`Type` indicates the type of a Cloud Spanner value, as might be stored in a\ntable cell or returned from an SQL query.",
|
| "id": "Type",
|
| "properties": {
|
| + "arrayElementType": {
|
| + "$ref": "Type",
|
| + "description": "If code == ARRAY, then `array_element_type`\nis the type of the array elements."
|
| + },
|
| "code": {
|
| "description": "Required. The TypeCode for this type.",
|
| "enum": [
|
| @@ -1634,11 +1591,7 @@
|
| },
|
| "structType": {
|
| "$ref": "StructType",
|
| - "description": "If code == STRUCT, then `struct_type`\nprovides type information for the struct's fields."
|
| - },
|
| - "arrayElementType": {
|
| - "$ref": "Type",
|
| - "description": "If code == ARRAY, then `array_element_type`\nis the type of the array elements."
|
| + "description": "If code == STRUCT, then `struct_type`\nprovides type information for the struct's fields."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1647,14 +1600,6 @@
|
| "description": "Node information for nodes appearing in a QueryPlan.plan_nodes.",
|
| "id": "PlanNode",
|
| "properties": {
|
| - "metadata": {
|
| - "additionalProperties": {
|
| - "description": "Properties of the object.",
|
| - "type": "any"
|
| - },
|
| - "description": "Attributes relevant to the node contained in a group of key-value pairs.\nFor example, a Parameter Reference node could have the following\ninformation in its metadata:\n\n {\n \"parameter_reference\": \"param1\",\n \"parameter_type\": \"array\"\n }",
|
| - "type": "object"
|
| - },
|
| "executionStats": {
|
| "additionalProperties": {
|
| "description": "Properties of the object.",
|
| @@ -1672,10 +1617,6 @@
|
| "format": "int32",
|
| "type": "integer"
|
| },
|
| - "displayName": {
|
| - "description": "The display name for the node.",
|
| - "type": "string"
|
| - },
|
| "kind": {
|
| "description": "Used to determine the type of node. May be needed for visualizing\ndifferent kinds of nodes differently. For example, If the node is a\nSCALAR node, it will have a condensed representation\nwhich can be used to directly embed a description of the node in its\nparent.",
|
| "enum": [
|
| @@ -1690,12 +1631,24 @@
|
| ],
|
| "type": "string"
|
| },
|
| + "displayName": {
|
| + "description": "The display name for the node.",
|
| + "type": "string"
|
| + },
|
| "childLinks": {
|
| "description": "List of child node `index`es and their relationship to this parent.",
|
| "items": {
|
| "$ref": "ChildLink"
|
| },
|
| "type": "array"
|
| + },
|
| + "metadata": {
|
| + "additionalProperties": {
|
| + "description": "Properties of the object.",
|
| + "type": "any"
|
| + },
|
| + "description": "Attributes relevant to the node contained in a group of key-value pairs.\nFor example, a Parameter Reference node could have the following\ninformation in its metadata:\n\n {\n \"parameter_reference\": \"param1\",\n \"parameter_type\": \"array\"\n }",
|
| + "type": "object"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1704,24 +1657,24 @@
|
| "description": "Metadata type for the operation returned by\nCreateInstance.",
|
| "id": "CreateInstanceMetadata",
|
| "properties": {
|
| + "endTime": {
|
| + "description": "The time at which this operation failed or was completed successfully.",
|
| + "format": "google-datetime",
|
| + "type": "string"
|
| + },
|
| "cancelTime": {
|
| "description": "The time at which this operation was cancelled. If set, this operation is\nin the process of undoing itself (which is guaranteed to succeed) and\ncannot be cancelled again.",
|
| "format": "google-datetime",
|
| "type": "string"
|
| },
|
| - "endTime": {
|
| - "description": "The time at which this operation failed or was completed successfully.",
|
| + "startTime": {
|
| + "description": "The time at which the\nCreateInstance request was\nreceived.",
|
| "format": "google-datetime",
|
| "type": "string"
|
| },
|
| "instance": {
|
| "$ref": "Instance",
|
| "description": "The instance being created."
|
| - },
|
| - "startTime": {
|
| - "description": "The time at which the\nCreateInstance request was\nreceived.",
|
| - "format": "google-datetime",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1730,6 +1683,12 @@
|
| "description": "Specifies the audit configuration for a service.\nThe configuration determines which permission types are logged, and what\nidentities, if any, are exempted from logging.\nAn AuditConfig must have one or more AuditLogConfigs.\n\nIf there are AuditConfigs for both `allServices` and a specific service,\nthe union of the two AuditConfigs is used for that service: the log_types\nspecified in each AuditConfig are enabled, and the exempted_members in each\nAuditConfig are exempted.\n\nExample Policy with multiple AuditConfigs:\n\n {\n \"audit_configs\": [\n {\n \"service\": \"allServices\"\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:foo@gmail.com\"\n ]\n },\n {\n \"log_type\": \"DATA_WRITE\",\n },\n {\n \"log_type\": \"ADMIN_READ\",\n }\n ]\n },\n {\n \"service\": \"fooservice.googleapis.com\"\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n },\n {\n \"log_type\": \"DATA_WRITE\",\n \"exempted_members\": [\n \"user:bar@gmail.com\"\n ]\n }\n ]\n }\n ]\n }\n\nFor fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ\nlogging. It also exempts foo@gmail.com from DATA_READ logging, and\nbar@gmail.com from DATA_WRITE logging.",
|
| "id": "AuditConfig",
|
| "properties": {
|
| + "exemptedMembers": {
|
| + "items": {
|
| + "type": "string"
|
| + },
|
| + "type": "array"
|
| + },
|
| "service": {
|
| "description": "Specifies a service that will be enabled for audit logging.\nFor example, `storage.googleapis.com`, `cloudsql.googleapis.com`.\n`allServices` is a special value that covers all services.",
|
| "type": "string"
|
| @@ -1740,12 +1699,6 @@
|
| "$ref": "AuditLogConfig"
|
| },
|
| "type": "array"
|
| - },
|
| - "exemptedMembers": {
|
| - "items": {
|
| - "type": "string"
|
| - },
|
| - "type": "array"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1754,18 +1707,18 @@
|
| "description": "Metadata associated with a parent-child relationship appearing in a\nPlanNode.",
|
| "id": "ChildLink",
|
| "properties": {
|
| - "childIndex": {
|
| - "description": "The node to which the link points.",
|
| - "format": "int32",
|
| - "type": "integer"
|
| + "type": {
|
| + "description": "The type of the link. For example, in Hash Joins this could be used to\ndistinguish between the build child and the probe child, or in the case\nof the child being an output variable, to represent the tag associated\nwith the output variable.",
|
| + "type": "string"
|
| },
|
| "variable": {
|
| "description": "Only present if the child node is SCALAR and corresponds\nto an output variable of the parent node. The field carries the name of\nthe output variable.\nFor example, a `TableScan` operator that reads rows from a table will\nhave child links to the `SCALAR` nodes representing the output variables\ncreated for each column that is read by the operator. The corresponding\n`variable` fields will be set to the variable names assigned to the\ncolumns.",
|
| "type": "string"
|
| },
|
| - "type": {
|
| - "description": "The type of the link. For example, in Hash Joins this could be used to\ndistinguish between the build child and the probe child, or in the case\nof the child being an output variable, to represent the tag associated\nwith the output variable.",
|
| - "type": "string"
|
| + "childIndex": {
|
| + "description": "The node to which the link points.",
|
| + "format": "int32",
|
| + "type": "integer"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1773,7 +1726,45 @@
|
| "CloudAuditOptions": {
|
| "description": "Write a Cloud Audit log",
|
| "id": "CloudAuditOptions",
|
| - "properties": {},
|
| + "properties": {
|
| + "logName": {
|
| + "description": "The log_name to populate in the Cloud Audit Record.",
|
| + "enum": [
|
| + "UNSPECIFIED_LOG_NAME",
|
| + "ADMIN_ACTIVITY",
|
| + "DATA_ACCESS"
|
| + ],
|
| + "enumDescriptions": [
|
| + "Default. Should not be used.",
|
| + "Corresponds to \"cloudaudit.googleapis.com/activity\"",
|
| + "Corresponds to \"cloudaudit.googleapis.com/data_access\""
|
| + ],
|
| + "type": "string"
|
| + }
|
| + },
|
| + "type": "object"
|
| + },
|
| + "Expr": {
|
| + "description": "Represents an expression text. Example:\n\n title: \"User account presence\"\n description: \"Determines whether the request has a user account\"\n expression: \"size(request.user) > 0\"",
|
| + "id": "Expr",
|
| + "properties": {
|
| + "expression": {
|
| + "description": "Textual representation of an expression in\n[Common Expression Language](http://go/api-expr) syntax.\n\nThe application context of the containing message determines which\nwell-known feature set of CEL is supported.",
|
| + "type": "string"
|
| + },
|
| + "location": {
|
| + "description": "An optional string indicating the location of the expression for error\nreporting, e.g. a file name and a position in the file.",
|
| + "type": "string"
|
| + },
|
| + "title": {
|
| + "description": "An optional title for the expression, i.e. a short string describing\nits purpose. This can be used e.g. in UIs which allow to enter the\nexpression.",
|
| + "type": "string"
|
| + },
|
| + "description": {
|
| + "description": "An optional description of the expression. This is a longer text which\ndescribes the expression, e.g. when hovered over it in a UI.",
|
| + "type": "string"
|
| + }
|
| + },
|
| "type": "object"
|
| },
|
| "Delete": {
|
| @@ -1795,16 +1786,16 @@
|
| "description": "The response for ListInstanceConfigs.",
|
| "id": "ListInstanceConfigsResponse",
|
| "properties": {
|
| - "nextPageToken": {
|
| - "description": "`next_page_token` can be sent in a subsequent\nListInstanceConfigs call to\nfetch more of the matching instance configurations.",
|
| - "type": "string"
|
| - },
|
| "instanceConfigs": {
|
| "description": "The list of requested instance configurations.",
|
| "items": {
|
| "$ref": "InstanceConfig"
|
| },
|
| "type": "array"
|
| + },
|
| + "nextPageToken": {
|
| + "description": "`next_page_token` can be sent in a subsequent\nListInstanceConfigs call to\nfetch more of the matching instance configurations.",
|
| + "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1824,10 +1815,6 @@
|
| "description": "The request for Commit.",
|
| "id": "CommitRequest",
|
| "properties": {
|
| - "singleUseTransaction": {
|
| - "$ref": "TransactionOptions",
|
| - "description": "Execute mutations in a temporary transaction. Note that unlike\ncommit of a previously-started transaction, commit with a\ntemporary transaction is non-idempotent. That is, if the\n`CommitRequest` is sent to Cloud Spanner more than once (for\ninstance, due to retries in the application, or in the\ntransport library), it is possible that the mutations are\nexecuted more than once. If this is undesirable, use\nBeginTransaction and\nCommit instead."
|
| - },
|
| "mutations": {
|
| "description": "The mutations to be executed when this transaction commits. All\nmutations are applied atomically, in the order they appear in\nthis list.",
|
| "items": {
|
| @@ -1835,6 +1822,10 @@
|
| },
|
| "type": "array"
|
| },
|
| + "singleUseTransaction": {
|
| + "$ref": "TransactionOptions",
|
| + "description": "Execute mutations in a temporary transaction. Note that unlike\ncommit of a previously-started transaction, commit with a\ntemporary transaction is non-idempotent. That is, if the\n`CommitRequest` is sent to Cloud Spanner more than once (for\ninstance, due to retries in the application, or in the\ntransport library), it is possible that the mutations are\nexecuted more than once. If this is undesirable, use\nBeginTransaction and\nCommit instead."
|
| + },
|
| "transactionId": {
|
| "description": "Commit a previously-started transaction.",
|
| "format": "byte",
|
| @@ -1843,12 +1834,6 @@
|
| },
|
| "type": "object"
|
| },
|
| - "GetIamPolicyRequest": {
|
| - "description": "Request message for `GetIamPolicy` method.",
|
| - "id": "GetIamPolicyRequest",
|
| - "properties": {},
|
| - "type": "object"
|
| - },
|
| "TestIamPermissionsResponse": {
|
| "description": "Response message for `TestIamPermissions` method.",
|
| "id": "TestIamPermissionsResponse",
|
| @@ -1863,28 +1848,16 @@
|
| },
|
| "type": "object"
|
| },
|
| + "GetIamPolicyRequest": {
|
| + "description": "Request message for `GetIamPolicy` method.",
|
| + "id": "GetIamPolicyRequest",
|
| + "properties": {},
|
| + "type": "object"
|
| + },
|
| "Rule": {
|
| "description": "A rule to be applied in a Policy.",
|
| "id": "Rule",
|
| "properties": {
|
| - "description": {
|
| - "description": "Human-readable description of the rule.",
|
| - "type": "string"
|
| - },
|
| - "conditions": {
|
| - "description": "Additional restrictions that must be met",
|
| - "items": {
|
| - "$ref": "Condition"
|
| - },
|
| - "type": "array"
|
| - },
|
| - "logConfig": {
|
| - "description": "The config returned to callers of tech.iam.IAM.CheckPolicy for any entries\nthat match the LOG action.",
|
| - "items": {
|
| - "$ref": "LogConfig"
|
| - },
|
| - "type": "array"
|
| - },
|
| "in": {
|
| "description": "If one or more 'in' clauses are specified, the rule matches if\nthe PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.",
|
| "items": {
|
| @@ -1925,6 +1898,24 @@
|
| "type": "string"
|
| },
|
| "type": "array"
|
| + },
|
| + "description": {
|
| + "description": "Human-readable description of the rule.",
|
| + "type": "string"
|
| + },
|
| + "conditions": {
|
| + "description": "Additional restrictions that must be met",
|
| + "items": {
|
| + "$ref": "Condition"
|
| + },
|
| + "type": "array"
|
| + },
|
| + "logConfig": {
|
| + "description": "The config returned to callers of tech.iam.IAM.CheckPolicy for any entries\nthat match the LOG action.",
|
| + "items": {
|
| + "$ref": "LogConfig"
|
| + },
|
| + "type": "array"
|
| }
|
| },
|
| "type": "object"
|
| @@ -1944,6 +1935,10 @@
|
| "description": "Specifies what kind of log the caller must write",
|
| "id": "LogConfig",
|
| "properties": {
|
| + "cloudAudit": {
|
| + "$ref": "CloudAuditOptions",
|
| + "description": "Cloud audit options."
|
| + },
|
| "counter": {
|
| "$ref": "CounterOptions",
|
| "description": "Counter options."
|
| @@ -1951,10 +1946,6 @@
|
| "dataAccess": {
|
| "$ref": "DataAccessOptions",
|
| "description": "Data access options."
|
| - },
|
| - "cloudAudit": {
|
| - "$ref": "CloudAuditOptions",
|
| - "description": "Cloud audit options."
|
| }
|
| },
|
| "type": "object"
|
| @@ -1970,30 +1961,19 @@
|
| },
|
| "type": "object"
|
| },
|
| - "ListInstancesResponse": {
|
| - "description": "The response for ListInstances.",
|
| - "id": "ListInstancesResponse",
|
| + "KeyRange": {
|
| + "description": "KeyRange represents a range of rows in a table or index.\n\nA range has a start key and an end key. These keys can be open or\nclosed, indicating if the range includes rows with that key.\n\nKeys are represented by lists, where the ith value in the list\ncorresponds to the ith component of the table or index primary key.\nIndividual values are encoded as described here.\n\nFor example, consider the following table definition:\n\n CREATE TABLE UserEvents (\n UserName STRING(MAX),\n EventDate STRING(10)\n ) PRIMARY KEY(UserName, EventDate);\n\nThe following keys name rows in this table:\n\n \"Bob\", \"2014-09-23\"\n\nSince the `UserEvents` table's `PRIMARY KEY` clause names two\ncolumns, each `UserEvents` key has two elements; the first is the\n`UserName`, and the second is the `EventDate`.\n\nKey ranges with multiple components are interpreted\nlexicographically by component using the table or index key's declared\nsort order. For example, the following range returns all events for\nuser `\"Bob\"` that occurred in the year 2015:\n\n \"start_closed\": [\"Bob\", \"2015-01-01\"]\n \"end_closed\": [\"Bob\", \"2015-12-31\"]\n\nStart and end keys can omit trailing key components. This affects the\ninclusion and exclusion of rows that exactly match the provided key\ncomponents: if the key is closed, then rows that exactly match the\nprovided components are included; if the key is open, then rows\nthat exactly match are not included.\n\nFor example, the following range includes all events for `\"Bob\"` that\noccurred during and after the year 2000:\n\n \"start_closed\": [\"Bob\", \"2000-01-01\"]\n \"end_closed\": [\"Bob\"]\n\nThe next example retrieves all events for `\"Bob\"`:\n\n \"start_closed\": [\"Bob\"]\n \"end_closed\": [\"Bob\"]\n\nTo retrieve events before the year 2000:\n\n \"start_closed\": [\"Bob\"]\n \"end_open\": [\"Bob\", \"2000-01-01\"]\n\nThe following range includes all rows in the table:\n\n \"start_closed\": []\n \"end_closed\": []\n\nThis range returns all users whose `UserName` begins with any\ncharacter from A to C:\n\n \"start_closed\": [\"A\"]\n \"end_open\": [\"D\"]\n\nThis range returns all users whose `UserName` begins with B:\n\n \"start_closed\": [\"B\"]\n \"end_open\": [\"C\"]\n\nKey ranges honor column sort order. For example, suppose a table is\ndefined as follows:\n\n CREATE TABLE DescendingSortedTable {\n Key INT64,\n ...\n ) PRIMARY KEY(Key DESC);\n\nThe following range retrieves all rows with key values between 1\nand 100 inclusive:\n\n \"start_closed\": [\"100\"]\n \"end_closed\": [\"1\"]\n\nNote that 100 is passed as the start, and 1 is passed as the end,\nbecause `Key` is a descending column in the schema.",
|
| + "id": "KeyRange",
|
| "properties": {
|
| - "instances": {
|
| - "description": "The list of requested instances.",
|
| + "endOpen": {
|
| + "description": "If the end is open, then the range excludes rows whose first\n`len(end_open)` key columns exactly match `end_open`.",
|
| "items": {
|
| - "$ref": "Instance"
|
| + "type": "any"
|
| },
|
| "type": "array"
|
| },
|
| - "nextPageToken": {
|
| - "description": "`next_page_token` can be sent in a subsequent\nListInstances call to fetch more\nof the matching instances.",
|
| - "type": "string"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| - "KeyRange": {
|
| - "description": "KeyRange represents a range of rows in a table or index.\n\nA range has a start key and an end key. These keys can be open or\nclosed, indicating if the range includes rows with that key.\n\nKeys are represented by lists, where the ith value in the list\ncorresponds to the ith component of the table or index primary key.\nIndividual values are encoded as described here.\n\nFor example, consider the following table definition:\n\n CREATE TABLE UserEvents (\n UserName STRING(MAX),\n EventDate STRING(10)\n ) PRIMARY KEY(UserName, EventDate);\n\nThe following keys name rows in this table:\n\n \"Bob\", \"2014-09-23\"\n\nSince the `UserEvents` table's `PRIMARY KEY` clause names two\ncolumns, each `UserEvents` key has two elements; the first is the\n`UserName`, and the second is the `EventDate`.\n\nKey ranges with multiple components are interpreted\nlexicographically by component using the table or index key's declared\nsort order. For example, the following range returns all events for\nuser `\"Bob\"` that occurred in the year 2015:\n\n \"start_closed\": [\"Bob\", \"2015-01-01\"]\n \"end_closed\": [\"Bob\", \"2015-12-31\"]\n\nStart and end keys can omit trailing key components. This affects the\ninclusion and exclusion of rows that exactly match the provided key\ncomponents: if the key is closed, then rows that exactly match the\nprovided components are included; if the key is open, then rows\nthat exactly match are not included.\n\nFor example, the following range includes all events for `\"Bob\"` that\noccurred during and after the year 2000:\n\n \"start_closed\": [\"Bob\", \"2000-01-01\"]\n \"end_closed\": [\"Bob\"]\n\nThe next example retrieves all events for `\"Bob\"`:\n\n \"start_closed\": [\"Bob\"]\n \"end_closed\": [\"Bob\"]\n\nTo retrieve events before the year 2000:\n\n \"start_closed\": [\"Bob\"]\n \"end_open\": [\"Bob\", \"2000-01-01\"]\n\nThe following range includes all rows in the table:\n\n \"start_closed\": []\n \"end_closed\": []\n\nThis range returns all users whose `UserName` begins with any\ncharacter from A to C:\n\n \"start_closed\": [\"A\"]\n \"end_open\": [\"D\"]\n\nThis range returns all users whose `UserName` begins with B:\n\n \"start_closed\": [\"B\"]\n \"end_open\": [\"C\"]\n\nKey ranges honor column sort order. For example, suppose a table is\ndefined as follows:\n\n CREATE TABLE DescendingSortedTable {\n Key INT64,\n ...\n ) PRIMARY KEY(Key DESC);\n\nThe following range retrieves all rows with key values between 1\nand 100 inclusive:\n\n \"start_closed\": [\"100\"]\n \"end_closed\": [\"1\"]\n\nNote that 100 is passed as the start, and 1 is passed as the end,\nbecause `Key` is a descending column in the schema.",
|
| - "id": "KeyRange",
|
| - "properties": {
|
| - "startClosed": {
|
| - "description": "If the start is closed, then the range includes all rows whose\nfirst `len(start_closed)` key columns exactly match `start_closed`.",
|
| + "endClosed": {
|
| + "description": "If the end is closed, then the range includes all rows whose\nfirst `len(end_closed)` key columns exactly match `end_closed`.",
|
| "items": {
|
| "type": "any"
|
| },
|
| @@ -2006,19 +1986,30 @@
|
| },
|
| "type": "array"
|
| },
|
| - "endOpen": {
|
| - "description": "If the end is open, then the range excludes rows whose first\n`len(end_open)` key columns exactly match `end_open`.",
|
| + "startClosed": {
|
| + "description": "If the start is closed, then the range includes all rows whose\nfirst `len(start_closed)` key columns exactly match `start_closed`.",
|
| "items": {
|
| "type": "any"
|
| },
|
| "type": "array"
|
| - },
|
| - "endClosed": {
|
| - "description": "If the end is closed, then the range includes all rows whose\nfirst `len(end_closed)` key columns exactly match `end_closed`.",
|
| + }
|
| + },
|
| + "type": "object"
|
| + },
|
| + "ListInstancesResponse": {
|
| + "description": "The response for ListInstances.",
|
| + "id": "ListInstancesResponse",
|
| + "properties": {
|
| + "instances": {
|
| + "description": "The list of requested instances.",
|
| "items": {
|
| - "type": "any"
|
| + "$ref": "Instance"
|
| },
|
| "type": "array"
|
| + },
|
| + "nextPageToken": {
|
| + "description": "`next_page_token` can be sent in a subsequent\nListInstances call to fetch more\nof the matching instances.",
|
| + "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2046,13 +2037,13 @@
|
| "description": "A possible configuration for a Cloud Spanner instance. Configurations\ndefine the geographic placement of nodes and their replication.",
|
| "id": "InstanceConfig",
|
| "properties": {
|
| - "displayName": {
|
| - "description": "The name of this instance configuration as it appears in UIs.",
|
| - "type": "string"
|
| - },
|
| "name": {
|
| "description": "A unique identifier for the instance configuration. Values\nare of the form\n`projects/<project>/instanceConfigs/a-z*`",
|
| "type": "string"
|
| + },
|
| + "displayName": {
|
| + "description": "The name of this instance configuration as it appears in UIs.",
|
| + "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2061,14 +2052,14 @@
|
| "description": "The request for UpdateInstance.",
|
| "id": "UpdateInstanceRequest",
|
| "properties": {
|
| - "instance": {
|
| - "$ref": "Instance",
|
| - "description": "Required. The instance to update, which must always include the instance\nname. Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included."
|
| - },
|
| "fieldMask": {
|
| "description": "Required. A mask specifying which fields in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated.\nThe field mask must always be specified; this prevents any future fields in\n[][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know\nabout them.",
|
| "format": "google-fieldmask",
|
| "type": "string"
|
| + },
|
| + "instance": {
|
| + "$ref": "Instance",
|
| + "description": "Required. The instance to update, which must always include the instance\nname. Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2083,13 +2074,13 @@
|
| "description": "# Transactions\n\n\nEach session can have at most one active transaction at a time. After the\nactive transaction is completed, the session can immediately be\nre-used for the next transaction. It is not necessary to create a\nnew session for each transaction.\n\n# Transaction Modes\n\nCloud Spanner supports two transaction modes:\n\n 1. Locking read-write. This type of transaction is the only way\n to write data into Cloud Spanner. These transactions rely on\n pessimistic locking and, if necessary, two-phase commit.\n Locking read-write transactions may abort, requiring the\n application to retry.\n\n 2. Snapshot read-only. This transaction type provides guaranteed\n consistency across several reads, but does not allow\n writes. Snapshot read-only transactions can be configured to\n read at timestamps in the past. Snapshot read-only\n transactions do not need to be committed.\n\nFor transactions that only read, snapshot read-only transactions\nprovide simpler semantics and are almost always faster. In\nparticular, read-only transactions do not take locks, so they do\nnot conflict with read-write transactions. As a consequence of not\ntaking locks, they also do not abort, so retry loops are not needed.\n\nTransactions may only read/write data in a single database. They\nmay, however, read/write data in different tables within that\ndatabase.\n\n## Locking Read-Write Transactions\n\nLocking transactions may be used to atomically read-modify-write\ndata anywhere in a database. This type of transaction is externally\nconsistent.\n\nClients should attempt to minimize the amount of time a transaction\nis active. Faster transactions commit with higher probability\nand cause less contention. Cloud Spanner attempts to keep read locks\nactive as long as the transaction continues to do reads, and the\ntransaction has not been terminated by\nCommit or\nRollback. Long periods of\ninactivity at the client may cause Cloud Spanner to release a\ntransaction's locks and abort it.\n\nReads performed within a transaction acquire locks on the data\nbeing read. Writes can only be done at commit time, after all reads\nhave been completed.\nConceptually, a read-write transaction consists of zero or more\nreads or SQL queries followed by\nCommit. At any time before\nCommit, the client can send a\nRollback request to abort the\ntransaction.\n\n### Semantics\n\nCloud Spanner can commit the transaction if all read locks it acquired\nare still valid at commit time, and it is able to acquire write\nlocks for all writes. Cloud Spanner can abort the transaction for any\nreason. If a commit attempt returns `ABORTED`, Cloud Spanner guarantees\nthat the transaction has not modified any user data in Cloud Spanner.\n\nUnless the transaction commits, Cloud Spanner makes no guarantees about\nhow long the transaction's locks were held for. It is an error to\nuse Cloud Spanner locks for any sort of mutual exclusion other than\nbetween Cloud Spanner transactions themselves.\n\n### Retrying Aborted Transactions\n\nWhen a transaction aborts, the application can choose to retry the\nwhole transaction again. To maximize the chances of successfully\ncommitting the retry, the client should execute the retry in the\nsame session as the original attempt. The original session's lock\npriority increases with each consecutive abort, meaning that each\nattempt has a slightly better chance of success than the previous.\n\nUnder some circumstances (e.g., many transactions attempting to\nmodify the same row(s)), a transaction can abort many times in a\nshort period before successfully committing. Thus, it is not a good\nidea to cap the number of retries a transaction can attempt;\ninstead, it is better to limit the total amount of wall time spent\nretrying.\n\n### Idle Transactions\n\nA transaction is considered idle if it has no outstanding reads or\nSQL queries and has not started a read or SQL query within the last 10\nseconds. Idle transactions can be aborted by Cloud Spanner so that they\ndon't hold on to locks indefinitely. In that case, the commit will\nfail with error `ABORTED`.\n\nIf this behavior is undesirable, periodically executing a simple\nSQL query in the transaction (e.g., `SELECT 1`) prevents the\ntransaction from becoming idle.\n\n## Snapshot Read-Only Transactions\n\nSnapshot read-only transactions provides a simpler method than\nlocking read-write transactions for doing several consistent\nreads. However, this type of transaction does not support writes.\n\nSnapshot transactions do not take locks. Instead, they work by\nchoosing a Cloud Spanner timestamp, then executing all reads at that\ntimestamp. Since they do not acquire locks, they do not block\nconcurrent read-write transactions.\n\nUnlike locking read-write transactions, snapshot read-only\ntransactions never abort. They can fail if the chosen read\ntimestamp is garbage collected; however, the default garbage\ncollection policy is generous enough that most applications do not\nneed to worry about this in practice.\n\nSnapshot read-only transactions do not need to call\nCommit or\nRollback (and in fact are not\npermitted to do so).\n\nTo execute a snapshot transaction, the client specifies a timestamp\nbound, which tells Cloud Spanner how to choose a read timestamp.\n\nThe types of timestamp bound are:\n\n - Strong (the default).\n - Bounded staleness.\n - Exact staleness.\n\nIf the Cloud Spanner database to be read is geographically distributed,\nstale read-only transactions can execute more quickly than strong\nor read-write transaction, because they are able to execute far\nfrom the leader replica.\n\nEach type of timestamp bound is discussed in detail below.\n\n### Strong\n\nStrong reads are guaranteed to see the effects of all transactions\nthat have committed before the start of the read. Furthermore, all\nrows yielded by a single read are consistent with each other -- if\nany part of the read observes a transaction, all parts of the read\nsee the transaction.\n\nStrong reads are not repeatable: two consecutive strong read-only\ntransactions might return inconsistent results if there are\nconcurrent writes. If consistency across reads is required, the\nreads should be executed within a transaction or at an exact read\ntimestamp.\n\nSee TransactionOptions.ReadOnly.strong.\n\n### Exact Staleness\n\nThese timestamp bounds execute reads at a user-specified\ntimestamp. Reads at a timestamp are guaranteed to see a consistent\nprefix of the global transaction history: they observe\nmodifications done by all transactions with a commit timestamp <=\nthe read timestamp, and observe none of the modifications done by\ntransactions with a larger commit timestamp. They will block until\nall conflicting transactions that may be assigned commit timestamps\n<= the read timestamp have finished.\n\nThe timestamp can either be expressed as an absolute Cloud Spanner commit\ntimestamp or a staleness relative to the current time.\n\nThese modes do not require a \"negotiation phase\" to pick a\ntimestamp. As a result, they execute slightly faster than the\nequivalent boundedly stale concurrency modes. On the other hand,\nboundedly stale reads usually return fresher results.\n\nSee TransactionOptions.ReadOnly.read_timestamp and\nTransactionOptions.ReadOnly.exact_staleness.\n\n### Bounded Staleness\n\nBounded staleness modes allow Cloud Spanner to pick the read timestamp,\nsubject to a user-provided staleness bound. Cloud Spanner chooses the\nnewest timestamp within the staleness bound that allows execution\nof the reads at the closest available replica without blocking.\n\nAll rows yielded are consistent with each other -- if any part of\nthe read observes a transaction, all parts of the read see the\ntransaction. Boundedly stale reads are not repeatable: two stale\nreads, even if they use the same staleness bound, can execute at\ndifferent timestamps and thus return inconsistent results.\n\nBoundedly stale reads execute in two phases: the first phase\nnegotiates a timestamp among all replicas needed to serve the\nread. In the second phase, reads are executed at the negotiated\ntimestamp.\n\nAs a result of the two phase execution, bounded staleness reads are\nusually a little slower than comparable exact staleness\nreads. However, they are typically able to return fresher\nresults, and are more likely to execute at the closest replica.\n\nBecause the timestamp negotiation requires up-front knowledge of\nwhich rows will be read, it can only be used with single-use\nread-only transactions.\n\nSee TransactionOptions.ReadOnly.max_staleness and\nTransactionOptions.ReadOnly.min_read_timestamp.\n\n### Old Read Timestamps and Garbage Collection\n\nCloud Spanner continuously garbage collects deleted and overwritten data\nin the background to reclaim storage space. This process is known\nas \"version GC\". By default, version GC reclaims versions after they\nare one hour old. Because of this, Cloud Spanner cannot perform reads\nat read timestamps more than one hour in the past. This\nrestriction also applies to in-progress reads and/or SQL queries whose\ntimestamp become too old while executing. Reads and SQL queries with\ntoo-old read timestamps fail with the error `FAILED_PRECONDITION`.",
|
| "id": "TransactionOptions",
|
| "properties": {
|
| - "readWrite": {
|
| - "$ref": "ReadWrite",
|
| - "description": "Transaction may write.\n\nAuthorization to begin a read-write transaction requires\n`spanner.databases.beginOrRollbackReadWriteTransaction` permission\non the `session` resource."
|
| - },
|
| "readOnly": {
|
| "$ref": "ReadOnly",
|
| "description": "Transaction will not write.\n\nAuthorization to begin a read-only transaction requires\n`spanner.databases.beginReadOnlyTransaction` permission\non the `session` resource."
|
| + },
|
| + "readWrite": {
|
| + "$ref": "ReadWrite",
|
| + "description": "Transaction may write.\n\nAuthorization to begin a read-write transaction requires\n`spanner.databases.beginOrRollbackReadWriteTransaction` permission\non the `session` resource."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2131,6 +2122,33 @@
|
| "description": "A condition to be met.",
|
| "id": "Condition",
|
| "properties": {
|
| + "values": {
|
| + "description": "The objects of the condition. This is mutually exclusive with 'value'.",
|
| + "items": {
|
| + "type": "string"
|
| + },
|
| + "type": "array"
|
| + },
|
| + "iam": {
|
| + "description": "Trusted attributes supplied by the IAM system.",
|
| + "enum": [
|
| + "NO_ATTR",
|
| + "AUTHORITY",
|
| + "ATTRIBUTION",
|
| + "SECURITY_REALM",
|
| + "APPROVER",
|
| + "JUSTIFICATION_TYPE"
|
| + ],
|
| + "enumDescriptions": [
|
| + "Default non-attribute.",
|
| + "Either principal or (if present) authority selector.",
|
| + "The principal (even if an authority selector is present), which\nmust only be used for attribution, not authorization.",
|
| + "Any of the security realms in the IAMContext (go/security-realms).\nWhen used with IN, the condition indicates \"any of the request's realms\nmatch one of the given values; with NOT_IN, \"none of the realms match\nany of the given values\". It is not permitted to grant access based on\nthe *absence* of a realm, so realm conditions can only be used in\na \"positive\" context (e.g., ALLOW/IN or DENY/NOT_IN).",
|
| + "An approver (distinct from the requester) that has authorized this\nrequest.\nWhen used with IN, the condition indicates that one of the approvers\nassociated with the request matches the specified principal, or is a\nmember of the specified group. Approvers can only grant additional\naccess, and are thus only used in a strictly positive context\n(e.g. ALLOW/IN or DENY/NOT_IN).",
|
| + "What types of justifications have been supplied with this request.\nString values should match enum names from tech.iam.JustificationType,\ne.g. \"MANUAL_STRING\". It is not permitted to grant access based on\nthe *absence* of a justification, so justification conditions can only\nbe used in a \"positive\" context (e.g., ALLOW/IN or DENY/NOT_IN).\n\nMultiple justifications, e.g., a Buganizer ID and a manually-entered\nreason, are normal and supported."
|
| + ],
|
| + "type": "string"
|
| + },
|
| "op": {
|
| "description": "An operator to apply the subject with.",
|
| "enum": [
|
| @@ -2176,33 +2194,6 @@
|
| "IP address of the caller"
|
| ],
|
| "type": "string"
|
| - },
|
| - "values": {
|
| - "description": "The objects of the condition. This is mutually exclusive with 'value'.",
|
| - "items": {
|
| - "type": "string"
|
| - },
|
| - "type": "array"
|
| - },
|
| - "iam": {
|
| - "description": "Trusted attributes supplied by the IAM system.",
|
| - "enum": [
|
| - "NO_ATTR",
|
| - "AUTHORITY",
|
| - "ATTRIBUTION",
|
| - "SECURITY_REALM",
|
| - "APPROVER",
|
| - "JUSTIFICATION_TYPE"
|
| - ],
|
| - "enumDescriptions": [
|
| - "Default non-attribute.",
|
| - "Either principal or (if present) authority selector.",
|
| - "The principal (even if an authority selector is present), which\nmust only be used for attribution, not authorization.",
|
| - "Any of the security realms in the IAMContext (go/security-realms).\nWhen used with IN, the condition indicates \"any of the request's realms\nmatch one of the given values; with NOT_IN, \"none of the realms match\nany of the given values\". It is not permitted to grant access based on\nthe *absence* of a realm, so realm conditions can only be used in\na \"positive\" context (e.g., ALLOW/IN or DENY/NOT_IN).",
|
| - "An approver (distinct from the requester) that has authorized this\nrequest.\nWhen used with IN, the condition indicates that one of the approvers\nassociated with the request matches the specified principal, or is a\nmember of the specified group. Approvers can only grant additional\naccess, and are thus only used in a strictly positive context\n(e.g. ALLOW/IN or DENY/NOT_IN).\nSee: go/rpc-security-policy-dynamicauth.",
|
| - "What types of justifications have been supplied with this request.\nString values should match enum names from tech.iam.JustificationType,\ne.g. \"MANUAL_STRING\". It is not permitted to grant access based on\nthe *absence* of a justification, so justification conditions can only\nbe used in a \"positive\" context (e.g., ALLOW/IN or DENY/NOT_IN).\n\nMultiple justifications, e.g., a Buganizer ID and a manually-entered\nreason, are normal and supported."
|
| - ],
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2238,12 +2229,12 @@
|
| "type": "object"
|
| },
|
| "ReadOnly": {
|
| - "description": "Options for read-only transactions.",
|
| + "description": "Message type to initiate a read-only transaction.",
|
| "id": "ReadOnly",
|
| "properties": {
|
| - "maxStaleness": {
|
| - "description": "Read data at a timestamp >= `NOW - max_staleness`\nseconds. Guarantees that all writes that have committed more\nthan the specified number of seconds ago are visible. Because\nCloud Spanner chooses the exact timestamp, this mode works even if\nthe client's local clock is substantially skewed from Cloud Spanner\ncommit timestamps.\n\nUseful for reading the freshest data available at a nearby\nreplica, while bounding the possible staleness if the local\nreplica has fallen behind.\n\nNote that this option can only be used in single-use\ntransactions.",
|
| - "format": "google-duration",
|
| + "minReadTimestamp": {
|
| + "description": "Executes all reads at a timestamp >= `min_read_timestamp`.\n\nThis is useful for requesting fresher data than some previous\nread, or data that is fresh enough to observe the effects of some\npreviously committed transaction whose timestamp is known.\n\nNote that this option can only be used in single-use transactions.",
|
| + "format": "google-datetime",
|
| "type": "string"
|
| },
|
| "readTimestamp": {
|
| @@ -2251,6 +2242,11 @@
|
| "format": "google-datetime",
|
| "type": "string"
|
| },
|
| + "maxStaleness": {
|
| + "description": "Read data at a timestamp >= `NOW - max_staleness`\nseconds. Guarantees that all writes that have committed more\nthan the specified number of seconds ago are visible. Because\nCloud Spanner chooses the exact timestamp, this mode works even if\nthe client's local clock is substantially skewed from Cloud Spanner\ncommit timestamps.\n\nUseful for reading the freshest data available at a nearby\nreplica, while bounding the possible staleness if the local\nreplica has fallen behind.\n\nNote that this option can only be used in single-use\ntransactions.",
|
| + "format": "google-duration",
|
| + "type": "string"
|
| + },
|
| "returnReadTimestamp": {
|
| "description": "If true, the Cloud Spanner-selected read timestamp is included in\nthe Transaction message that describes the transaction.",
|
| "type": "boolean"
|
| @@ -2263,11 +2259,6 @@
|
| "strong": {
|
| "description": "Read at a timestamp where all previously committed transactions\nare visible.",
|
| "type": "boolean"
|
| - },
|
| - "minReadTimestamp": {
|
| - "description": "Executes all reads at a timestamp >= `min_read_timestamp`.\n\nThis is useful for requesting fresher data than some previous\nread, or data that is fresh enough to observe the effects of some\npreviously committed transaction whose timestamp is known.\n\nNote that this option can only be used in single-use transactions.",
|
| - "format": "google-datetime",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2276,6 +2267,24 @@
|
| "description": "The request for ExecuteSql and\nExecuteStreamingSql.",
|
| "id": "ExecuteSqlRequest",
|
| "properties": {
|
| + "queryMode": {
|
| + "description": "Used to control the amount of debugging information returned in\nResultSetStats.",
|
| + "enum": [
|
| + "NORMAL",
|
| + "PLAN",
|
| + "PROFILE"
|
| + ],
|
| + "enumDescriptions": [
|
| + "The default mode where only the query result, without any information\nabout the query plan is returned.",
|
| + "This mode returns only the query plan, without any result rows or\nexecution statistics information.",
|
| + "This mode returns both the query plan and the execution statistics along\nwith the result rows."
|
| + ],
|
| + "type": "string"
|
| + },
|
| + "transaction": {
|
| + "$ref": "TransactionSelector",
|
| + "description": "The transaction to use. If none is provided, the default is a\ntemporary read-only transaction with strong concurrency."
|
| + },
|
| "resumeToken": {
|
| "description": "If this request is resuming a previously interrupted SQL query\nexecution, `resume_token` should be copied from the last\nPartialResultSet yielded before the interruption. Doing this\nenables the new SQL query execution to resume where the last one left\noff. The rest of the request parameters must exactly match the\nrequest that yielded this token.",
|
| "format": "byte",
|
| @@ -2299,24 +2308,6 @@
|
| },
|
| "description": "The SQL query string can contain parameter placeholders. A parameter\nplaceholder consists of `'@'` followed by the parameter\nname. Parameter names consist of any combination of letters,\nnumbers, and underscores.\n\nParameters can appear anywhere that a literal value is expected. The same\nparameter name can be used more than once, for example:\n `\"WHERE id > @msg_id AND id < @msg_id + 100\"`\n\nIt is an error to execute an SQL query with unbound parameters.\n\nParameter values are specified using `params`, which is a JSON\nobject whose keys are parameter names, and whose values are the\ncorresponding parameter values.",
|
| "type": "object"
|
| - },
|
| - "queryMode": {
|
| - "description": "Used to control the amount of debugging information returned in\nResultSetStats.",
|
| - "enum": [
|
| - "NORMAL",
|
| - "PLAN",
|
| - "PROFILE"
|
| - ],
|
| - "enumDescriptions": [
|
| - "The default mode where only the query result, without any information\nabout the query plan is returned.",
|
| - "This mode returns only the query plan, without any result rows or\nexecution statistics information.",
|
| - "This mode returns both the query plan and the execution statistics along\nwith the result rows."
|
| - ],
|
| - "type": "string"
|
| - },
|
| - "transaction": {
|
| - "$ref": "TransactionSelector",
|
| - "description": "The transaction to use. If none is provided, the default is a\ntemporary read-only transaction with strong concurrency."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2348,7 +2339,7 @@
|
| "type": "array"
|
| },
|
| "bindings": {
|
| - "description": "Associates a list of `members` to a `role`.\nMultiple `bindings` must not be specified for the same `role`.\n`bindings` with no members will result in an error.",
|
| + "description": "Associates a list of `members` to a `role`.\n`bindings` with no members will result in an error.",
|
| "items": {
|
| "$ref": "Binding"
|
| },
|
| @@ -2366,6 +2357,19 @@
|
| "description": "The request for Read and\nStreamingRead.",
|
| "id": "ReadRequest",
|
| "properties": {
|
| + "limit": {
|
| + "description": "If greater than zero, only the first `limit` rows are yielded. If `limit`\nis zero, the default is no limit.",
|
| + "format": "int64",
|
| + "type": "string"
|
| + },
|
| + "index": {
|
| + "description": "If non-empty, the name of an index on table. This index is\nused instead of the table primary key when interpreting key_set\nand sorting result rows. See key_set for further information.",
|
| + "type": "string"
|
| + },
|
| + "keySet": {
|
| + "$ref": "KeySet",
|
| + "description": "Required. `key_set` identifies the rows to be yielded. `key_set` names the\nprimary keys of the rows in table to be yielded, unless index\nis present. If index is present, then key_set instead names\nindex keys in index.\n\nRows are yielded in table primary key order (if index is empty)\nor index key order (if index is non-empty).\n\nIt is not an error for the `key_set` to name rows that do not\nexist in the database. Read yields nothing for nonexistent rows."
|
| + },
|
| "columns": {
|
| "description": "The columns of table to be returned for each row matching\nthis request.",
|
| "items": {
|
| @@ -2385,19 +2389,6 @@
|
| "table": {
|
| "description": "Required. The name of the table in the database to be read.",
|
| "type": "string"
|
| - },
|
| - "limit": {
|
| - "description": "If greater than zero, only the first `limit` rows are yielded. If `limit`\nis zero, the default is no limit.",
|
| - "format": "int64",
|
| - "type": "string"
|
| - },
|
| - "index": {
|
| - "description": "If non-empty, the name of an index on table. This index is\nused instead of the table primary key when interpreting key_set\nand sorting result rows. See key_set for further information.",
|
| - "type": "string"
|
| - },
|
| - "keySet": {
|
| - "$ref": "KeySet",
|
| - "description": "Required. `key_set` identifies the rows to be yielded. `key_set` names the\nprimary keys of the rows in table to be yielded, unless index\nis present. If index is present, then key_set instead names\nindex keys in index.\n\nRows are yielded in table primary key order (if index is empty)\nor index key order (if index is non-empty).\n\nIt is not an error for the `key_set` to name rows that do not\nexist in the database. Read yields nothing for nonexistent rows."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2406,13 +2397,6 @@
|
| "description": "Arguments to insert, update, insert_or_update, and\nreplace operations.",
|
| "id": "Write",
|
| "properties": {
|
| - "columns": {
|
| - "description": "The names of the columns in table to be written.\n\nThe list of columns must contain enough columns to allow\nCloud Spanner to derive values for all primary key columns in the\nrow(s) to be modified.",
|
| - "items": {
|
| - "type": "string"
|
| - },
|
| - "type": "array"
|
| - },
|
| "values": {
|
| "description": "The values to be written. `values` can contain more than one\nlist of values. If it does, then multiple rows are written, one\nfor each entry in `values`. Each list in `values` must have\nexactly as many entries as there are entries in columns\nabove. Sending multiple lists is equivalent to sending multiple\n`Mutation`s, each containing one `values` entry and repeating\ntable and columns. Individual values in each list are\nencoded as described here.",
|
| "items": {
|
| @@ -2423,6 +2407,13 @@
|
| },
|
| "type": "array"
|
| },
|
| + "columns": {
|
| + "description": "The names of the columns in table to be written.\n\nThe list of columns must contain enough columns to allow\nCloud Spanner to derive values for all primary key columns in the\nrow(s) to be modified.",
|
| + "items": {
|
| + "type": "string"
|
| + },
|
| + "type": "array"
|
| + },
|
| "table": {
|
| "description": "Required. The table whose rows will be written.",
|
| "type": "string"
|
| @@ -2430,30 +2421,22 @@
|
| },
|
| "type": "object"
|
| },
|
| - "ReadWrite": {
|
| - "description": "Options for read-write transactions.",
|
| - "id": "ReadWrite",
|
| - "properties": {},
|
| - "type": "object"
|
| - },
|
| "DataAccessOptions": {
|
| "description": "Write a Data Access (Gin) log",
|
| "id": "DataAccessOptions",
|
| "properties": {},
|
| "type": "object"
|
| },
|
| + "ReadWrite": {
|
| + "description": "Message type to initiate a read-write transaction. Currently this\ntransaction type has no options.",
|
| + "id": "ReadWrite",
|
| + "properties": {},
|
| + "type": "object"
|
| + },
|
| "Operation": {
|
| "description": "This resource represents a long-running operation that is the result of a\nnetwork API call.",
|
| "id": "Operation",
|
| "properties": {
|
| - "response": {
|
| - "additionalProperties": {
|
| - "description": "Properties of the object. Contains field @type with type URL.",
|
| - "type": "any"
|
| - },
|
| - "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.",
|
| - "type": "object"
|
| - },
|
| "name": {
|
| "description": "The server-assigned name, which is only unique within the same service that\noriginally returns it. If you use the default HTTP mapping, the\n`name` should have the format of `operations/some/unique/name`.",
|
| "type": "string"
|
| @@ -2473,19 +2456,22 @@
|
| "done": {
|
| "description": "If the value is `false`, it means the operation is still in progress.\nIf true, the operation is completed, and either `error` or `response` is\navailable.",
|
| "type": "boolean"
|
| + },
|
| + "response": {
|
| + "additionalProperties": {
|
| + "description": "Properties of the object. Contains field @type with type URL.",
|
| + "type": "any"
|
| + },
|
| + "description": "The normal response of the operation in case of success. If the original\nmethod returns no data on success, such as `Delete`, the response is\n`google.protobuf.Empty`. If the original method is standard\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmethods, the response should have the type `XxxResponse`, where `Xxx`\nis the original method name. For example, if the original method name\nis `TakeSnapshot()`, the inferred response type is\n`TakeSnapshotResponse`.",
|
| + "type": "object"
|
| }
|
| },
|
| "type": "object"
|
| },
|
| "Status": {
|
| - "description": "The `Status` type defines a logical error model that is suitable for different\nprogramming environments, including REST APIs and RPC APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error message,\nand error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` which can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting purpose.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
|
| + "description": "The `Status` type defines a logical error model that is suitable for different\nprogramming environments, including REST APIs and RPC APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is designed to be:\n\n- Simple to use and understand for most users\n- Flexible enough to meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pieces of data: error code, error message,\nand error details. The error code should be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes if needed. The\nerror message should be a developer-facing English message that helps\ndevelopers *understand* and *resolve* the error. If a localized user-facing\nerror message is needed, put the localized message in the error details or\nlocalize it in the client. The optional error details may contain arbitrary\ninformation about the error. There is a predefined set of error detail types\nin the package `google.rpc` that can be used for common error conditions.\n\n# Language mapping\n\nThe `Status` message is the logical representation of the error model, but it\nis not necessarily the actual wire format. When the `Status` message is\nexposed in different client libraries and different wire protocols, it can be\nmapped differently. For example, it will likely be mapped to some exceptions\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n\nThe error model and the `Status` message can be used in a variety of\nenvironments, either with or without APIs, to provide a\nconsistent developer experience across different environments.\n\nExample uses of this error model include:\n\n- Partial errors. If a service needs to return partial errors to the client,\n it may embed the `Status` in the normal response to indicate the partial\n errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step may\n have a `Status` message for error reporting.\n\n- Batch operations. If a client uses batch request and batch response, the\n `Status` message should be used directly inside batch response, one for\n each error sub-response.\n\n- Asynchronous operations. If an API call embeds asynchronous operation\n results in its response, the status of those operations should be\n represented directly using the `Status` message.\n\n- Logging. If some API errors are stored in logs, the message `Status` could\n be used directly after any stripping needed for security/privacy reasons.",
|
| "id": "Status",
|
| "properties": {
|
| - "code": {
|
| - "description": "The status code, which should be an enum value of google.rpc.Code.",
|
| - "format": "int32",
|
| - "type": "integer"
|
| - },
|
| "message": {
|
| "description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
|
| "type": "string"
|
| @@ -2500,6 +2486,11 @@
|
| "type": "object"
|
| },
|
| "type": "array"
|
| + },
|
| + "code": {
|
| + "description": "The status code, which should be an enum value of google.rpc.Code.",
|
| + "format": "int32",
|
| + "type": "integer"
|
| }
|
| },
|
| "type": "object"
|
| @@ -2508,6 +2499,10 @@
|
| "description": "Results from Read or\nExecuteSql.",
|
| "id": "ResultSet",
|
| "properties": {
|
| + "stats": {
|
| + "$ref": "ResultSetStats",
|
| + "description": "Query plan and execution statistics for the query that produced this\nresult set. These can be requested by setting\nExecuteSqlRequest.query_mode."
|
| + },
|
| "rows": {
|
| "description": "Each element in `rows` is a row whose format is defined by\nmetadata.row_type. The ith element\nin each row matches the ith field in\nmetadata.row_type. Elements are\nencoded based on type as described\nhere.",
|
| "items": {
|
| @@ -2521,10 +2516,6 @@
|
| "metadata": {
|
| "$ref": "ResultSetMetadata",
|
| "description": "Metadata about the result set, such as row type information."
|
| - },
|
| - "stats": {
|
| - "$ref": "ResultSetStats",
|
| - "description": "Query plan and execution statistics for the query that produced this\nresult set. These can be requested by setting\nExecuteSqlRequest.query_mode."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2534,7 +2525,7 @@
|
| "id": "Binding",
|
| "properties": {
|
| "members": {
|
| - "description": "Specifies the identities requesting access for a Cloud Platform resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@gmail.com` or `joe@example.com`.\n\n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n* `domain:{domain}`: A Google Apps domain name that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n",
|
| + "description": "Specifies the identities requesting access for a Cloud Platform resource.\n`members` can have the following values:\n\n* `allUsers`: A special identifier that represents anyone who is\n on the internet; with or without a Google account.\n\n* `allAuthenticatedUsers`: A special identifier that represents anyone\n who is authenticated with a Google account or a service account.\n\n* `user:{emailid}`: An email address that represents a specific Google\n account. For example, `alice@gmail.com` or `joe@example.com`.\n\n\n* `serviceAccount:{emailid}`: An email address that represents a service\n account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{emailid}`: An email address that represents a Google group.\n For example, `admins@example.com`.\n\n\n* `domain:{domain}`: A Google Apps domain name that represents all the\n users of that domain. For example, `google.com` or `example.com`.\n\n",
|
| "items": {
|
| "type": "string"
|
| },
|
| @@ -2543,6 +2534,10 @@
|
| "role": {
|
| "description": "Role that is assigned to `members`.\nFor example, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired",
|
| "type": "string"
|
| + },
|
| + "condition": {
|
| + "$ref": "Expr",
|
| + "description": "The condition that is associated with this binding.\nNOTE: an unsatisfied condition will not allow user access via current\nbinding. Different bindings, including their conditions, are examined\nindependently.\nThis field is GOOGLE_INTERNAL."
|
| }
|
| },
|
| "type": "object"
|
| @@ -2564,6 +2559,96 @@
|
| }
|
| },
|
| "type": "object"
|
| + },
|
| + "PartialResultSet": {
|
| + "description": "Partial results from a streaming read or SQL query. Streaming reads and\nSQL queries better tolerate large result sets, large rows, and large\nvalues, but are a little trickier to consume.",
|
| + "id": "PartialResultSet",
|
| + "properties": {
|
| + "stats": {
|
| + "$ref": "ResultSetStats",
|
| + "description": "Query plan and execution statistics for the query that produced this\nstreaming result set. These can be requested by setting\nExecuteSqlRequest.query_mode and are sent\nonly once with the last response in the stream."
|
| + },
|
| + "chunkedValue": {
|
| + "description": "If true, then the final value in values is chunked, and must\nbe combined with more values from subsequent `PartialResultSet`s\nto obtain a complete field value.",
|
| + "type": "boolean"
|
| + },
|
| + "values": {
|
| + "description": "A streamed result set consists of a stream of values, which might\nbe split into many `PartialResultSet` messages to accommodate\nlarge rows and/or large values. Every N complete values defines a\nrow, where N is equal to the number of entries in\nmetadata.row_type.fields.\n\nMost values are encoded based on type as described\nhere.\n\nIt is possible that the last value in values is \"chunked\",\nmeaning that the rest of the value is sent in subsequent\n`PartialResultSet`(s). This is denoted by the chunked_value\nfield. Two or more chunked values can be merged to form a\ncomplete value as follows:\n\n * `bool/number/null`: cannot be chunked\n * `string`: concatenate the strings\n * `list`: concatenate the lists. If the last element in a list is a\n `string`, `list`, or `object`, merge it with the first element in\n the next list by applying these rules recursively.\n * `object`: concatenate the (field name, field value) pairs. If a\n field name is duplicated, then apply these rules recursively\n to merge the field values.\n\nSome examples of merging:\n\n # Strings are concatenated.\n \"foo\", \"bar\" => \"foobar\"\n\n # Lists of non-strings are concatenated.\n [2, 3], [4] => [2, 3, 4]\n\n # Lists are concatenated, but the last and first elements are merged\n # because they are strings.\n [\"a\", \"b\"], [\"c\", \"d\"] => [\"a\", \"bc\", \"d\"]\n\n # Lists are concatenated, but the last and first elements are merged\n # because they are lists. Recursively, the last and first elements\n # of the inner lists are merged because they are strings.\n [\"a\", [\"b\", \"c\"]], [[\"d\"], \"e\"] => [\"a\", [\"b\", \"cd\"], \"e\"]\n\n # Non-overlapping object fields are combined.\n {\"a\": \"1\"}, {\"b\": \"2\"} => {\"a\": \"1\", \"b\": 2\"}\n\n # Overlapping object fields are merged.\n {\"a\": \"1\"}, {\"a\": \"2\"} => {\"a\": \"12\"}\n\n # Examples of merging objects containing lists of strings.\n {\"a\": [\"1\"]}, {\"a\": [\"2\"]} => {\"a\": [\"12\"]}\n\nFor a more complete example, suppose a streaming SQL query is\nyielding a result set whose rows contain a single string\nfield. The following `PartialResultSet`s might be yielded:\n\n {\n \"metadata\": { ... }\n \"values\": [\"Hello\", \"W\"]\n \"chunked_value\": true\n \"resume_token\": \"Af65...\"\n }\n {\n \"values\": [\"orl\"]\n \"chunked_value\": true\n \"resume_token\": \"Bqp2...\"\n }\n {\n \"values\": [\"d\"]\n \"resume_token\": \"Zx1B...\"\n }\n\nThis sequence of `PartialResultSet`s encodes two rows, one\ncontaining the field value `\"Hello\"`, and a second containing the\nfield value `\"World\" = \"W\" + \"orl\" + \"d\"`.",
|
| + "items": {
|
| + "type": "any"
|
| + },
|
| + "type": "array"
|
| + },
|
| + "metadata": {
|
| + "$ref": "ResultSetMetadata",
|
| + "description": "Metadata about the result set, such as row type information.\nOnly present in the first response."
|
| + },
|
| + "resumeToken": {
|
| + "description": "Streaming calls might be interrupted for a variety of reasons, such\nas TCP connection loss. If this occurs, the stream of results can\nbe resumed by re-sending the original request and including\n`resume_token`. Note that executing any other transaction in the\nsame session invalidates the token.",
|
| + "format": "byte",
|
| + "type": "string"
|
| + }
|
| + },
|
| + "type": "object"
|
| + },
|
| + "UpdateInstanceMetadata": {
|
| + "description": "Metadata type for the operation returned by\nUpdateInstance.",
|
| + "id": "UpdateInstanceMetadata",
|
| + "properties": {
|
| + "endTime": {
|
| + "description": "The time at which this operation failed or was completed successfully.",
|
| + "format": "google-datetime",
|
| + "type": "string"
|
| + },
|
| + "cancelTime": {
|
| + "description": "The time at which this operation was cancelled. If set, this operation is\nin the process of undoing itself (which is guaranteed to succeed) and\ncannot be cancelled again.",
|
| + "format": "google-datetime",
|
| + "type": "string"
|
| + },
|
| + "startTime": {
|
| + "description": "The time at which UpdateInstance\nrequest was received.",
|
| + "format": "google-datetime",
|
| + "type": "string"
|
| + },
|
| + "instance": {
|
| + "$ref": "Instance",
|
| + "description": "The desired end state of the update."
|
| + }
|
| + },
|
| + "type": "object"
|
| + },
|
| + "ListOperationsResponse": {
|
| + "description": "The response message for Operations.ListOperations.",
|
| + "id": "ListOperationsResponse",
|
| + "properties": {
|
| + "nextPageToken": {
|
| + "description": "The standard List next-page token.",
|
| + "type": "string"
|
| + },
|
| + "operations": {
|
| + "description": "A list of operations that matches the specified filter in the request.",
|
| + "items": {
|
| + "$ref": "Operation"
|
| + },
|
| + "type": "array"
|
| + }
|
| + },
|
| + "type": "object"
|
| + },
|
| + "ResultSetMetadata": {
|
| + "description": "Metadata about a ResultSet or PartialResultSet.",
|
| + "id": "ResultSetMetadata",
|
| + "properties": {
|
| + "rowType": {
|
| + "$ref": "StructType",
|
| + "description": "Indicates the field names and types for the rows in the result\nset. For example, a SQL query like `\"SELECT UserId, UserName FROM\nUsers\"` could return a `row_type` value like:\n\n \"fields\": [\n { \"name\": \"UserId\", \"type\": { \"code\": \"INT64\" } },\n { \"name\": \"UserName\", \"type\": { \"code\": \"STRING\" } },\n ]"
|
| + },
|
| + "transaction": {
|
| + "$ref": "Transaction",
|
| + "description": "If the read or SQL query began a transaction as a side-effect, the\ninformation about the new transaction is yielded here."
|
| + }
|
| + },
|
| + "type": "object"
|
| }
|
| },
|
| "servicePath": "",
|
|
|
Chromium Code Reviews
Issue 2973303002:
Api-Roll 51: 2017-07-10 (Closed)
