ppc aas go client

SDK de IBM Cloud para Power Private Cloud aaS

El proyecto ppc-aas-go-client proporciona Go SDK para IBM® Stratos for Power (Power Private Cloud aaS).

Requisitos previos

• Una cuenta de nube de IBM
• Una clave o token API de IBM Cloud IAM permite que el SDK acceda a su cuenta
• Ir 1.17+
  • cerveza casera
  • Fuente

Instalar

Instale el SDK utilizando los siguientes métodos.

go get el comando

Utilice este comando para descargar e instalar el SDK y permitir que su aplicación Go lo utilice:

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

Ir a módulos

Si su aplicación utiliza módulos Go, puede agregar una importación adecuada a su aplicación Go, como esta:

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

luego ejecute go mod tidy para descargar e instalar la nueva dependencia y actualizar el archivo go.mod de su aplicación Go.

gerente de dependencia dep

Si su aplicación utiliza la herramienta de administración de dependencias dep , puede agregar una dependencia a su archivo Gopkg.toml . Aquí hay un ejemplo:

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

luego ejecute dep ensure .

Uso

Primero necesitas crear una sesión y usarla para crear el cliente.

 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 )
    ... ..
}

Escriba los campos obligatorios IBMPIOptions :

• Authenticator : consulte https://github.com/IBM/go-sdk-core/blob/main/Authentication.md para conocer las diferentes opciones disponibles para autenticar llamadas API.
• UserAccount : ID de cuenta de la instancia del servicio Power Cloud.
• Zone : Ubicación de la instancia del servicio Power Cloud.

Otros campos opcionales:

• Debug : habilitar/deshabilitar el registro de depuración del transporte http.
• Region : Región de la instancia del servicio Power Cloud. Esto se utiliza para generar la URL del servicio predeterminado. En desuso : la región y el punto final se generan automáticamente según Zone .
• URL : host de Power Virtual Server o punto final de URL. De forma predeterminada utiliza ppc-aas.cloud.ibm.com . En el caso de un entorno de prueba, puede establecer el valor en ppc-aas.test.cloud.ibm.com . También puede utilizar la variable de entorno IBMCLOUD_POWER_API_ENDPOINT . Tenga en cuenta que el valor de la región se antepone a la cadena del host si no está presente, por ejemplo: <region>.ppc-aas.cloud.ibm.com .

También puede consultar el directorio de ejemplos para obtener algunos recursos que muestran cómo utilizar el SDK.

Asuntos

Si encuentra algún problema con el proyecto, infórmelo aquí.

Desarrollo

Esta sección contiene algunos pasos requeridos por el desarrollador para contribuir con cambios al SDK.

Actualizar el directorio de energía

1. Instale la última versión de Go-Swagger en su máquina.
2. Descargue la última versión publicada de las definiciones de API del intermediario de servicios ( swagger.yaml ).
3. Ejecute ./bin/update-swagger.sh desde la raíz del proyecto.