ibmcloud-python-sdk стремится поговорить с IBM Cloud. Для этого требуется файл конфигурации. ibmcloud-python-sdk Favors clouds.yaml файл, но также может использовать переменные среды (см. Ниже) . Пример:
---
clouds :
default : demo-acc
demo-acc :
profile : demo
description : Credentials from my IBM Cloud demo account
key : XxX1234567890XxX
region : us-south
version : 2021-06-15
generation : 2
cis_username : [email protected]
cis_apikey : abc123def456ghi789klm0n
prod-acc :
profile : prod
description : Credentials from my IBM Cloud production account
key : zZz1234567890zZz
region : us-south
version : 2021-06-15
generation : 2
cis_username : [email protected]
cis_apikey : @@abc123def456ghi789klm0n@@ Файл clouds.yaml будет сначала поиск в каталог ~/.ibmcloud но это поведение может быть переоборудовано переменной среды.
| Переменная | Описание | Пример | Обязательный |
|---|---|---|---|
IC_CONFIG_FILE | Абсолютный путь к файлу clouds.yaml | ~/vault/ibm.yaml | [] |
IC_CONFIG_NAME | Имя конфигурации облака по умолчанию | demo | [] |
IC_REGION | Регион должен был подключиться | us-south | [x] |
IC_VERSION | Запрашивает версию API | 2021-06-15 | [x] |
IC_GENERATION | Генерация инфраструктуры для запроса | 2 | [x] |
IC_SDK_CONFIG_FILE | Абсолютный путь к файлу sdk.yaml | ~/.config/ibmcloud/sdk.yaml | [] |
IC_API_KEY | Ключ API, созданный через систему IAM IAM IAM | XxX1234567890XxX | [x] |
SL_USERNAME | Пользователь Softlayer | goldyfruit | [] |
SL_API_KEY | SoftLayer API -ключ | abc123def456ghi789klm0n | [] |
Документация для IBM Cloud Python SDK доступна здесь.
IBM Cloud Python SDK использует существующие SDK Python, такие как:
Только VPC Gen 2 поддерживается этим SDK.
| Услуга | Особенность |
|---|---|
| Цис - | Baremetal, хранение объектов |
| DNS | Общественная зона, частная зона |
| ЭМ | Получить учетную запись, получить предприятие |
| Я | Политики, роли |
| ВЛАСТЬ | Система питания |
| РЕСУРС | Привязка, группа, экземпляр, ключ |
| VPC | ACL, FIP, Gateway, Geo, изображение, экземпляр, ключ, балансировщик нагрузки, безопасность, подсеть, громкость, VPC, VPN |
Установите из PYPI через pip :
python -m venv ~ /virtualenvs/ibmcloud-python-sdk
source ~ /virtualenvs/ibmcloud-python-sdk/bin/activate
pip install ibmcloud-python-sdkИли вы можете установить из источника:
cd ~ /Git
git clone https://github.com/goldyfruit/ibmcloud-python-sdk.git
python -m venv ~ /virtualenvs/ibmcloud-python-sdk
source ~ /virtualenvs/ibmcloud-python-sdk/bin/activate
cd ~ /Git/ibmcloud-python-sdk
pip install .Мы рекомендуем использовать виртуальную среду Python для установки SDK.
SDK обладает кэшированием ( memcached только на данный момент) для улучшения скорости HTTP -запросов. Чтобы включить этот механизм, пожалуйста, настройте SDK правильно, используя файл ~/.ibmcloud/sdk.yaml .
---
sdk :
cache_ttl : 60
memcached :
- 127.0.0.1:11211Серверы кеша муттипла также могут быть настроены.
---
sdk :
cache_ttl : 60
memcached :
- 127.0.0.1:11211
- 127.0.0.1:11212
- 127.0.0.1:11213 Простой способ развернуть memcached Server - использовать контейнер.
podman run -dt -p 11211:11211 --name memcached -d memcachedsudo docker run -dt -p 11211:11211 --name memcached -d memcachedСписок примеров того, как использовать этот SDK, можно найти здесь.
from ibmcloud_python_sdk . vpc import vpc as ic
vpc = ic . Vpc ()
vpc . get_vpc ( "ibmcloud-vpc-baby" ) from ibmcloud_python_sdk . vpc import vpc as icv
from ibmcloud_python_sdk . resource import resource_group as icr
import sys
# Variables
vpc_name = 'ibmcloud-vpc-baby'
resource_group_name = 'ibmcloud-resource-group-baby'
# Intentiate classes
vpc = icv . Vpc ()
rg = icr . ResourceGroup ()
# Retrieve resource group ID and check for error
resource_group_info = rg . get_resource_group ( resource_group_name )
if 'errors' in resource_group_info :
print ( resource_group_info [ 'errors' ])
sys . exit ()
# Create the VPC based on variable and resource group ID
response = vpc . create_vpc (
name = vpc_name ,
resource_group = resource_group_info [ 'id' ],
address_prefix_management = 'auto' ,
classic_access = True
)
# Check for error during the VPC creation process
if 'errors' in response :
print ( response [ 'errors' ])
else :
print ( response )CRN или HREF не могут быть использованы в качестве идентификатора для получения ресурсовPATCH (обновление) еще не поддерживается, что означает, что ресурс не может быть обновлен См. Файл лицензии в комплекте для получения дополнительной информации.