Use the Go SDK

clumio-go-sdk is a typed Go client for the Clumio REST API. It ships controllers for each resource group and a models package holding the request and response types. Requires Go 1.20 or later.

Install

go get github.com/clumio-code/clumio-go-sdk

Authenticate

import (
    "fmt"
    "log"

    "github.com/clumio-code/clumio-go-sdk/config"
    "github.com/clumio-code/clumio-go-sdk/controllers"
)

cfg := config.Config{
    Token:   "<your_api_token>",
    BaseUrl: "<base_url>",
}

client := controllers.NewPolicyDefinitionsV1(cfg)

BaseUrl must match the control plane that issued the token. See Authentication.

Use it

resp, err := client.ListPolicyDefinitions(nil, nil)
if err != nil {
    log.Fatalf("list policies: %v", err)
}

fmt.Println(resp)

Package layout

Package	Contains
`config`	Token, base URL and HTTP client configuration
`controllers`	One controller per resource group; the entry points you call
`models`	Request and response types shared across controllers

Response envelopes

List responses follow the HAL convention the API uses, so items sit under an embedded collection alongside the pagination links. Read the links rather than constructing page offsets yourself.

Errors

Controllers return a standard Go error alongside the response. Check it before dereferencing the response.

REST API reference

The endpoint-level reference behind every controller method.

Source and issues

Read the code, report a bug, or open a pull request.

Overview

SDKs

Infrastructure as code

Automation examples

Use the Go SDK

Install

Authenticate

Use it

Next

REST API reference

Source and issues

​Install

​Authenticate

​Use it

​Next

REST API reference

Source and issues

Install

Authenticate

Use it

Next