ppc aas go client

Power Private Cloud aaS 用の IBM Cloud SDK

ppc-aas-go-client プロジェクトは、IBM® Stratos for Power (Power Private Cloud aaS) 用の Go SDK を提供します。

前提条件

• IBMクラウドアカウント
• IBM Cloud IAM API キーまたはトークンにより、SDK がアカウントにアクセスできるようになります。
• ゴー 1.17+
  • 自作
  • ソース

インストール

以下の方法でSDKをインストールしてください。

コマンドをgo get

次のコマンドを使用して SDK をダウンロードしてインストールし、Go アプリケーションで使用できるようにします。

 go get -u github.com/IBM-Cloud/ppc-aas-go-client

Goモジュール

アプリケーションが Go モジュールを使用している場合は、次のように Go アプリケーションに適切なインポートを追加できます。

 import (
  "github.com/IBM-Cloud/ppc-aas-go-client"
)

次に、 go mod tidyを実行して、新しい依存関係をダウンロードしてインストールし、Go アプリケーションのgo.modファイルを更新します。

dep依存関係マネージャー

アプリケーションがdep依存関係管理ツールを使用している場合は、 Gopkg.tomlファイルに依存関係を追加できます。以下に例を示します。

 [[constraint]]
  name = "github.com/IBM-Cloud/ppc-aas-go-client"
  version = "1.1.0"

次に、 dep ensure実行します。

使用法

まずセッションを作成し、それをクライアントの作成に使用する必要があります。

 import "github.com/IBM-Cloud/ppc-aas-go-client/ibmpisession"

func main (){
    o := & ibmpisession. IBMPIOptions {
		Authenticator : authenticator ,
		UserAccount :   accountID ,
		Zone :          zone ,
	}
    s , err := ibmpisession . NewIBMPISession ( o )
    ... ..
}

IBMPIOptions必須フィールドに次のように入力します。

• Authenticator : API 呼び出しの認証に使用できるさまざまなオプションについては、https://github.com/IBM/go-sdk-core/blob/main/Authentication.md を確認してください。
• UserAccount : Power Cloud サービス インスタンスのアカウント ID。
• Zone : Power Cloud サービス インスタンスの場所。

その他のオプションのフィールド:

• Debug : http トランスポートのデバッグ ログを有効/無効にします。
• Region : Power Cloud サービス インスタンスのリージョン。これは、デフォルトのサービス URL を生成するために使用されます。非推奨: リージョンとエンドポイントはZoneに基づいて自動生成されます。
• URL : Power Virtual Server ホストまたは URL エンドポイント。デフォルトではppc-aas.cloud.ibm.comを使用します。テスト環境の場合は、値をppc-aas.test.cloud.ibm.comに設定できます。環境変数IBMCLOUD_POWER_API_ENDPOINTを使用することもできます。ホスト文字列が存在しない場合は、リージョン値がホスト文字列の前に追加されることに注意してください (例: <region>.ppc-aas.cloud.ibm.com )。

また、SDK の使用方法を示すいくつかのリソースのサンプル ディレクトリを参照することもできます。

問題

プロジェクトで問題が発生した場合は、ここから報告してください。

発達

このセクションには、開発者が SDK に変更を加えるために必要ないくつかの手順が含まれています。

パワーディレクトリを更新する

1. 最新の go-swagger バージョンをマシンにインストールします。
2. サービス ブローカー API 定義の最新リリース バージョン ( swagger.yaml ) をダウンロードします。
3. プロジェクト ルートから./bin/update-swagger.shを実行します。