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 ที่สร้างขึ้นผ่านระบบ IBM Cloud IAM | XxX1234567890XxX | [x] |
SL_USERNAME | ผู้ใช้ Softlayer | goldyfruit | - |
SL_API_KEY | คีย์ API Softlayer | abc123def456ghi789klm0n | - |
เอกสารสำหรับ IBM Cloud Python SDK มีให้ที่นี่
IBM Cloud Python SDK ใช้ประโยชน์จาก Python SDK ที่มีอยู่เช่น:
SDK นี้รองรับ VPC Gen 2 เท่านั้น
| บริการ | คุณสมบัติ |
|---|---|
| CIS | Baremetal การจัดเก็บวัตถุ |
| DNS | โซนสาธารณะโซนส่วนตัว |
| em | รับบัญชีรับองค์กร |
| ฉัน | นโยบายบทบาท |
| พลัง | ระบบไฟฟ้า |
| ทรัพยากร | การผูกมัดกลุ่มอินสแตนซ์คีย์ |
| VPC | ACL, FIP, เกตเวย์, Geo, Image, Instance, Key, Load Balancer, Security, Subnet, Volume, 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 เป็น ID เพื่อดึงทรัพยากรPATCH (อัปเดต) ซึ่งหมายความว่าไม่สามารถอัปเดตทรัพยากรได้ ดูไฟล์ลิขสิทธิ์ที่รวมสำหรับข้อมูลเพิ่มเติม