This is the official client library for interacting with the GleSYS API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
.travis.yml
CHANGELOG.md Release 2.2.0 (#9) Dec 4, 2018
LICENSE
README.md Add Travis CI automation. Dec 15, 2017
client.go
client_test.go
doc.go
doc_test.go Add missing documentation Aug 23, 2017
ips.go
ips_test.go Add IP.IsIPv4() and IP.IsIPv6() methods (#3) Aug 4, 2017
networkadapters.go
networkadapters_test.go
networks.go
networks_test.go
servers.go Use GET requests where appropriate and minor cleanup Aug 23, 2017
servers_test.go
test.go

README.md

Build Status

glesys-go

This is the official client library for interacting with the GleSYS API.

Requirements

  • Go 1.7 or higher (relies on context)

Getting Started

Installation

go get github.com/glesys/glesys-go

Authentication

To use the glesys-go library you need a GleSYS Cloud account and a valid API key. You can sign up for an account at https://glesys.com/signup. After signing up visit https://customer.glesys.com to create an API key for your Project.

Set up a Client

client := glesys.NewClient("CL12345", "your-api-key", "my-application/0.0.1")

Create a Server

// Create a Server
server, err := client.Servers.Create(context.Background(), glesys.CreateServerParams{Password: "..."}.WithDefaults())

List all Servers

// List all Servers
servers, err := client.Servers.List(context.Background())

User agent

To be able to monitor usage and help track down issues, we encourage you to provide a user agent string identifying your application or library. Recommended syntax is my-library/version or www.example.com.

Context

glesys-go uses Go's context library to handle timeouts and deadlines. All functions making HTTP requests requires a context argument.

Documentation

Full documentation is available at https://godoc.org/github.com/glesys/glesys-go.

Contribute

We love Pull Requests ♥

  1. Fork the repo.
  2. Make sure to run the tests to verify that you're starting with a clean slate.
  3. Add a test for your change, make sure it fails. Refactoring existing code or improving documentation does not require new tests.
  4. Make the changes and ensure the test pass.
  5. Commit your changes, push to your fork and submit a Pull Request.

Syntax

Please use the formatting provided by gofmt.

License

The contents of this repository are distributed under the MIT license, see LICENSE.