ljchuello/linode.api

This C# / .NET Core SDK simplifies using Linode Cloud API, managing servers, firewalls, SSH keys, and volumes. Ideal for web developers and .NET apps, it boosts cloud management for Linode Cloud resources.

Welcome to Linode.API

An awesome README template to jumpstart your projects!
Explore the docs »

View Demo · Report Bug · Request Feature

About The Project

This project is essentially your comprehensive guide to explore and use Linode APIs. Here, I compile everything you need to integrate your projects into one of the top cloud platforms, covering instances, firewalls, images, regions, SSH keys, StackScripts, and much more! 🌐🔒🚀

Key Features

• Quick Start: Get going with simple examples to connect and utilize the API. 🖥️
• Detailed API Reference: Each endpoint is explained with code examples, making it easy even for beginners. 📚
• Use Cases: Explore how other developers are leveraging the API in real-world scenarios. 💡
• Security and Best Practices: Learn how to use the API securely and efficiently. 🔐
• Support and Community: Join our community and get assistance when you need it. 👥

Built With

Installation

Before you can use Linode.API in your application, you must add the NuGet package. You can do this using your IDE or the command line:

PM> dotnet add package Linode.API

Usage

Ex; Create a server

LinodeClient linodeClient = new LinodeClient("apikey");

string label = "mySuperServerLinode";
string regionId = "eu-central";
string linodeTypeId = "g6-nanode-1";
string imageId = "linode/debian11";
string rootPassword = "krGNsg7oPxWTYS^q*KWL8HkHC2nJRUDjE*wT";

// Create
LinodeInstance linodeInstance = await linodeClient.LinodeInstance.Create(
    label,
    regionId,
    linodeTypeId,
    imageId,
    rootPassword
);

Ex; Get all server

LinodeClient linodeClient = new LinodeClient("apikey");

// Get all
List<LinodeInstance> list = await linodeClient.LinodeInstance.Get();

Ex; Get a server

LinodeClient linodeClient = new LinodeClient("apikey");

long instanceId = 52767381;

// Get One
LinodeInstance linodeInstance = await linodeClient.LinodeInstance.Get(instanceId);

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Leonardo Chuello - @LJChuello - [email protected]

Project Link: github.com/ljchuello/Linode.API

Project Documentation: linode.ljchuello.com/

Nuget Package nuget.org/packages/Linode.API

Implemented functionality

✔️ - Available on API, implemented
❌ - Available on API, not implemented
➖ - Not available on API

	Get all	Get one	Create	Update	Delete	Actions
Domains (Zone DNS)	✔️	✔️	✔️	✔️	✔️	➖
Domains (Record DNS)	✔️	✔️	✔️	✔️	✔️	➖
Firewalls	✔️	✔️	✔️	✔️	✔️	✔️
Images	✔️	✔️	❌	❌	❌	➖
Linode Instance	✔️	✔️	✔️	✔️	✔️	➖
Linode Type	✔️	✔️	➖	➖	➖	➖
Regions	✔️	✔️	➖	➖	➖	➖
SSH Keys	✔️	✔️	✔️	✔️	✔️	➖
StackScript	✔️	✔️	✔️	✔️	✔️	➖
VLANs	➖	➖	➖	➖	➖	➖
Volumes	✔️	✔️	✔️	✔️	✔️	✔️

To have the complete list of the functionalities implemented in this library consult the Wiki

linode.api's Issues

Update Server

StackScripts | Delete

StackScripts | Update

Server Delete

Prepare documentation and readme.md

Unit tests | SSH Key

StackScripts | Create

StackScripts | Get All

Move documentation to GitBook

For more practicality, the documentation will be moved to GitBook

Change http requests and add error handling

StackScripts | Get One

Unit tests | StackScript

Add Unit Tests to Stack Script Client