Skip to content

Latest commit

 

History

History
48 lines (35 loc) · 3.34 KB

README.md

File metadata and controls

48 lines (35 loc) · 3.34 KB
Raw

timeweb-cloud

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

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

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

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

OpenAPI etag: 6409ee1d-10cd8d Как определяется etag?

PyPI version PyPI - Python Version PyPI - Downloads PyPI - License

Установка

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.