> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-metadata.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Storage Services

> Create and manage storage service connections

# Storage Services

A **Storage Service** represents a connection to a cloud storage platform (e.g., S3, GCS, ADLS). It is the root of the storage hierarchy and contains Containers.

<Info>
  Entity schema follows the [OpenMetadata Standard](https://openmetadatastandards.org/data-assets/storage/storage-service/).
</Info>

## Entity Hierarchy

Storage Services are at the top of the storage hierarchy:

<CodeGroup>
  ```txt Storage Service theme={null}
  StorageService (this page)
  └── Container
      └── Container (nested)
  ```
</CodeGroup>

***

## API Endpoints

| Method   | Endpoint                                               | Description                                                                         |
| -------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| `PUT`    | `/v1/services/storageServices`                         | [Create or update](/v1.12.x/api-reference/data-assets/storage-services/create)      |
| `POST`   | `/v1/services/storageServices`                         | [Create (POST variant)](/v1.12.x/api-reference/data-assets/storage-services/create) |
| `GET`    | `/v1/services/storageServices`                         | [List services](/v1.12.x/api-reference/data-assets/storage-services/list)           |
| `GET`    | `/v1/services/storageServices/{id}`                    | [Get by ID](/v1.12.x/api-reference/data-assets/storage-services/retrieve)           |
| `GET`    | `/v1/services/storageServices/name/{fqn}`              | [Get by name](/v1.12.x/api-reference/data-assets/storage-services/retrieve)         |
| `PATCH`  | `/v1/services/storageServices/{id}`                    | [Update by ID](/v1.12.x/api-reference/data-assets/storage-services/update)          |
| `PATCH`  | `/v1/services/storageServices/name/{fqn}`              | [Update by name](/v1.12.x/api-reference/data-assets/storage-services/update)        |
| `DELETE` | `/v1/services/storageServices/{id}`                    | [Delete by ID](/v1.12.x/api-reference/data-assets/storage-services/delete)          |
| `DELETE` | `/v1/services/storageServices/name/{fqn}`              | [Delete by name](/v1.12.x/api-reference/data-assets/storage-services/delete)        |
| `PUT`    | `/v1/services/storageServices/restore`                 | [Restore](/v1.12.x/api-reference/data-assets/storage-services/delete)               |
| `GET`    | `/v1/services/storageServices/{id}/versions`           | [List versions](/v1.12.x/api-reference/data-assets/storage-services/versions)       |
| `GET`    | `/v1/services/storageServices/{id}/versions/{version}` | [Get version](/v1.12.x/api-reference/data-assets/storage-services/versions)         |