Go SDK

Databases

Database instances and backups

18 methods

GET

ListDatabaseBackups()

List database backups

Parameters

limit

integer

- Maximum number of items to return

marker

string

- ID of the last item from the previous page (for pagination)

name

string

- Filter by name (exact match or prefix with *)

status

string

- Filter by status

instance_id

string

- Filter by database instance ID

datastore_type

string

- Filter by datastore type

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.ListDatabaseBackups(ctx)
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

CreateDatabaseBackup()

Create database backup

Parameters

instance_id

string

required

name

string

required

description

string

parent_id

string

- Parent backup ID for incremental backup

incremental

boolean

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.CreateDatabaseBackup(ctx, &bycloud.CreateDatabaseBackupParams{
        Instance_id: "550e8400-e29b-41d4-a716-446655440000",
    Name: "backup-2024-01-15",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

GET

GetDatabaseBackup()

Get database backup

Parameters

database_backup_id

string

required

- Database Backup ID

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.GetDatabaseBackup(ctx, &bycloud.GetDatabaseBackupParams{
        Database_backup_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

DELETE

DeleteDatabaseBackup()

Delete database backup

Parameters

database_backup_id

string

required

- Database Backup ID

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.DeleteDatabaseBackup(ctx, &bycloud.DeleteDatabaseBackupParams{
        Database_backup_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

RestoreDatabaseBackup()

Restore database backup

Parameters

database_backup_id

string

required

- Database Backup ID

name

string

required

- Name for the new restored instance

flavor_id

string

- Flavor for restored instance (uses original if omitted)

volume_size

integer

- Volume size for restored instance (uses original if omitted)

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.RestoreDatabaseBackup(ctx, &bycloud.RestoreDatabaseBackupParams{
        Database_backup_id: "550e8400-e29b-41d4-a716-446655440000",
    Name: "example-string",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

GET

ListDatabaseInstances()

List database instances

Parameters

limit

integer

- Maximum number of items to return

marker

string

- ID of the last item from the previous page (for pagination)

name

string

- Filter by name (exact match or prefix with *)

status

string

- Filter by status

datastore_type

string

- Filter by datastore type

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.ListDatabaseInstances(ctx)
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

CreateDatabaseInstance()

Create database instance

Parameters

name

string

required

flavor_id

string

required

datastore

object

required

volume

object

required

networks

array

databases

array

- Initial databases to create

users

array

- Initial users to create

configuration_id

string

replica_of

string

- Source instance ID (for read replicas)

replica_count

integer

- Number of read replicas to create

public_access

boolean

ssl_enabled

boolean

backup_schedule

object

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.CreateDatabaseInstance(ctx, &bycloud.CreateDatabaseInstanceParams{
        Name: "production-db",
    Flavor_id: "550e8400-e29b-41d4-a716-446655440000",
    Datastore: [object Object],
    Volume: [object Object],
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

GET

GetDatabaseInstance()

Get database instance

Parameters

database_instance_id

string

required

- Database Instance ID

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.GetDatabaseInstance(ctx, &bycloud.GetDatabaseInstanceParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

PATCH

UpdateDatabaseInstance()

Update database instance

Parameters

database_instance_id

string

required

- Database Instance ID

name

string

configuration_id

string

public_access

boolean

backup_schedule

object

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.UpdateDatabaseInstance(ctx, &bycloud.UpdateDatabaseInstanceParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

DELETE

DeleteDatabaseInstance()

Delete database instance

Parameters

database_instance_id

string

required

- Database Instance ID

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.DeleteDatabaseInstance(ctx, &bycloud.DeleteDatabaseInstanceParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

GET

ListDatabases()

List databases

Parameters

database_instance_id

string

required

- Database Instance ID

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.ListDatabases(ctx, &bycloud.ListDatabasesParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

CreateDatabase()

Create database

Parameters

database_instance_id

string

required

- Database Instance ID

name

string

required

character_set

string

collation

string

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.CreateDatabase(ctx, &bycloud.CreateDatabaseParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    Name: "myapp",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

DELETE

DeleteDatabase()

Delete database

Parameters

database_instance_id

string

required

- Database Instance ID

database_name

string

required

- Database name

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.DeleteDatabase(ctx, &bycloud.DeleteDatabaseParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    Database_name: "example",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

ResizeDatabaseInstance()

Resize database instance

Parameters

database_instance_id

string

required

- Database Instance ID

flavor_id

string

- New flavor ID

volume

object

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.ResizeDatabaseInstance(ctx, &bycloud.ResizeDatabaseInstanceParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

RestartDatabaseInstance()

Restart database instance

Parameters

database_instance_id

string

required

- Database Instance ID

force

boolean

- Force restart even if instance is busy

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.RestartDatabaseInstance(ctx, &bycloud.RestartDatabaseInstanceParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

GET

ListDatabaseUsers()

List database users

Parameters

database_instance_id

string

required

- Database Instance ID

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.ListDatabaseUsers(ctx, &bycloud.ListDatabaseUsersParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

POST

CreateDatabaseUser()

Create database user

Parameters

database_instance_id

string

required

- Database Instance ID

name

string

required

password

string

required

host

string

databases

array

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.CreateDatabaseUser(ctx, &bycloud.CreateDatabaseUserParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    Name: "app_user",
    Password: "example-string",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

DELETE

DeleteDatabaseUser()

Delete database user

Parameters

database_instance_id

string

required

- Database Instance ID

user_name

string

required

- Database user name

Example

package main

import (
    "context"
    "fmt"
    "github.com/bycoded/bycloud-go"
)

func main() {
    client := bycloud.New(bycloud.WithToken("YOUR_ACCESS_TOKEN"))
    ctx := context.Background()

    result, err := client.Databases.DeleteDatabaseUser(ctx, &bycloud.DeleteDatabaseUserParams{
        Database_instance_id: "550e8400-e29b-41d4-a716-446655440000",
    User_name: "example",
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}