https://github.com/komminarlabs/influxdb3
InfluxDB V3 Go Client Library
https://github.com/komminarlabs/influxdb3
client-library database golang iiot influxdb3 iot management-api sdk-go timeseries timeseries-database v3
Last synced: 3 months ago
JSON representation
InfluxDB V3 Go Client Library
- Host: GitHub
- URL: https://github.com/komminarlabs/influxdb3
- Owner: komminarlabs
- License: apache-2.0
- Created: 2024-05-07T08:03:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-30T10:58:38.000Z (8 months ago)
- Last Synced: 2025-01-15T19:23:13.455Z (5 months ago)
- Topics: client-library, database, golang, iiot, influxdb3, iot, management-api, sdk-go, timeseries, timeseries-database, v3
- Language: Go
- Homepage: https://pkg.go.dev/github.com/komminarlabs/influxdb3
- Size: 41 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# InfluxDB v3 Cloud Dedicated Management API Go Client Library
The InfluxDB v3 Management API Go client library lets you manage an InfluxDB Cloud Dedicated instance and integrate functions such as creating and managing databases, permissions, and tokens into your workflow or application.
## Generated types and API client
This library is generated using [oapi-codegen](https://github.com/oapi-codegen/oapi-codegen) from this [OpenAPI spec](https://github.com/influxdata/docs-v2/blob/master/api-docs/cloud-dedicated/management/openapi.yml)
### Generate
```go
go generate ./...
```
## Usage
### Environment variables
```bash
export INFLUXDB_BASE_URL="https://console.influxdata.com/api/v0"
export INFLUXDB_ACCOUNT_ID="4ade9b2e-0a52-4a46-b3b8-1b43ea493a98"
export INFLUXDB_CLUSTER_ID="a379c48a-791e-47fe-ba64-628ba19507e8"
export INFLUXDB_TOKEN="1e0f14063eb14a9e94fe765bf999a90cb7962f8e0f394110b91053ea26cdce5071d6bca29e4d4684bed463cf2ea9f381"
```
### Sample code to list database tokens
```go
package main
import (
"context"
"io"
"net/http"
"github.com/caarlos0/env/v11"
"github.com/komminarlabs/influxdb3"
)
type InfluxdbConfig struct {
AccountId influxdb3.UuidV4 `env:"INFLUXDB_ACCOUNT_ID"`
BaseURL string `env:"INFLUXDB_BASE_URL"`
ClusterId influxdb3.UuidV4 `env:"INFLUXDB_CLUSTER_ID"`
Token string `env:"INFLUXDB_TOKEN"`
}
func main() {
cfg := InfluxdbConfig{}
opts := env.Options{RequiredIfNoDef: true}
err := env.ParseWithOptions(&cfg, opts)
if err != nil {
panic(err)
}
ctx := context.Background()
client, err := influxdb3.NewClient(cfg.BaseURL, influxdb3.WithRequestEditorFn(func(ctx context.Context, req *http.Request) error {
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer "+cfg.Token)
return nil
}))
if err != nil {
panic(err)
}
resp, err := client.GetDatabaseTokens(ctx, cfg.AccountId, cfg.ClusterId)
if err != nil {
panic(err)
}
defer resp.Body.Close()
if resp.StatusCode == http.StatusOK {
bodyBytes, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
bodyString := string(bodyBytes)
println(bodyString)
}
}
```