LightYear provides official SDK libraries for popular programming languages, making it easier to integrate cloud management into your applications.
Python SDK
Installation
>_BASH
$pip install lightyear-pythonBasic Usage
PYTHON
import lightyear
client = lightyear.Client(api_key="YOUR_API_KEY")
# List servers
servers = client.servers.list()
for server in servers:
print(f"{server.label}: {server.main_ip} ({server.status})")
# Create a server
new_server = client.servers.create(
region="sgp-01",
plan="vc2-2c-4gb",
os_id=1743,
label="python-server-01",
ssh_key_ids=["key_abc123"]
)
print(f"Created: {new_server.id}")
# Delete a server
client.servers.delete(server_id="srv_abc123")Node.js SDK
Installation
>_BASH
$npm install @lightyear/sdkBasic Usage
JS
import { LightYearClient } from '@lightyear/sdk';
const client = new LightYearClient({ apiKey: process.env.LIGHTYEAR_API_KEY });
// List servers
const { servers } = await client.servers.list();
console.log(servers.map(s => s.label));
// Create a server
const { server } = await client.servers.create({
region: 'sgp-01',
plan: 'vc2-2c-4gb',
osId: 1743,
label: 'node-server-01',
sshKeyIds: ['key_abc123'],
});
console.log(`Created: ${server.id} at ${server.mainIp}`);Go SDK
Installation
>_BASH
$go get github.com/lightyear/lightyear-goBasic Usage
GO
package main
import (
"context"
"fmt"
"github.com/lightyear/lightyear-go"
)
func main() {
client := lightyear.NewClient("YOUR_API_KEY")
ctx := context.Background()
servers, _, err := client.Server.List(ctx, nil)
if err != nil {
panic(err)
}
for _, s := range servers {
fmt.Printf("%s: %s (%s)\n", s.Label, s.MainIP, s.Status)
}
}PHP SDK
Installation
>_BASH
$composer require lightyear/lightyear-phpBasic Usage
PHP
<?php
require 'vendor/autoload.php';
use LightYear\Client;
$client = new Client('YOUR_API_KEY');
$servers = $client->servers()->list();
foreach ($servers as $server) {
echo "{$server->label}: {$server->mainIp}\n";
}[!NOTE] All SDKs are open source and available on GitHub. Contributions and bug reports are welcome.
