# REST Resource: projects.locations.catalogs

- [Resource: Catalog](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs#Catalog)
  - [JSON representation](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs#Catalog.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs#METHODS_SUMMARY)

## Resource: Catalog

Catalog is the container of databases.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name. Format: projects/{project_id_or_number}/locations/{locationId}/catalogs/{catalogId} |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The creation time of the catalog. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The last modification time of the catalog. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `deleteTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The deletion time of the catalog. Only set after the catalog is deleted. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `expireTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when this catalog is considered expired. Only set after the catalog is deleted. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs/create` | Creates a new catalog. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs/delete` | Deletes an existing catalog specified by the catalog ID. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs/get` | Gets the catalog specified by the resource name. |
| ### `https://docs.cloud.google.com/lakehouse/docs/reference/rest/v1/projects.locations.catalogs/list` | List all catalogs in a specified project. |