.. |ge| unicode:: 0x2265
.. _C2EC2Manual:
#####################
CROC Cloud API Client
#####################
.. important:: Для работы с CROC Cloud API Client требуется Python 3 |ge| 3.4
Для работы с различными API Облака КРОК можно использовать утилиты из пакета *c2-client*.
В состав пакета входят следующие утилиты:
- ``c2-as`` — клиент к Auto Scaling API;
- ``c2-bs`` — клиент к Backup API;
- ``c2-ct`` — клиент к CloudTrail API;
- ``c2-cw`` — клиент к CloudWatch API;
- ``c2-ec2`` — клиент к EC2 API;
- ``c2-eks`` — клиент к EKS API;
- ``c2-paas`` — клиент к PaaS API;
- ``c2-elb`` — клиент к Elastic Load Balancing API;
- ``c2-route53`` — клиент к Route53 API;
- ``c2rc-convert`` — утилита конвертации настроек для использования в ОС Windows.
Для управления ресурсами в Облаке КРОК с помощью API необходимы кастомизированные версии библиотек `python-boto `__ и `python-boto3 `__.
*********
Установка
*********
Все операционные системы
========================
.. code-block:: shell
pip install git+https://github.com/C2Devel/boto.git@2.46.1-CROC47
pip install git+https://github.com/C2Devel/boto3.git
pip install git+https://github.com/C2Devel/botocore.git
pip install c2client
*************
Использование
*************
Необходимо получить настройки для доступа по API.
Сделать это можно `в консоли управления облаком `_.
Нажмите на логин пользователя в правом верхнем углу и выберите :bdg-light:`Профиль` :octicon:`arrow-right` :bdg-light:`Получить настройки доступа к API`.
В переменной *C2_PROJECT* укажите идентификатор своего проекта.
Добавить полученные настройки в переменные окружения:
* Для ОС Windows нужно сконвертировать файл настроек и экпортировать переменные окружения:
.. code-block:: bash
C:\> c2rc-convert path\to\c2rc.sh path\to\c2rc.bat
C:\> call path\to\c2rc.bat
* Для OC Linux нужно экспортировать переменные окружения:
.. code-block:: bash
source path/to/c2rc.sh
Теперь можно использовать утилиты согласно :ref:`документации `. Например:
.. code-block:: bash
c2-ec2 DescribeAvailabilityZones
c2-eks DescribeCluster name backend_production