ibmcloud python sdkダウンロードibmcloud python sdkソースコードダウンロード

ibmcloud python sdk

パワービルダー

v1.1.3

ダウンロード

IBM Cloud Python SDK
- 環境変数
- ドキュメント
- サポートされている機能
- インストール
- キャッシング
  - ポッドマン
  - Docker
- 例
  - VPCSをリストします
  - VPCインスタンスを作成します
- よくある質問

IBM Cloud Python SDK

ibmcloud-python-sdk IBMクラウドと話すことを目指しています。これを行うには、構成ファイルが必要です。 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`	IBM Cloud IAMシステムを介して作成されたAPIキー	`XxX1234567890XxX`	[x]
`SL_USERNAME`	SoftLayerユーザー	`goldyfruit`	[]
`SL_API_KEY`	SoftLayer APIキー	`abc123def456ghi789klm0n`	[]

ドキュメント

IBM Cloud Python SDKのドキュメントはこちらから入手できます。

IBM Cloud Python SDKは、次のような既存のPython SDKをレバレッジします。

ソフトレイヤー
IBMクラウドオブジェクトストレージ

サポートされている機能

このSDKによってサポートされているVPC Gen 2のみがサポートされています。

サービス	特徴
シス	baremetal、オブジェクトストレージ
DNS	パブリックゾーン、プライベートゾーン
em	アカウントを取得し、エンタープライズを取得します
私は	ポリシー、役割
力	電力システム
リソース	バインディング、グループ、インスタンス、キー
VPC	ACL、FIP、ゲートウェイ、ジオ、画像、インスタンス、キー、ロードバランサー、セキュリティ、サブネット、ボリューム、VPC、VPN

インストール

pip経由でPYPIからインストールしてください：

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には、HTTP要求の速度を改善するために、キャッシュ機能（今のところのみmemcached ）があります。このmechanisimを有効にするには~/.ibmcloud/sdk.yamlファイルを使用してSDKを適切に構成してください。

---
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 memcached

Docker

sudo docker run -dt -p 11211:11211 --name memcached -d memcached

例

このSDKの使用方法に関する例のリストは、こちらで見つけることができます。

VPCSをリストします

 from ibmcloud_python_sdk . vpc import vpc as ic


vpc = ic . Vpc ()
vpc . get_vpc ( "ibmcloud-vpc-baby" )

VPCインスタンスを作成します

 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 )