timeweb-cloud

API Timeweb Cloud позволяет вам управлять ресурсами в облаке программным способом с использованием обычных HTTP-запросов.

Множество функции, которые доступны в панели управления Timeweb Cloud, также доступны через API, что позволяет вам автоматизировать ваши собственные сценарии.

Эта библиотека позволяет вам легко использовать API Timeweb Cloud в вашем приложении на Python.

Документация API

Как определяется etag?

Установка

pip install timeweb-cloud

Пример использования

Библиотека поддерживает синхронный и асинхронный варианты использования. В примерах ниже используется синхронный вариант, но вы можете использовать асинхронный вариант, заменив tw = Timeweb(...) на tw = AsyncTimeweb(...)

from timeweb import Timeweb

tw = Timeweb('token')
account_status = tw.account.get_status()  # schemas.account.AccountStatus
print(account_status)

Что доступно?

• Аккаунт tw.account
• Базы данных tw.dbs
• Балансировщики tw.balancers
• Выделенные серверы tw.servers.dedics
• Домены tw.domains
• Облачные серверы tw.servers.cloud
• Образы tw.images
• Проекты tw.projects
• Токены API tw.tokens
• Kubernetes tw.k8s
• S3-хранилище tw.s3
• SSH-ключи tw.ssh_keys
• Почта tw.mail

Etag

Etag - это уникальный идентификатор, который используется для проверки изменений в API. Он будет использоваться чтобы определять текущею версию Swagger API, т.к. сейчас Swagger API Timeweb Cloud не имеет версионности и/или changelog'а. Получается он из запроса к спецификации OpenAPI по ссылке https://timeweb.cloud/api-docs-data/bundle.json. Сервер сам его возвращает и мы пока операемся на него. В будущем, когда/если Swagger API Timeweb Cloud будет иметь версионность и/или changelog, будем опираться на их версию Swagger API.