ibmcloud python sdk
v1.1.3
يهدف ibmcloud-python-sdk إلى التحدث إلى IBM Cloud. للقيام بذلك ، يتطلب ملف تكوين. ibmcloud-python-sdk تفضل ملف 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 الذي تم إنشاؤه عبر نظام IBM Cloud IAM | XxX1234567890XxX | [x] |
SL_USERNAME | مستخدم SoftLayer | goldyfruit | [] |
SL_API_KEY | مفتاح API SoftLayer | abc123def456ghi789klm0n | [] |
تتوفر وثائق لـ IBM Cloud Python SDK هنا.
تقوم IBM Cloud Python SDK بتعزيز Python SDKs الحالية مثل:
يتم دعم VPC Gen 2 فقط بواسطة SDK.
| خدمة | ميزة |
|---|---|
| رابطة الدول المستقلة | baremetal ، تخزين الكائن |
| DNS | المنطقة العامة ، المنطقة الخاصة |
| م | احصل على حساب ، احصل على المؤسسة |
| أنا أكون | السياسات ، الأدوار |
| قوة | نظام الطاقة |
| الموارد | الربط ، المجموعة ، مثيل ، مفتاح |
| VPC | ACL ، FIP ، Gateway ، Geo ، Image ، مثيل ، مفتاح ، موازن تحميل ، أمان ، شبكة فرعية ، حجم ، 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. لتمكين هذا mechanisim ، يرجى تكوين SDK بشكل صحيح باستخدام ملف ~/.ibmcloud/sdk.yaml .
---
sdk :
cache_ttl : 60
memcached :
- 127.0.0.1:11211يمكن تكوين خوادم ذاكرة التخزين المؤقت Muttiple أيضًا.
---
sdk :
cache_ttl : 60
memcached :
- 127.0.0.1:11211
- 127.0.0.1:11212
- 127.0.0.1:11213 تتمثل إحدى الطرق السهلة لنشر خادم memcached في استخدام الحاوية.
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 (التحديث) بعد ، مما يعني أنه لا يمكن تحديث مورد راجع ملف الترخيص المجمعة لمزيد من المعلومات.
