Selectel Storage API (v1.0)
Managing Object Storage resources. You can use it together with the S3 API or Swift API and manage versioning, domains, Virtual Hosted addressing, TLS certificates, logs, CORS, and more.
Получение настроек контейнера
Возвращает настройки контейнера, такие как видимость контейнера, кеширование, параметры авто-удаления, квоты, специальные страницы и т.д.
Authorizations:
path Parameters
| container_name required | string Container name |
Responses
Response samples
- 200
- 401
- 403
- 422
- default
{- "general": {
- "cache_control": "no-cache",
- "default_delete_after": 3600,
- "type": "private"
}, - "quota": {
- "max_bytes_used": 1024,
- "max_object_count": 10
}, - "web": {
- "error": "error.html",
- "error_status_code": 200,
- "index": "index.html",
- "listing_css": "style.css",
- "listing_enabled": true
}
}Установка настроек контейнера
Позволяет установить настройки контейнера, такие как видимость контейнера, кеширование, параметры авто-удаления, квоты, специальные страницы и т.д.
Authorizations:
path Parameters
| container_name required | string Container name |
Request Body schema: application/jsonrequired
Container options
object (ContainerGeneralOptionsBodySwagger) | |
object (ContainerQuotaOptionsBodySwagger) | |
object (ContainerWebOptionsBodySwagger) |
Responses
Request samples
- Payload
{- "general": {
- "cache_control": "max-age=604800",
- "default_delete_after": 3600,
- "type": "private"
}, - "quota": {
- "max_bytes_used": 1024,
- "max_object_count": 10
}, - "web": {
- "error": "error.html",
- "error_status_code": 200,
- "index": "index.html",
- "listing_css": "style.css",
- "listing_enabled": true
}
}Response samples
- 400
- 401
- 403
- 422
- default
{- "code": "string",
- "message": "error description"
}Получение списка публичных доменов контейнера
Возвращает список связанных с контейнером UUID идентификаторов публичных доменов.
Authorizations:
Responses
Response samples
- 200
- 400
- 401
- default
[- {
- "container": "images",
- "uuid": "82382b69-92e3-42cf-9b86-8e146fa58597"
}
]Создание задачи выгрузки логов
Создание асинхронной задачи на выгрузку логов запросов к контейнеру. Есть возможность настроить по какому контейнеру будет проходить выгрузка, указать какие поля в выгрузке необходимы, куда выгрузка будет сохранена и т.д.
Authorizations:
Request Body schema: application/jsonrequired
Logs task body
object | |
| type | string |
Responses
Request samples
- Payload
{- "data": {
- "container": "string",
- "delete_after": 0,
- "fields": [
- "string"
], - "filters": {
- "property1": { },
- "property2": { }
}, - "provider": "string",
- "since": "2019-05-14T06:00:00",
- "till": "2019-05-14T06:00:00"
}, - "type": "string"
}Response samples
- 200
- 400
- 401
- 403
- default
{- "task": {
- "created": "2019-05-14T06:00:00",
- "data": {
- "container": "target_container",
- "delete_after": 3600,
- "fields": [
- "string"
], - "filters": {
- "property1": { },
- "property2": { }
}, - "provider": "storage_access",
- "since": "2019-05-14T06:00:00",
- "till": "2019-05-14T06:00:00"
}, - "id": "string",
- "type": "string",
- "updated": "2019-05-14T06:00:00"
}
}Получение информации о задаче выгрузки логов
Возвращает информацию о созданной ранее задаче выгрузки логов.
Authorizations:
path Parameters
| task_id required | string Task ID |
Responses
Response samples
- 200
- 400
- 401
- 403
- 422
- default
{- "task": {
- "created": "2019-05-14T06:00:00",
- "data": {
- "container": "target_container",
- "delete_after": 3600,
- "fields": [
- "string"
], - "filters": {
- "property1": { },
- "property2": { }
}, - "provider": "storage_access",
- "since": "2019-05-14T06:00:00",
- "till": "2019-05-14T06:00:00"
}, - "id": "string",
- "type": "string",
- "updated": "2019-05-14T06:00:00"
}
}