Adding ServerActions, ISOs and more

Docs/SUMMARY.md

@@ -17,7 +17,8 @@
 * [🗺️ Location](functions-and-methods/location.md)
 * [🌐 Networks](functions-and-methods/networks/README.md)
   * [Networks Actions](functions-and-methods/networks/networks-actions.md)
-* [🖥️ Servers](functions-and-methods/servers.md)
+* [🖥️ Servers](functions-and-methods/servers/README.md)
+  * [Servers Actions](functions-and-methods/servers/server-actions.md)
 * [🗄️ Servers Types](functions-and-methods/servers-types.md)
 * [🔐 SSH Keys](functions-and-methods/ssh-keys.md)
 * [📦 Volumes](functions-and-methods/volumes/README.md)

Docs/functions-and-methods/servers/server-actions.md

@@ -0,0 +1,160 @@
+# Server Actions
+
+With Server Actions, you can perform various actions on your servers, such as starting, stopping, rebooting, attaching networks, and much more. The methods are provided via the `ServerActionClient` class.
+
+---
+
+## Initialization
+
+```csharp
+using HetznerCloudApi.Client;
+
+HetznerCloudClient hetznerCloudClient = new HetznerCloudClient("apiKey");
+```
+
+---
+
+## Start server
+
+```csharp
+long serverId = 123456;	
+var action = await hetznerCloudClient.ServerActions.PowerOn(serverId);
+```
+
+## Stop server (Power Off)
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.PowerOff(serverId);
+```
+
+## Soft reboot server		
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.SoftReboot(serverId);
+```
+
+## Hard reboot server (Reset)
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.Reset(serverId);
+```
+
+## Shutdown server
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.Shutdown(serverId);
+```
+
+## Change server type
+
+```csharp
+long serverId = 123456;
+bool upgradeDisk = true;
+string serverType = "cx21";
+var action = await hetznerCloudClient.ServerActions.ChangeType(serverId, upgradeDisk, serverType);
+```
+
+## Attach server to network
+
+```csharp
+long serverId = 123456;
+long networkId = 654321;
+var action = await hetznerCloudClient.ServerActions.AttachToNetwork(serverId, networkId);
+```
+
+## Detach server from network
+
+```csharp
+long serverId = 123456;
+long networkId = 654321;
+var action = await hetznerCloudClient.ServerActions.DetachFromNetwork(serverId, networkId);
+```
+
+## Enable backup
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.EnableBackup(serverId);
+```
+
+## Disable backup
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.DisableBackup(serverId);
+```
+
+## Enable rescue mode
+
+```csharp
+long serverId = 123456;
+string type = "linux64";
+var action = await hetznerCloudClient.ServerActions.EnableRescueMode(serverId, type);
+```
+
+## Disable rescue mode
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.DisableRescueMode(serverId);
+```
+
+## Reset root password
+
+```csharp
+long serverId = 123456;
+var response = await hetznerCloudClient.ServerActions.ResetRootPassword(serverId);
+string newPassword = response.RootPassword;
+```
+
+## Request console (VNC)
+
+```csharp
+long serverId = 123456;
+var response = await hetznerCloudClient.ServerActions.RequestConsole(serverId);
+string wssUrl = response.Wss_Url;
+string password = response.Password;
+```
+
+## Attach ISO
+
+```csharp
+long serverId = 123456;
+string isoName = "ubuntu-22.04";
+var action = await hetznerCloudClient.ServerActions.AttachISO(serverId, isoName);
+```
+
+## Detach ISO
+
+```csharp
+long serverId = 123456;
+var action = await hetznerCloudClient.ServerActions.DetachISO(serverId);
+```
+
+## Create snapshot/image
+
+```csharp
+long serverId = 123456;
+string description = "Backup before update";
+string type = "snapshot";
+var labels = new Dictionary<string, string> { { "env", "prod" } };
+var action = await hetznerCloudClient.ServerActions.CreateImage(serverId, description, type, labels);
+```
+
+## Rebuild server from image
+
+```csharp
+long serverId = 123456;
+string image = "ubuntu-22.04";
+var response = await hetznerCloudClient.ServerActions.RebuildFromImage(serverId, image);
+string newRootPassword = response.RootPassword;
+```
+
+---
+
+You can find more methods and details in the API documentation and in the source code of the `ServerActionClient` class.
+

Docs/functions-and-methods/ssh-keys.md

@@ -57,9 +57,9 @@ sshKey.Name = $"new-name-{Guid.NewGuid()}";
 sshKey = await hetznerCloudClient.SshKey.Update(sshKey);
 ```
 
-## Delete a Volume
+## Delete an SSH Key
 
-Deletes a volume. All Volume data is irreversibly destroyed. The Volume must not be attached to a Server and it must not have delete protection enabled.
+Deletes a ssh key. 
 
 ```csharp
 HetznerCloudClient hetznerCloudClient = new HetznerCloudClient("ApiKey");

HetznerCloudApi/Client/FirewallActionClient.cs

@@ -1,10 +1,12 @@
-using Newtonsoft.Json.Linq;
+using HetznerCloudApi.Object.Action;
+using HetznerCloudApi.Object.Action.Get;
+using HetznerCloudApi.Object.Firewall;
+using HetznerCloudApi.Object.Server;
 using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
 using System.Collections.Generic;
+using System.Linq;
 using System.Threading.Tasks;
-using HetznerCloudApi.Object.Action;
-using HetznerCloudApi.Object.Action.Get;
-using HetznerCloudApi.Object.Firewall;
 
 namespace HetznerCloudApi.Client
 {
@@ -18,22 +20,88 @@ public FirewallActionClient(string token)
         }
 
         /// <summary>
-        /// Apply to Resources
+        /// Apply to a single server by id
         /// </summary>
         /// <param name="firewallId"></param>
         /// <param name="serverId"></param>
         /// <returns></returns>
         public async Task<List<Action>> ApplyToResources(long firewallId, long serverId)
         {
-            // Preparing raw
-            string raw = $"{{ \"apply_to\": [ {{ \"server\": {{ \"id\": {serverId} }}, \"type\": \"server\" }} ] }}";
+            return await ApplyToResources(firewallId, new List<AppliedTo>() { AppliedTo.FromServerId(serverId) });
+        }
 
-            // Send update
-            string jsonResponse = await Core.SendPostRequest(_token, $"/firewalls/{firewallId}/actions/apply_to_resources", raw);
+        /// <summary>
+        /// Apply to a single server by id
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> ApplyToServer(Firewall firewall, long serverId)
+        {
+            return await ApplyToResources(firewall.Id, serverId);
+        }
 
-            // Return
-             JObject result = JObject.Parse(jsonResponse);
-            return JsonConvert.DeserializeObject<List<Action>>($"{result["actions"]}") ?? new List<Action>();
+        /// <summary>
+        /// Apply to a single server
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> ApplyToServer(Firewall firewall, Object.Server.Server server)
+        {
+            return await ApplyToResources(firewall.Id, server.Id);
+        }
+
+
+        /// <summary>
+        /// Apply to multiple servers   
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> ApplyToServers(Firewall firewall, IEnumerable<Object.Server.Server> servers)
+        {
+            return await ApplyToResources(firewall.Id, servers.Select(a => AppliedTo.FromServer(a)));
+        }
+
+        /// <summary>
+        /// Apply to multiple servers by id
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> ApplyToServers(Firewall firewall, IEnumerable<long> serverIds)
+        {
+            return await ApplyToResources(firewall.Id, serverIds.Select(a => AppliedTo.FromServerId(a)));
+        }
+
+        /// <summary>
+        /// Apply to Resources
+        /// </summary>
+        /// <param name="firewallId"></param>
+        /// <param name="appliedTo"
+        /// <returns></returns>
+        public async Task<List<Action>> ApplyToResources(Firewall firewall, IEnumerable<AppliedTo> appliedTo)
+        {
+            return await ApplyToResources(firewall.Id, appliedTo);
+        }
+
+
+        /// <summary>
+        /// Apply to Resources
+        /// </summary>
+        /// <param name="firewallId"></param>
+        /// <param name="appliedTo"
+        /// <returns></returns>
+        public async Task<List<Action>> ApplyToResources(long firewallId, IEnumerable<AppliedTo> appliedTo)
+        {
+            // Preparing raw
+            var temp = new
+            {
+                apply_to = appliedTo
+            };
+
+            return await Core.SendPostRequest<ResponseBucket<string>>(_token, $"/firewalls/{firewallId}/actions/apply_to_resources", temp);
         }
 
         /// <summary>
@@ -43,16 +111,59 @@ public async Task<List<Action>> ApplyToResources(long firewallId, long serverId)
         /// <param name="serverId"></param>
         /// <returns></returns>
         public async Task<List<Action>> RemoveFromResources(long firewallId, long serverId)
+        {
+            return await RemoveFromResources(firewallId, new List<AppliedTo>() { AppliedTo.FromServerId(serverId) });
+        }
+
+        /// <summary>
+        /// Removes one Firewall from multiple resources.
+        /// </summary>
+        /// <param name="firewallId"></param>
+        /// <param name="serverId"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> RemoveFromResources(long firewallId, IEnumerable<AppliedTo> removeFrom)
         {
             // Preparing raw
-            string raw = $"{{ \"remove_from\": [ {{ \"server\": {{ \"id\": {serverId} }}, \"type\": \"server\" }} ] }}";
+            var temp = new
+            {
+                remove_from = removeFrom
+            };
 
-            // Send update
-            string jsonResponse = await Core.SendPostRequest(_token, $"/firewalls/{firewallId}/actions/remove_from_resources", raw);
+            return await Core.SendPostRequest<ResponseBucket<string>>(_token, $"/firewalls/{firewallId}/actions/remove_from_resources", temp);
 
-            // Return
-            JObject result = JObject.Parse(jsonResponse);
-            return JsonConvert.DeserializeObject<List<Action>>($"{result["actions"]}") ?? new List<Action>();
+        }
+
+        /// <summary>
+        /// Removes one Firewall from multiple resources.
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> RemoveFromResources(Firewall firewall, Object.Server.Server server)
+        {
+            return await RemoveFromResources(firewall.Id, new List<AppliedTo>() { AppliedTo.FromServerId(server.Id) });
+        }
+
+        /// <summary>
+        /// Remove from multiple servers   
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> RemoveFromResources(Firewall firewall, IEnumerable<Object.Server.Server> servers)
+        {
+            return await RemoveFromResources(firewall.Id, servers.Select(a => AppliedTo.FromServer(a)));
+        }
+
+        /// <summary>
+        /// Remove from multiple servers by id
+        /// </summary>
+        /// <param name="firewall"></param>
+        /// <param name="server"></param>
+        /// <returns></returns>
+        public async Task<List<Action>> RemoveFromResources(Firewall firewall, IEnumerable<long> serverIds)
+        {
+            return await RemoveFromResources(firewall.Id, serverIds.Select(a => AppliedTo.FromServerId(a)));
         }
 
         /// <summary>