> ## 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](/v2.0.x/api-reference/data-assets/storage-services/create) |
| `POST` | `/v1/services/storageServices` | [Create (POST variant)](/v2.0.x/api-reference/data-assets/storage-services/create) |
| `GET` | `/v1/services/storageServices` | [List services](/v2.0.x/api-reference/data-assets/storage-services/list) |
| `GET` | `/v1/services/storageServices/{id}` | [Get by ID](/v2.0.x/api-reference/data-assets/storage-services/retrieve) |
| `GET` | `/v1/services/storageServices/name/{fqn}` | [Get by name](/v2.0.x/api-reference/data-assets/storage-services/retrieve) |
| `PATCH` | `/v1/services/storageServices/{id}` | [Update by ID](/v2.0.x/api-reference/data-assets/storage-services/update) |
| `PATCH` | `/v1/services/storageServices/name/{fqn}` | [Update by name](/v2.0.x/api-reference/data-assets/storage-services/update) |
| `DELETE` | `/v1/services/storageServices/{id}` | [Delete by ID](/v2.0.x/api-reference/data-assets/storage-services/delete) |
| `DELETE` | `/v1/services/storageServices/name/{fqn}` | [Delete by name](/v2.0.x/api-reference/data-assets/storage-services/delete) |
| `PUT` | `/v1/services/storageServices/restore` | [Restore](/v2.0.x/api-reference/data-assets/storage-services/delete) |
| `GET` | `/v1/services/storageServices/{id}/versions` | [List versions](/v2.0.x/api-reference/data-assets/storage-services/versions) |
| `GET` | `/v1/services/storageServices/{id}/versions/{version}` | [Get version](/v2.0.x/api-reference/data-assets/storage-services/versions) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.