IBM Cloud SDK for Power Private Cloud aaS
The ppc-aas-go-client project provides the Go SDK for IBM® Stratos for Power (Power Private Cloud aaS).
Prerequisites
Install
Install the SDK using the following methods.
go get
command
Use this command to download and install the SDK to allow your Go application to use it:
go get -u github.com/IBM-Cloud/ppc-aas-go-client
Go modules
If your application is using Go modules, you can add a suitable import to your Go application, like this:
import (
"github.com/IBM-Cloud/ppc-aas-go-client"
)
then run go mod tidy
to download and install the new dependency and update your Go application's
go.mod
file.
dep
dependency manager
If your application is using the dep
dependency management tool, you can add a dependency
to your Gopkg.toml
file. Here is an example:
[[constraint]]
name = "github.com/IBM-Cloud/ppc-aas-go-client"
version = "1.1.0"
then run dep ensure
.
Usage
First you need to create a session and use it for creating the client.
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)
.....
}
Type IBMPIOptions
required fields:
Other optional fields:
Debug
: Enable/Disable http transport debugging log.
Region
: Region of the Power Cloud Service Instance. This is used for generating the default service URL. Deprecated: The region and endpoint is auto generated based on Zone
.
URL
: Power Virtual Server host or URL endpoint. By default it uses ppc-aas.cloud.ibm.com
. In case of test environment you can set the value to ppc-aas.test.cloud.ibm.com
. You can also use env variable IBMCLOUD_POWER_API_ENDPOINT
. Note that the region value is prepended to the host string if not present eg: <region>.ppc-aas.cloud.ibm.com
.
Also you can refer to the examples directory for some resources that shows how to use the SDK.
Issues
If you encounter an issue with the project please report here..
Development
This section contains some steps required by the dev for contributing changes to the SDK.
Update the power directory
- Install the latest go-swagger version on your machine.
- Download the last released version of the service broker API definitions (
swagger.yaml
).
- Run
./bin/update-swagger.sh
from the project root.