Get the 1&1 .NET Cloud Server SDK

Table of Contents

Introduction

The 1&1 .NET SDK is a .NET library designed for interaction with the 1&1 Cloud platform over the Cloud Server REST API. This allows you to automate many of the tasks which are otherwise available through the Cloud Panel UI.

Features

The 1&1 .NET SDK allows you to list and retrieve information about servers, including their hardware, IP addresses, load balancers, private networks, and more. You can create and delete servers, as well as reconfigure them. Hard drives, virtual DVD units, firewall policies, load balancers, and IP addresses can all be added or removed through the API.

The API also allows you to manage server operations. Servers can be added to or removed from private networks. Snapshots can be created, restored, or removed. Images can be created, updated, and deleted. Shared storages, firewall policies, load balancers, IP addresses, private networks, VPNs, monitoring policies, logs, usage, and appliances can all be managed through the API. Users and roles can be added, deleted, and managed, as well.

Supported Versions

The 1&1 .NET SDK is designed for .NET version 4.6 and above.

Requirements

Before you begin you will need to have signed up for a 1&1 account. The credentials you create during sign-up will be used to authenticate against the API.

Before you begin, you need to have a 1&1 account.

To activate the API token (key) for a user:

  1. Log in to your 1&1 Control Panel and select the relevant package.
  2. Click 1&1 Cloud Panel from the Cloud Server section of the control panel.
  3. Select Users from the Management section of the Infrastructure menu.
  4. Select the user who needs the API token.
  5. In the API section in the lower part of the screen, click Disabled next to the API KEY.
  6. Click OK to activate the API key.

Installation

The official .NET library is available from the 1&1 GitHub account found here. To install the latest stable version, clone the repository, then add the binaries to your project.

Configuration

Depending on the type of project, you have the option to either create an App.config or Web.config file to interact with the service before you begin, or to pass the required values when initializing the client through your code. This file should contain the following values:

    <appSettings>
    <add key="APIToken" value="api token goes here"/>
    <add key="APIURL" value="https://xxxxxx.1and1.com/v1"/>
  </appSettings>

Using the Driver

Here is a simple example on how to use the library.

List all Servers:

var servers=OneAndOneClient.Instance().Servers.Get();

This will list all servers under your 1&1 account.

Additional Documentation and Support

You can engage with us in the community and we'll be more than happy to answer any questions you might have.

Comments

Tags: Management