DEPRECATED use https://github.com/datastax/astra-client-go instead

astra-devops-sdk-go

Go API bindings for the Astra DevOps API with zero external dependencies. Apache 2.0 License.

How to use

Login Token

import "github.com/rsds143/astra-devops-sdk-go/astraops"

func main() {
//using an auth token

  verbose := true
  client, err := astraopsv1.AuthenticateToken("AstraCS:scrambled:scrabmled", verbose)
}

Login Legacy Service Account

import "github.com/rsds143/astra-devops-sdk-go/astraops"

func main() {
//using a legacy service account
 c :=  ClientInfo {
	        ClientName: "me@example.com",
	        ClientID:   "3e241be3-2a5f-4cb1-b702-739e38975b1a",
	        ClientSecret: "33c338b0-91b5-45a6-be14-416059deb820",
  }
  verbose := true
  client, err := astraopsv1.Authenticate(c, verbose)
}

Create Database

Will block until creation

createDb := CreateDb{
		Name:          "testerdblist",
		Keyspace:      "mykeyspace",
		Region:        "europe-west1",
		CloudProvider: "GCP",
		CapacityUnits: 1,
		Tier:          "serverless",
		User:          "myuser",
		Password:      "mypass",
	}
//id is a uuid
//db is the following type
//type DataBase struct {
//	ID               string   `json:"id"`
//	OrgID            string   `json:"orgId"`
//	OwnerID          string   `json:"ownerId"`
//	Info             Info     `json:"info"`
//	CreationTime     string   `json:"creationTime"`
//	TerminationTime  string   `json:"terminationTime"`
//	Status           string   `json:"status"`
//	Storage          Storage  `json:"storage"`
//	AvailableActions []string `json:"availableActions"`
//	Message          string   `json:"message"`
//	StudioURL        string   `json:"studioUrl"`
//	GrafanaURL       string   `json:"grafanaUrl"`
//	CqlshURL         string   `json:"cqlshUrl"`
//	GraphqlURL       string   `json:"graphUrl"`
//	DataEndpointURL  string   `json:"dataEndpointUrl"`
//}
id, db, err := client.CreateDb(createDb)

Delete Database

Will block until terminating status or terminated status is returned

//id is database ID one gets when using ListDb or CreateDb
//preparedStateOnly is an internal field, do not use unless directed to by support
preparedStateOnly := false
err := client.Terminate(id, preparedStateOnly)

List All Databases With A Limit Of 10

dbs, err := client.ListDb("", "", "", 10)
//returns an array of DataBases

Get Database by ID

db, err := client.FindDb(id)

//type DataBase struct {
//	ID               string   `json:"id"`
//	OrgID            string   `json:"orgId"`
//	OwnerID          string   `json:"ownerId"`
//	Info             Info     `json:"info"`
//	CreationTime     string   `json:"creationTime"`
//	TerminationTime  string   `json:"terminationTime"`
//	Status           string   `json:"status"`
//	Storage          Storage  `json:"storage"`
//	AvailableActions []string `json:"availableActions"`
//	Message          string   `json:"message"`
//	StudioURL        string   `json:"studioUrl"`
//	GrafanaURL       string   `json:"grafanaUrl"`
//	CqlshURL         string   `json:"cqlshUrl"`
//	GraphqlURL       string   `json:"graphUrl"`
//	DataEndpointURL  string   `json:"dataEndpointUrl"`
}
*/

Get Secure Connect Bundle by ID

secureBundle, err := client.GetSecureBundle(id)

/*
type SecureBundle struct {
	DownloadURL               string `json:"downloadURL"`
	DownloadURLInternal       string `json:"downloadURLInternal"`
	DownloadURLMigrationProxy string `json:"downloadURLMigrationProxy"`
}
*/

Park legacy tier db (non serverless)

Will block until parking complete

err := client.Park(id)

Unpark legacy tier db (non serverless)

Will block until unparking complete, this can take very long

err := client.UnPark(id)

Resize

var int32 capacityUnits = 5
err := Resize(id, capacityUnits)

List all tiers available

tiers, err := GetTierInfo()
//returns a list of TierInfo
//type TierInfo struct {
//	Tier                            string   `json:"tier"`
//	Description                     string   `json:"description"`
//	CloudProvider                   string   `json:"cloudProvider"`
//	Region                          string   `json:"region"`
//	RegionDisplay                   string   `json:"regionDisplay"`
//	RegionContinent                 string   `json:"regionContinent"`
//	Cost                            TierCost `json:"cost"`
//	DatabaseCountUsed               int      `json:"databaseCountUsed"`
//	DatabaseCountLimit              int      `json:"databaseCountLimit"`
//	CapacityUnitsUsed               int      `json:"capacityUnitsUsed"`
//	CapacityUnitsLimit              int      `json:"capacityUnitsLimit"`
//	DefaultStoragePerCapacityUnitGb int      `json:"defaultStoragePerCapacityUnitGb"`
//}
//
//tier cost has the following fields 
//type TierCost struct {
//	CostPerMinCents         float64 `json:"costPerMinCents"`
//	CostPerHourCents        float64 `json:"costPerHourCents"`
//	CostPerDayCents         float64 `json:"costPerDayCents"`
//	CostPerMonthCents       float64 `json:"costPerMonthCents"`
//	CostPerMinMRCents       float64 `json:"costPerMinMRCents"`
//	CostPerHourMRCents      float64 `json:"costPerHourMRCents"`
//	CostPerDayMRCents       float64 `json:"costPerDayMRCents"`
//	CostPerMonthMRCents     float64 `json:"costPerMonthMRCents"`
//	CostPerMinParkedCents   float64 `json:"costPerMinParkedCents"`
//	CostPerHourParkedCents  float64 `json:"costPerHourParkedCents"`
//	CostPerDayParkedCents   float64 `json:"costPerDayParkedCents"`
//	CostPerMonthParkedCents float64 `json:"costPerMonthParkedCents"`
//	CostPerNetworkGbCents   float64 `json:"costPerNetworkGbCents"`
//	CostPerWrittenGbCents   float64 `json:"costPerWrittenGbCents"`
//	CostPerReadGbCents      float64 `json:"costPerReadGbCents"`
//}