{ "mtlsRootUrl": "https://looker.mtls.googleapis.com/", "revision": "20260703", "parameters": { "fields": { "description": "Selector specifying which fields to include in a partial response.", "type": "string", "location": "query" }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "type": "string", "location": "query" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string", "location": "query" }, "callback": { "type": "string", "location": "query", "description": "JSONP" }, "quotaUser": { "type": "string", "location": "query", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters." }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "type": "string", "location": "query" }, "alt": { "type": "string", "location": "query", "description": "Data format for response.", "enum": [ "json", "media", "proto" ], "default": "json", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ] }, "prettyPrint": { "default": "true", "type": "boolean", "location": "query", "description": "Returns response with indentations and line breaks." }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "type": "string", "location": "query" }, "$.xgafv": { "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "description": "V1 error format.", "enum": [ "1", "2" ] }, "access_token": { "description": "OAuth access token.", "type": "string", "location": "query" } }, "discoveryVersion": "v1", "ownerName": "Google", "protocol": "rest", "fullyEncodeReservedExpansion": true, "resources": { "projects": { "resources": { "locations": { "resources": { "operations": { "methods": { "get": { "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "type": "string", "description": "The name of the operation resource.", "location": "path" } }, "response": { "$ref": "Operation" }, "httpMethod": "GET", "id": "looker.projects.locations.operations.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "type": "string" } }, "response": { "$ref": "Empty" }, "httpMethod": "DELETE", "id": "looker.projects.locations.operations.delete" }, "list": { "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "looker.projects.locations.operations.list", "parameters": { "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The standard list page size." }, "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "The name of the operation's parent resource.", "location": "path" } }, "response": { "$ref": "ListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "path": "v1/{+name}/operations" }, "cancel": { "path": "v1/{+name}:cancel", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "CancelOperationRequest" }, "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$" } }, "response": { "$ref": "Empty" }, "httpMethod": "POST", "id": "looker.projects.locations.operations.cancel", "parameterOrder": [ "name" ] } } }, "instances": { "methods": { "delete": { "parameters": { "force": { "description": "Whether to force cascading delete.", "location": "query", "type": "boolean" }, "name": { "location": "path", "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}`.", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$" } }, "response": { "$ref": "Operation" }, "id": "looker.projects.locations.instances.delete", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "description": "Delete instance.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "id": "looker.projects.locations.instances.get", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string" } }, "response": { "$ref": "Instance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "description": "Gets details of a single Instance.", "path": "v1/{+name}" }, "create": { "id": "looker.projects.locations.instances.create", "httpMethod": "POST", "parameters": { "parent": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. Format: `projects/{project}/locations/{location}`.", "location": "path" }, "instanceId": { "location": "query", "type": "string", "description": "Required. The unique instance identifier. Must contain only lowercase letters, numbers, or hyphens, with the first character a letter and the last a letter or a number. 63 characters maximum." } }, "response": { "$ref": "Operation" }, "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances", "description": "Creates a new Instance in a given project and location.", "path": "v1/{+parent}/instances", "request": { "$ref": "Instance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "undelete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "UndeleteInstanceRequest" }, "path": "v1/{+name}:undelete", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:undelete", "description": "Undeletes Looker instance.", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}" } }, "response": { "$ref": "Operation" }, "id": "looker.projects.locations.instances.undelete", "httpMethod": "POST" }, "restore": { "httpMethod": "POST", "id": "looker.projects.locations.instances.restore", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string", "description": "Required. Instance being restored Format: projects/{project}/locations/{location}/instances/{instance}", "location": "path" } }, "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ], "description": "Restore Looker instance.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:restore", "path": "v1/{+name}:restore", "request": { "$ref": "RestoreInstanceRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "import": { "parameterOrder": [ "name" ], "id": "looker.projects.locations.instances.import", "httpMethod": "POST", "parameters": { "name": { "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "required": true, "type": "string" } }, "response": { "$ref": "Operation" }, "request": { "$ref": "ImportInstanceRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:import", "description": "Import instance.", "path": "v1/{+name}:import" }, "patch": { "parameterOrder": [ "name" ], "httpMethod": "PATCH", "id": "looker.projects.locations.instances.patch", "parameters": { "updateMask": { "location": "query", "type": "string", "format": "google-fieldmask", "description": "Required. Field mask used to specify the fields to be overwritten in the Instance resource by the update. The fields specified in the mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask." }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Output only. Format: `projects/{project}/locations/{location}/instances/{instance}`." } }, "response": { "$ref": "Operation" }, "request": { "$ref": "Instance" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Update Instance.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}", "path": "v1/{+name}" }, "restart": { "parameters": { "name": { "location": "path", "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}`.", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "type": "string", "required": true } }, "response": { "$ref": "Operation" }, "id": "looker.projects.locations.instances.restart", "httpMethod": "POST", "parameterOrder": [ "name" ], "path": "v1/{+name}:restart", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:restart", "description": "Restart instance.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "RestartInstanceRequest" } }, "export": { "parameters": { "name": { "location": "path", "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}`.", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "type": "string", "required": true } }, "response": { "$ref": "Operation" }, "id": "looker.projects.locations.instances.export", "httpMethod": "POST", "parameterOrder": [ "name" ], "path": "v1/{+name}:export", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:export", "description": "Export instance.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "ExportInstanceRequest" } }, "list": { "parameters": { "showDeleted": { "description": "Optional. Whether to include deleted instances in the response.", "location": "query", "type": "boolean" }, "parent": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. Format: `projects/{project}/locations/{location}`.", "location": "path" }, "pageSize": { "description": "The maximum number of instances to return. If unspecified at most 256 will be returned. The maximum possible value is 2048.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token received from a previous ListInstancesRequest.", "location": "query", "type": "string" } }, "response": { "$ref": "ListInstancesResponse" }, "id": "looker.projects.locations.instances.list", "httpMethod": "GET", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/instances", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances", "description": "Lists Instances in a given project and location.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "backups": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups", "description": "List backups of Looker instance.", "path": "v1/{+parent}/backups", "parameterOrder": [ "parent" ], "id": "looker.projects.locations.instances.backups.list", "httpMethod": "GET", "parameters": { "parent": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}.", "location": "path" }, "pageSize": { "description": "The maximum number of instances to return.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token received from a previous ListInstances request.", "location": "query", "type": "string" }, "orderBy": { "description": "Sort results. Default order is \"create_time desc\". Other supported fields are \"state\" and \"expire_time\". https://google.aip.dev/132#ordering", "location": "query", "type": "string" } }, "response": { "$ref": "ListInstanceBackupsResponse" } }, "get": { "parameters": { "name": { "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+/backups/[^/]+$", "location": "path", "description": "Required. Format: `projects/{project}/locations/{location}/instances/{instance}/backups/{backup}`." } }, "response": { "$ref": "InstanceBackup" }, "httpMethod": "GET", "id": "looker.projects.locations.instances.backups.get", "parameterOrder": [ "name" ], "path": "v1/{+name}", "description": "", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups/{backupsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "delete": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups/{backupsId}", "description": "Delete backup.", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "looker.projects.locations.instances.backups.delete", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}/backups/{backup}", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+/backups/[^/]+$", "required": true, "type": "string" } }, "response": { "$ref": "Operation" }, "parameterOrder": [ "name" ] }, "create": { "parameterOrder": [ "parent" ], "httpMethod": "POST", "id": "looker.projects.locations.instances.backups.create", "parameters": { "parent": { "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$", "location": "path", "description": "Required. Format: projects/{project}/locations/{location}/instances/{instance}" } }, "response": { "$ref": "Operation" }, "request": { "$ref": "InstanceBackup" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Backup Looker instance.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}/backups", "path": "v1/{+parent}/backups" } } } } } }, "methods": { "list": { "httpMethod": "GET", "id": "looker.projects.locations.list", "parameters": { "name": { "description": "The resource that owns the locations collection, if applicable.", "location": "path", "pattern": "^projects/[^/]+$", "required": true, "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "The maximum number of results to return. If not set, the service selects a default." }, "extraLocationTypes": { "location": "query", "repeated": true, "type": "string", "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage." }, "filter": { "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, "pageToken": { "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query", "type": "string" } }, "response": { "$ref": "ListLocationsResponse" }, "parameterOrder": [ "name" ], "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "flatPath": "v1/projects/{projectsId}/locations", "path": "v1/{+name}/locations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "description": "Gets information about a location.", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Resource name for the location." } }, "response": { "$ref": "Location" }, "id": "looker.projects.locations.get", "httpMethod": "GET" } } } } } }, "ownerDomain": "google.com", "batchPath": "batch", "kind": "discovery#restDescription", "version": "v1", "description": "", "rootUrl": "https://looker.googleapis.com/", "schemas": { "DenyMaintenancePeriod": { "id": "DenyMaintenancePeriod", "type": "object", "description": "Specifies the maintenance denial period.", "properties": { "endDate": { "description": "Required. End date of the deny maintenance period.", "$ref": "Date" }, "time": { "description": "Required. Time in UTC when the period starts and ends.", "$ref": "TimeOfDay" }, "startDate": { "description": "Required. Start date of the deny maintenance period.", "$ref": "Date" } } }, "UserMetadata": { "description": "Metadata about users for a Looker instance.", "properties": { "additionalViewerUserCount": { "type": "integer", "format": "int32", "description": "Optional. The number of additional viewer users the instance owner has purchased." }, "additionalStandardUserCount": { "description": "Optional. The number of additional standard users the instance owner has purchased.", "type": "integer", "format": "int32" }, "additionalDeveloperUserCount": { "description": "Optional. The number of additional developer users the instance owner has purchased.", "type": "integer", "format": "int32" } }, "id": "UserMetadata", "type": "object" }, "RestoreInstanceRequest": { "description": "Request options for restoring an instance", "properties": { "backup": { "type": "string", "description": "Required. Backup being used to restore the instance Format: projects/{project}/locations/{location}/instances/{instance}/backups/{backup}" } }, "id": "RestoreInstanceRequest", "type": "object" }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "name": { "type": "string", "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", "type": "object" }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." }, "response": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`." } }, "id": "Operation", "type": "object" }, "ListInstanceBackupsResponse": { "id": "ListInstanceBackupsResponse", "type": "object", "description": "Response from listing Looker instance backups.", "properties": { "instanceBackups": { "type": "array", "items": { "$ref": "InstanceBackup" }, "description": "The list of instances matching the request filters, up to the requested `page_size`." }, "nextPageToken": { "description": "If provided, a page token that can look up the next `page_size` results. If empty, the results list is exhausted.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "MaintenanceSchedule": { "description": "Published upcoming future maintenance schedule.", "properties": { "startTime": { "type": "string", "format": "google-datetime", "description": "The scheduled start time for the maintenance." }, "endTime": { "description": "The scheduled end time for the maintenance.", "type": "string", "format": "google-datetime" } }, "id": "MaintenanceSchedule", "type": "object" }, "PeriodicExportConfig": { "id": "PeriodicExportConfig", "type": "object", "description": "Configuration for periodic export.", "properties": { "kmsKey": { "type": "string", "description": "Required. Name of the CMEK key in KMS. Format: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}" }, "gcsUri": { "type": "string", "description": "Required. Cloud Storage bucket URI for periodic export. Format: gs://{bucket_name}" }, "startTime": { "description": "Required. Time in UTC to start the periodic export job.", "$ref": "TimeOfDay" } } }, "ExportMetadata": { "description": "ExportMetadata represents the metadata of the exported artifacts. The metadata.json file in export artifact can be parsed as this message", "properties": { "lookerInstance": { "type": "string", "description": "Name of the exported instance. Format: projects/{project}/locations/{location}/instances/{instance}" }, "filePaths": { "description": "List of files created as part of export artifact (excluding the metadata). The paths are relative to the folder containing the metadata.", "type": "array", "items": { "type": "string" } }, "source": { "enumDescriptions": [ "Source not specified", "Source of export is Looker Core", "Source of export is Looker Original" ], "type": "string", "description": "The source type of the migration.", "enum": [ "SOURCE_UNSPECIFIED", "LOOKER_CORE", "LOOKER_ORIGINAL" ] }, "lookerVersion": { "type": "string", "description": "Version of instance when the export was created." }, "lookerPlatformEdition": { "description": "Platform edition of the exported instance.", "type": "string" }, "lookerEncryptionKey": { "type": "string", "description": "Looker encryption key, encrypted with the provided export encryption key. This value will only be populated if the looker instance uses Looker managed encryption instead of CMEK." }, "exportEncryptionKey": { "description": "Encryption key that was used to encrypt the export artifacts.", "$ref": "ExportMetadataEncryptionKey" } }, "id": "ExportMetadata", "type": "object" }, "Instance": { "id": "Instance", "type": "object", "description": "A Looker instance.", "properties": { "privateIpEnabled": { "description": "Whether private IP is enabled on the Looker instance.", "type": "boolean" }, "name": { "readOnly": true, "type": "string", "description": "Output only. Format: `projects/{project}/locations/{location}/instances/{instance}`." }, "fipsEnabled": { "type": "boolean", "description": "Optional. Whether FIPS is enabled on the Looker instance." }, "reservedRange": { "type": "string", "description": "Name of a reserved IP address range within the Instance.consumer_network, to be used for private services access connection. May or may not be specified in a create request." }, "encryptionConfig": { "description": "Encryption configuration (CMEK). Only set if CMEK has been enabled on the instance.", "$ref": "EncryptionConfig" }, "periodicExportConfig": { "description": "Optional. Configuration for periodic export.", "$ref": "PeriodicExportConfig" }, "state": { "enumDescriptions": [ "State is unspecified.", "Instance is active and ready for use.", "Instance provisioning is in progress.", "Instance is in a failed state.", "Instance was suspended.", "Instance update is in progress.", "Instance delete is in progress.", "Instance is being exported.", "Instance is importing data." ], "description": "Output only. The state of the instance.", "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CREATING", "FAILED", "SUSPENDED", "UPDATING", "DELETING", "EXPORTING", "IMPORTING" ], "readOnly": true, "type": "string" }, "denyMaintenancePeriod": { "description": "Maintenance denial period for this instance.", "$ref": "DenyMaintenancePeriod" }, "acceleratedSecurityPatchEnabled": { "type": "boolean", "description": "Optional. Accelerated security patch enabled for the instance." }, "classType": { "description": "Optional. Storage class of the instance.", "enum": [ "CLASS_TYPE_UNSPECIFIED", "R1", "P1" ], "type": "string", "enumDescriptions": [ "Unspecified storage class.", "Filestore.", "PD SSD." ] }, "updateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time when the Looker instance was last updated." }, "satisfiesPzi": { "readOnly": true, "type": "boolean", "description": "Output only. Reserved for future use." }, "suspendedTime": { "description": "Output only. The time when the Looker instance was suspended (soft deleted).", "readOnly": true, "type": "string", "format": "google-datetime" }, "lastDenyMaintenancePeriod": { "$ref": "DenyMaintenancePeriod", "readOnly": true, "description": "Output only. Last computed maintenance denial period for this instance." }, "lookerVersion": { "description": "Output only. The Looker version that the instance is using.", "readOnly": true, "type": "string" }, "adminSettings": { "description": "Looker Instance Admin settings.", "$ref": "AdminSettings" }, "pscEnabled": { "description": "Optional. Whether to use Private Service Connect (PSC) for private IP connectivity. If true, neither `public_ip_enabled` nor `private_ip_enabled` can be true.", "type": "boolean" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time when the Looker instance provisioning was first requested." }, "softDeleteReason": { "readOnly": true, "type": "string", "description": "Output only. The reason for the instance being in a soft-deleted state.", "enum": [ "SOFT_DELETE_REASON_UNSPECIFIED", "BILLING_ACCOUNT_ISSUE", "TRIAL_EXPIRED", "CUSTOMER_REQUEST" ], "enumDescriptions": [ "Soft delete reason is unspecified. This is the default value.", "Instance is soft deleted due to billing account issues.", "Instance is soft deleted due to trial expiration.", "Instance is soft deleted by the customer." ] }, "releaseChannel": { "description": "Optional. The selected release channel for the instance.", "enum": [ "RELEASE_CHANNEL_UNSPECIFIED", "RAPID", "REGULAR", "STABLE" ], "type": "string", "enumDescriptions": [ "Unspecified release channel.", "Rapid: Most frequent updates.", "Regular: Balanced, default for production.", "Stable: Least frequent, for maximum stability." ] }, "platformEdition": { "type": "string", "description": "Platform edition.", "enum": [ "PLATFORM_EDITION_UNSPECIFIED", "LOOKER_CORE_TRIAL", "LOOKER_CORE_STANDARD", "LOOKER_CORE_STANDARD_ANNUAL", "LOOKER_CORE_ENTERPRISE_ANNUAL", "LOOKER_CORE_EMBED_ANNUAL", "LOOKER_CORE_NONPROD_STANDARD_ANNUAL", "LOOKER_CORE_NONPROD_ENTERPRISE_ANNUAL", "LOOKER_CORE_NONPROD_EMBED_ANNUAL", "LOOKER_CORE_TRIAL_STANDARD", "LOOKER_CORE_TRIAL_ENTERPRISE", "LOOKER_CORE_TRIAL_EMBED" ], "enumDescriptions": [ "Represents an unspecified platform edition.", "Represents the Looker Core Trial edition.", "Represents the Looker Core Standard edition.", "Represents the Looker Core Standard Annual edition.", "Represents the Looker Core Enterprise Annual edition.", "Represents the Looker Core Embed Annual edition.", "Represents the Looker Core Nonprod Standard Annual edition.", "Represents the Looker Core Nonprod Enterprise Annual edition.", "Represents the Looker Core Nonprod Embed Annual edition.", "Represents the Looker Core Trial Standard edition.", "Represents the Looker Core Trial Enterprise edition.", "Represents the Looker Core Trial Embed edition." ] }, "ingressPublicIp": { "description": "Output only. Public Ingress IP (IPv4).", "readOnly": true, "type": "string" }, "satisfiesPzs": { "description": "Output only. Reserved for future use.", "readOnly": true, "type": "boolean" }, "customDomain": { "description": "Custom domain configuration for the instance.", "$ref": "CustomDomain" }, "maintenanceWindow": { "description": "Maintenance window for this instance.", "$ref": "MaintenanceWindow" }, "lookerUri": { "readOnly": true, "type": "string", "description": "Output only. Looker instance URI which can be used to access the Looker Instance UI." }, "userMetadata": { "description": "Optional. User metadata.", "$ref": "UserMetadata" }, "controlledEgressEnabled": { "description": "Optional. Whether controlled egress is enabled on the Looker instance.", "type": "boolean" }, "maintenanceSchedule": { "description": "Maintenance schedule for this instance.", "$ref": "MaintenanceSchedule" }, "controlledEgressConfig": { "description": "Optional. Controlled egress configuration.", "$ref": "ControlledEgressConfig" }, "geminiEnabled": { "type": "boolean", "description": "Optional. Whether Gemini feature is enabled on the Looker instance or not." }, "ingressPrivateIp": { "description": "Output only. Private Ingress IP (IPv4).", "readOnly": true, "type": "string" }, "oauthConfig": { "description": "Looker instance OAuth login settings.", "$ref": "OAuthConfig" }, "consumerNetwork": { "type": "string", "description": "Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance." }, "catalogIntegrationOptOut": { "description": "Optional. Indicates whether catalog integration is disabled for the Looker instance.", "type": "boolean" }, "egressPublicIp": { "description": "Output only. Public Egress IP (IPv4).", "readOnly": true, "type": "string" }, "ingressIpAllowlistConfig": { "description": "Optional. Ingress IP allowlist configuration for the Looker instance.", "$ref": "IngressIpAllowlistConfig" }, "publicIpEnabled": { "description": "Whether public IP is enabled on the Looker instance.", "type": "boolean" }, "pscConfig": { "description": "Optional. PSC configuration. Used when `psc_enabled` is true.", "$ref": "PscConfig" }, "linkedLspProjectNumber": { "description": "Optional. Linked Google Cloud Project Number for Looker Studio Pro.", "type": "string", "format": "int64" } } }, "CustomDomain": { "id": "CustomDomain", "type": "object", "description": "Custom domain information.", "properties": { "domain": { "type": "string", "description": "Domain name." }, "state": { "enumDescriptions": [ "Unspecified state.", "DNS record is not created.", "DNS record is created.", "Calling SLM to update.", "ManagedCertificate is ready.", "ManagedCertificate is not ready.", "Status is not known." ], "type": "string", "description": "Domain state.", "enum": [ "CUSTOM_DOMAIN_STATE_UNSPECIFIED", "UNVERIFIED", "VERIFIED", "MODIFYING", "AVAILABLE", "UNAVAILABLE", "UNKNOWN" ] } } }, "ListInstancesResponse": { "description": "Response from ListInstances.", "properties": { "instances": { "description": "The list of instances matching the request filters, up to the requested ListInstancesRequest.pageSize.", "type": "array", "items": { "$ref": "Instance" } }, "nextPageToken": { "description": "If provided, a page token that can look up the next ListInstancesRequest.pageSize results. If empty, the results list is exhausted.", "type": "string" }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations that could not be reached." } }, "id": "ListInstancesResponse", "type": "object" }, "InstanceBackup": { "description": "The details of a backup resource.", "properties": { "encryptionConfig": { "readOnly": true, "description": "Output only. Current status of the CMEK encryption", "$ref": "EncryptionConfig" }, "expireTime": { "description": "Output only. The time when the backup will be deleted.", "readOnly": true, "type": "string", "format": "google-datetime" }, "name": { "description": "Immutable. The relative resource name of the backup, in the following form: `projects/{project_number}/locations/{location_id}/instances/{instance_id}/backups/{backup}`", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time when the backup was started." }, "state": { "enumDescriptions": [ "The state of the backup is unknown.", "The backup is being created.", "The backup is being deleted.", "The backup is active and ready to use.", "The backup failed." ], "description": "Output only. The current state of the backup.", "enum": [ "STATE_UNSPECIFIED", "CREATING", "DELETING", "ACTIVE", "FAILED" ], "readOnly": true, "type": "string" } }, "id": "InstanceBackup", "type": "object" }, "OperationMetadata": { "description": "Represents the metadata of the long-running operation.", "properties": { "verb": { "description": "Name of the verb executed by the operation.", "type": "string" }, "endTime": { "description": "The time the operation finished running.", "type": "string", "format": "google-datetime" }, "createTime": { "description": "The time the operation was created.", "type": "string", "format": "google-datetime" }, "target": { "description": "Server-defined resource path for the target of the operation.", "type": "string" }, "statusMessage": { "type": "string", "description": "Human-readable status of the operation, if any." }, "apiVersion": { "type": "string", "description": "API version used to start the operation." }, "requestedCancellation": { "type": "boolean", "description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`." } }, "id": "OperationMetadata", "type": "object" }, "CancelOperationRequest": { "id": "CancelOperationRequest", "type": "object", "description": "The request message for Operations.CancelOperation.", "properties": {} }, "TimeOfDay": { "id": "TimeOfDay", "type": "object", "description": "Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`.", "properties": { "nanos": { "type": "integer", "format": "int32", "description": "Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999." }, "hours": { "type": "integer", "format": "int32", "description": "Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value \"24:00:00\" for scenarios like business closing time." }, "seconds": { "type": "integer", "format": "int32", "description": "Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds." }, "minutes": { "description": "Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.", "type": "integer", "format": "int32" } } }, "IngressIpAllowlistRule": { "id": "IngressIpAllowlistRule", "type": "object", "description": "Ingress IP allowlist rule.", "properties": { "description": { "description": "Optional. Description for the IP range.", "type": "string" }, "ipRange": { "description": "Optional. The IP range to allow ingress traffic from.", "type": "string" } } }, "RestartInstanceRequest": { "description": "Request options for restarting an instance.", "properties": {}, "id": "RestartInstanceRequest", "type": "object" }, "ListLocationsResponse": { "id": "ListLocationsResponse", "type": "object", "description": "The response message for Locations.ListLocations.", "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Location" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "ControlledEgressConfig": { "id": "ControlledEgressConfig", "type": "object", "description": "Controlled egress configuration.", "properties": { "egressFqdns": { "type": "array", "items": { "type": "string" }, "description": "Optional. List of fully qualified domain names to be added to the allowlist for outbound traffic." }, "marketplaceEnabled": { "description": "Optional. Whether marketplace is enabled.", "type": "boolean" }, "webProxyIps": { "readOnly": true, "type": "array", "items": { "type": "string" }, "description": "Output only. The list of IP addresses used by Secure Web Proxy for outbound traffic." } } }, "OAuthConfig": { "description": "Looker instance OAuth login settings.", "properties": { "clientSecret": { "type": "string", "description": "Input only. Client secret from an external OAuth application. This is an input-only field, and thus will not be set in any responses." }, "clientId": { "description": "Input only. Client ID from an external OAuth application. This is an input-only field, and thus will not be set in any responses.", "type": "string" }, "sharedOauthClientEnabled": { "description": "Optional. Whether to use the shared OAuth client. Instances specifying this field do not need to provide client_id and client_secret.", "type": "boolean" } }, "id": "OAuthConfig", "type": "object" }, "ListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "properties": { "operations": { "type": "array", "items": { "$ref": "Operation" }, "description": "A list of operations that matches the specified filter in the request." }, "nextPageToken": { "type": "string", "description": "The standard List next-page token." }, "unreachable": { "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "type": "array", "items": { "type": "string" } } }, "id": "ListOperationsResponse", "type": "object" }, "ImportInstanceRequest": { "description": "Requestion options for importing looker data to an Instance", "properties": { "gcsUri": { "description": "Path to the import folder in Google Cloud Storage, in the form `gs://bucketName/folderName`.", "type": "string" } }, "id": "ImportInstanceRequest", "type": "object" }, "Location": { "description": "A resource that represents a Google Cloud location.", "properties": { "metadata": { "type": "object", "description": "Service-specific metadata. For example the available capacity at the given location.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" } }, "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" }, "name": { "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}" }, "displayName": { "type": "string", "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\"." } }, "id": "Location", "type": "object" }, "ExportEncryptionConfig": { "description": "Configuration for Encryption - e.g. CMEK.", "properties": { "kmsKeyName": { "description": "Required. Name of the CMEK key in KMS.", "type": "string" } }, "id": "ExportEncryptionConfig", "type": "object" }, "Date": { "id": "Date", "type": "object", "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "properties": { "month": { "type": "integer", "format": "int32", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day." }, "day": { "type": "integer", "format": "int32", "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant." }, "year": { "type": "integer", "format": "int32", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year." } } }, "AdminSettings": { "id": "AdminSettings", "type": "object", "description": "Looker instance Admin settings fields.", "properties": { "allowedEmailDomains": { "description": "Email domain allowlist for the instance.", "type": "array", "items": { "type": "string" } } } }, "ExportMetadataEncryptionKey": { "description": "Encryption key details for the exported artifact.", "properties": { "cmek": { "description": "Name of the CMEK.", "type": "string" }, "version": { "description": "Version of the CMEK.", "type": "string" } }, "id": "ExportMetadataEncryptionKey", "type": "object" }, "ServiceAttachment": { "id": "ServiceAttachment", "type": "object", "description": "Service attachment configuration.", "properties": { "connectionStatus": { "readOnly": true, "type": "string", "description": "Output only. Connection status.", "enum": [ "UNKNOWN", "ACCEPTED", "PENDING", "REJECTED", "NEEDS_ATTENTION", "CLOSED" ], "enumDescriptions": [ "Connection status is unspecified.", "Connection is established and functioning normally.", "Connection is not established (Looker tenant project hasn't been allowlisted).", "Connection is not established (Looker tenant project is explicitly in reject list).", "Issue with target service attachment, e.g. NAT subnet is exhausted.", "Target service attachment does not exist. This status is a terminal state." ] }, "localFqdn": { "description": "Optional. Fully qualified domain name that will be used in the private DNS record created for the service attachment.", "type": "string" }, "localFqdns": { "description": "Optional. List of fully qualified domain names that will be used in the private DNS record created for the service attachment.", "type": "array", "items": { "type": "string" } }, "targetServiceAttachmentUri": { "description": "Required. URI of the service attachment to connect to. Format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment}", "type": "string" }, "failureReason": { "description": "Output only. Reason the service attachment creation failed. This value will only be populated if the service attachment encounters an issue during provisioning.", "readOnly": true, "type": "string" } } }, "ExportInstanceRequest": { "id": "ExportInstanceRequest", "type": "object", "description": "Request options for exporting data of an Instance.", "properties": { "gcsUri": { "type": "string", "description": "The path to the folder in Google Cloud Storage where the export will be stored. The URI is in the form `gs://bucketName/folderName`." }, "encryptionConfig": { "description": "Required. Encryption configuration (CMEK). For CMEK enabled instances it should be same as looker CMEK.", "$ref": "ExportEncryptionConfig" } } }, "EncryptionConfig": { "description": "Encryption configuration (i.e. CMEK).", "properties": { "kmsKeyName": { "description": "Name of the CMEK key in KMS (input parameter).", "type": "string" }, "kmsKeyState": { "enumDescriptions": [ "CMEK status not specified.", "CMEK key is currently valid.", "CMEK key is currently revoked (instance should in restricted mode)." ], "description": "Output only. Status of the CMEK key.", "enum": [ "KMS_KEY_STATE_UNSPECIFIED", "VALID", "REVOKED" ], "readOnly": true, "type": "string" }, "kmsKeyNameVersion": { "readOnly": true, "type": "string", "description": "Output only. Full name and version of the CMEK key currently in use to encrypt Looker data. Format: `projects/{project}/locations/{location}/keyRings/{ring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`. Empty if CMEK is not configured in this instance." } }, "id": "EncryptionConfig", "type": "object" }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "properties": { "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "type": "array", "items": { "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object" }, "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use." }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" } }, "id": "Status", "type": "object" }, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "properties": {}, "id": "Empty", "type": "object" }, "UndeleteInstanceRequest": { "description": "Request options for undeleting an instance.", "properties": {}, "id": "UndeleteInstanceRequest", "type": "object" }, "MaintenanceWindow": { "description": "Specifies the recurring maintenance window.", "properties": { "dayOfWeek": { "description": "Required. Day of the week for this MaintenanceWindow (in UTC).", "enum": [ "DAY_OF_WEEK_UNSPECIFIED", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "type": "string", "enumDescriptions": [ "The day of the week is unspecified.", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ] }, "startTime": { "description": "Required. Time in UTC when the period starts. Maintenance will be scheduled within 60 minutes.", "$ref": "TimeOfDay" } }, "id": "MaintenanceWindow", "type": "object" }, "IngressIpAllowlistConfig": { "id": "IngressIpAllowlistConfig", "type": "object", "description": "Ingress IP allowlist configuration.", "properties": { "allowlistRules": { "description": "Optional. List of IP range rules to allow ingress traffic.", "type": "array", "items": { "$ref": "IngressIpAllowlistRule" } }, "enabled": { "type": "boolean", "description": "Optional. Whether ingress IP allowlist functionality is enabled on the Looker instance." }, "googleServicesEnabled": { "type": "boolean", "description": "Optional. Whether google service connections are enabled for the instance." } } }, "PscConfig": { "description": "Information for Private Service Connect (PSC) setup for a Looker instance.", "properties": { "allowedVpcs": { "type": "array", "items": { "type": "string" }, "description": "Optional. List of VPCs that are allowed ingress into looker. Format: projects/{project}/global/networks/{network}" }, "serviceAttachments": { "description": "Optional. List of egress service attachment configurations.", "type": "array", "items": { "$ref": "ServiceAttachment" } }, "lookerServiceAttachmentUri": { "readOnly": true, "type": "string", "description": "Output only. URI of the Looker service attachment." } }, "id": "PscConfig", "type": "object" } }, "servicePath": "", "documentationLink": "https://cloud.google.com/looker/docs/reference/rest/", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "baseUrl": "https://looker.googleapis.com/", "name": "looker", "version_module": true, "canonicalName": "Looker", "id": "looker:v1", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "basePath": "", "title": "Looker (Google Cloud core) API" }