{"id":23505464,"url":"https://github.com/xafero/upcloud-c-sharp-api","last_synced_at":"2025-10-09T15:51:17.822Z","repository":{"id":75083161,"uuid":"183065299","full_name":"xafero/upcloud-c-sharp-api","owner":"xafero","description":"C# client for UpCloud's API","archived":false,"fork":false,"pushed_at":"2019-04-27T23:23:20.000Z","size":1894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-08T23:47:55.687Z","etag":null,"topics":["upcloud"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xafero.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-23T17:37:04.000Z","updated_at":"2020-01-08T12:39:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"e85d4b4e-a205-46c6-b5e5-b139a900b8ba","html_url":"https://github.com/xafero/upcloud-c-sharp-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/xafero/upcloud-c-sharp-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xafero%2Fupcloud-c-sharp-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xafero%2Fupcloud-c-sharp-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xafero%2Fupcloud-c-sharp-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xafero%2Fupcloud-c-sharp-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xafero","download_url":"https://codeload.github.com/xafero/upcloud-c-sharp-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xafero%2Fupcloud-c-sharp-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001649,"owners_count":26083147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["upcloud"],"created_at":"2024-12-25T09:35:23.691Z","updated_at":"2025-10-09T15:51:17.771Z","avatar_url":"https://github.com/xafero.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UpCloud C# API client library\n\n[![Build Status](https://travis-ci.org/UpCloudLtd/upcloud-c-sharp-api.svg?branch=master)](https://travis-ci.org/UpCloudLtd/upcloud-c-sharp-api)\n\nThis C# API client for the UpCloud API provides a web service interface using HTTPS. It allows extensively featured resource management on UpCloud's IaaS with easy to use functions. The API client follows the RESTful web service principles wherever possible.\n\nThe base URL for all API operations is  https://api.upcloud.com/ and require basic authentication using UpCloud username and password. We recommend [creating a subaccount](https://www.upcloud.com/support/server-tags-and-group-accounts/) dedicated for the API communication for security purposes. This allows you to restrict API access by servers, storages, and tags ensuring you will never accidentally affect critical systems.\n\n## Table of content\n* [Frameworks supported](#frameworks-supported)\n* [Dependencies](#dependencies)\n* [Installation](#installation)\n* [Usage](#usage)\n* [Documentation](#documentation)\n* [Issues](#issues)\n* [License](#license)\n\n\n## Frameworks supported\n- .NET 4.0 or later\n- Windows Phone 7.1 (Mango)\n\n## Dependencies\n- [RestSharp](https://www.nuget.org/packages/RestSharp) - 105.1.0 or later\n- [Json.NET](https://www.nuget.org/packages/Newtonsoft.Json/) - 7.0.0 or later\n\nThe DLLs included in the package may not be the latest version. We recommend using [NuGet] (https://docs.nuget.org/consume/installing-nuget) to obtain the latest version of the packages:\n```\nInstall-Package RestSharp\nInstall-Package Newtonsoft.Json\n```\n\nNOTE: RestSharp versions greater than 105.1.0 have a bug which causes file uploads to fail. See [RestSharp#742](https://github.com/restsharp/RestSharp/issues/742)\n\n\n## Installation\nRun the following command to generate the DLL.\n- [Mac/Linux] `/bin/sh build.sh`\n- [Windows] `build.bat`\n\nThen include the DLL (under the `bin` folder) in the C# project, and use the namespaces:\n```csharp\nusing Upcloud.Api;\nusing Upcloud.Client;\nusing Upcloud.Model;\n```\n\n## Packaging\n\nA `.nuspec` is included with the project. You can follow the Nuget quickstart to [create](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package#create-the-package) and [publish](https://docs.microsoft.com/en-us/nuget/quickstart/create-and-publish-a-package#publish-the-package) packages.\n\nThis `.nuspec` uses placeholders from the `.csproj`, so build the `.csproj` directly:\n\n```\nnuget pack -Build -OutputDirectory out Upcloud.csproj\n```\n\nThen, publish to a [local feed](https://docs.microsoft.com/en-us/nuget/hosting-packages/local-feeds) or [other host](https://docs.microsoft.com/en-us/nuget/hosting-packages/overview) and consume the new package via Nuget as usual.\n\n## Usage\n\n```csharp\nusing System;\nusing System.Diagnostics;\nusing Upcloud.Api;\nusing Upcloud.Client;\nusing Upcloud.Model;\n\nnamespace Example\n{\n    public class Example\n    {\n        public void main()\n        {\n\n            // Configure HTTP basic authorization: baseAuth\n            Configuration.Default.Username = Environment.GetEnvironmentVariable(\"UPCLOUD_USERNAME\");\n            Configuration.Default.Password = Environment.GetEnvironmentVariable(\"UPCLOUD_PASSWORD\");\n\n            var apiInstance = new AccountApi();\n\n            try\n            {\n                // Account information\n                AccountResponse result = apiInstance.GetAccount();\n                Debug.WriteLine(result);\n            }\n            catch (Exception e)\n            {\n                Debug.Print(\"Exception when calling AccountApi.GetAccount: \" + e.Message );\n            }\n\n        }\n    }\n}\n```\n\n## Documentation\n\nAll URIs are relative to *https://api.upcloud.com/1.2*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n*AccountApi* | [**GetAccount**](docs/AccountApi.md#getaccount) | **GET** /account | Account information\n*FirewallApi* | [**CreateFirewallRule**](docs/FirewallApi.md#createfirewallrule) | **POST** /server/{serverId}/firewall_rule | Create firewall rule\n*FirewallApi* | [**DeleteFirewallRule**](docs/FirewallApi.md#deletefirewallrule) | **DELETE** /server/{serverId}/firewall_rule/{firewallRuleNumber} | Remove firewall rule\n*FirewallApi* | [**GetFirewallRule**](docs/FirewallApi.md#getfirewallrule) | **GET** /server/{serverId}/firewall_rule/{firewallRuleNumber} | Get firewall rule details\n*FirewallApi* | [**ServerServerIdFirewallRuleGet**](docs/FirewallApi.md#serverserveridfirewallruleget) | **GET** /server/{serverId}/firewall_rule | List firewall rules\n*IPAddressApi* | [**AddIp**](docs/IPAddressApi.md#addip) | **POST** /ip_address | Assign IP address\n*IPAddressApi* | [**DeleteIp**](docs/IPAddressApi.md#deleteip) | **DELETE** /ip_address/{ip} | Release IP address\n*IPAddressApi* | [**GetDetails**](docs/IPAddressApi.md#getdetails) | **GET** /ip_address/{ip} | Get IP address details\n*IPAddressApi* | [**ListIps**](docs/IPAddressApi.md#listips) | **GET** /ip_address | List IP addresses\n*IPAddressApi* | [**ModifyIp**](docs/IPAddressApi.md#modifyip) | **PUT** /ip_address/{ip} | Modify IP address\n*PlanApi* | [**ListPlans**](docs/PlanApi.md#listplans) | **GET** /plan | List available plans\n*PricesApi* | [**ListPrices**](docs/PricesApi.md#listprices) | **GET** /price | List prices\n*ServerApi* | [**AssignTag**](docs/ServerApi.md#assigntag) | **POST** /server/{serverId}/tag/{tagList} | Assign tag to a server\n*ServerApi* | [**AttachStorage**](docs/ServerApi.md#attachstorage) | **POST** /server/{serverId}/storage/attach | Attach storage\n*ServerApi* | [**CreateFirewallRule**](docs/ServerApi.md#createfirewallrule) | **POST** /server/{serverId}/firewall_rule | Create firewall rule\n*ServerApi* | [**CreateServer**](docs/ServerApi.md#createserver) | **POST** /server | Create server\n*ServerApi* | [**DeleteFirewallRule**](docs/ServerApi.md#deletefirewallrule) | **DELETE** /server/{serverId}/firewall_rule/{firewallRuleNumber} | Remove firewall rule\n*ServerApi* | [**DeleteServer**](docs/ServerApi.md#deleteserver) | **DELETE** /server/{serverId} | Delete server\n*ServerApi* | [**DetachStorage**](docs/ServerApi.md#detachstorage) | **POST** /server/{serverId}/storage/detach | Detach storage\n*ServerApi* | [**EjectCdrom**](docs/ServerApi.md#ejectcdrom) | **POST** /server/{serverId}/cdrom/eject | Eject CD-ROM\n*ServerApi* | [**GetFirewallRule**](docs/ServerApi.md#getfirewallrule) | **GET** /server/{serverId}/firewall_rule/{firewallRuleNumber} | Get firewall rule details\n*ServerApi* | [**ListServerConfigurations**](docs/ServerApi.md#listserverconfigurations) | **GET** /server_size | List server configurations\n*ServerApi* | [**ListServers**](docs/ServerApi.md#listservers) | **GET** /server | List of servers\n*ServerApi* | [**LoadCdrom**](docs/ServerApi.md#loadcdrom) | **POST** /server/{serverId}/storage/cdrom/load | Load CD-ROM\n*ServerApi* | [**ModifyServer**](docs/ServerApi.md#modifyserver) | **PUT** /server/{serverId} | Modify server\n*ServerApi* | [**RestartServer**](docs/ServerApi.md#restartserver) | **POST** /server/{serverId}/restart | Restart server\n*ServerApi* | [**ServerDetails**](docs/ServerApi.md#serverdetails) | **GET** /server/{serverId} | Get server details\n*ServerApi* | [**ServerServerIdFirewallRuleGet**](docs/ServerApi.md#serverserveridfirewallruleget) | **GET** /server/{serverId}/firewall_rule | List firewall rules\n*ServerApi* | [**StartServer**](docs/ServerApi.md#startserver) | **POST** /server/{serverId}/start | Start server\n*ServerApi* | [**StopServer**](docs/ServerApi.md#stopserver) | **POST** /server/{serverId}/stop | Stop server\n*ServerApi* | [**Untag**](docs/ServerApi.md#untag) | **POST** /server/{serverId}/untag/{tagName} | Remove tag from server\n*StorageApi* | [**AttachStorage**](docs/StorageApi.md#attachstorage) | **POST** /server/{serverId}/storage/attach | Attach storage\n*StorageApi* | [**BackupStorage**](docs/StorageApi.md#backupstorage) | **POST** /storage/{storageId}/backup | Create backup\n*StorageApi* | [**CancelOperation**](docs/StorageApi.md#canceloperation) | **POST** /storage/{storageId}/cancel | Cancel storage operation\n*StorageApi* | [**CloneStorage**](docs/StorageApi.md#clonestorage) | **POST** /storage/{storageId}/clone | Clone storage\n*StorageApi* | [**CreateStorage**](docs/StorageApi.md#createstorage) | **POST** /storage | Create storage\n*StorageApi* | [**DeleteStorage**](docs/StorageApi.md#deletestorage) | **DELETE** /storage/{storageId} | Delete storage\n*StorageApi* | [**DetachStorage**](docs/StorageApi.md#detachstorage) | **POST** /server/{serverId}/storage/detach | Detach storage\n*StorageApi* | [**EjectCdrom**](docs/StorageApi.md#ejectcdrom) | **POST** /server/{serverId}/cdrom/eject | Eject CD-ROM\n*StorageApi* | [**FavoriteStorage**](docs/StorageApi.md#favoritestorage) | **POST** /storage/{storageId}/favorite | Add storage to favorites\n*StorageApi* | [**GetStorageDetails**](docs/StorageApi.md#getstoragedetails) | **GET** /storage/{storageId} | Get storage details\n*StorageApi* | [**ListStorageTypes**](docs/StorageApi.md#liststoragetypes) | **GET** /storage/{type}/ | List of storages by type\n*StorageApi* | [**ListStorages**](docs/StorageApi.md#liststorages) | **GET** /storage | List of storages\n*StorageApi* | [**LoadCdrom**](docs/StorageApi.md#loadcdrom) | **POST** /server/{serverId}/storage/cdrom/load | Load CD-ROM\n*StorageApi* | [**ModifyStorage**](docs/StorageApi.md#modifystorage) | **PUT** /storage/{storageId} | Modify storage\n*StorageApi* | [**RestoreStorage**](docs/StorageApi.md#restorestorage) | **POST** /storage/{storageId}/restore | Restore backup\n*StorageApi* | [**TemplatizeStorage**](docs/StorageApi.md#templatizestorage) | **POST** /storage/{storageId}/templatize | Templatize storage\n*StorageApi* | [**UnfavoriteStorage**](docs/StorageApi.md#unfavoritestorage) | **DELETE** /storage/{storageId}/favorite | Remove storage from favorites\n*TagApi* | [**AssignTag**](docs/TagApi.md#assigntag) | **POST** /server/{serverId}/tag/{tagList} | Assign tag to a server\n*TagApi* | [**CreateTag**](docs/TagApi.md#createtag) | **POST** /tag | Create a new tag\n*TagApi* | [**DeleteTag**](docs/TagApi.md#deletetag) | **DELETE** /tag/{tagName} | Delete tag\n*TagApi* | [**ListTags**](docs/TagApi.md#listtags) | **GET** /tag | List existing tags\n*TagApi* | [**ModifyTag**](docs/TagApi.md#modifytag) | **PUT** /tag/{tagName} | Modify existing tag\n*TagApi* | [**Untag**](docs/TagApi.md#untag) | **POST** /server/{serverId}/untag/{tagName} | Remove tag from server\n*TimezoneApi* | [**ListTimezones**](docs/TimezoneApi.md#listtimezones) | **GET** /timezone | List timezones\n*ZoneApi* | [**ListZones**](docs/ZoneApi.md#listzones) | **GET** /zone | List available zones\n\n\n## Documentation of the models\n\n - [Model.Account](docs/Account.md)\n - [Model.AccountResponse](docs/AccountResponse.md)\n - [Model.AddIpRequest](docs/AddIpRequest.md)\n - [Model.AddressFamily](docs/AddressFamily.md)\n - [Model.AssignIpResponse](docs/AssignIpResponse.md)\n - [Model.AttachStorageDeviceRequest](docs/AttachStorageDeviceRequest.md)\n - [Model.AvailablePlanListResponse](docs/AvailablePlanListResponse.md)\n - [Model.AvailablePlanListResponsePlans](docs/AvailablePlanListResponsePlans.md)\n - [Model.BackupRule](docs/BackupRule.md)\n - [Model.CloneStorageRequest](docs/CloneStorageRequest.md)\n - [Model.ConfigurationListResponse](docs/ConfigurationListResponse.md)\n - [Model.ConfigurationListResponseServerSizes](docs/ConfigurationListResponseServerSizes.md)\n - [Model.CreateBackupStorageRequest](docs/CreateBackupStorageRequest.md)\n - [Model.CreateNewTagResponse](docs/CreateNewTagResponse.md)\n - [Model.CreateServerRequest](docs/CreateServerRequest.md)\n - [Model.CreateServerResponse](docs/CreateServerResponse.md)\n - [Model.CreateStorageRequest](docs/CreateStorageRequest.md)\n - [Model.CreateStorageResponse](docs/CreateStorageResponse.md)\n - [Model.Error](docs/Error.md)\n - [Model.ErrorCode](docs/ErrorCode.md)\n - [Model.ErrorError](docs/ErrorError.md)\n - [Model.ErrorStatus](docs/ErrorStatus.md)\n - [Model.FirewallRule](docs/FirewallRule.md)\n - [Model.FirewallRuleCreateResponse](docs/FirewallRuleCreateResponse.md)\n - [Model.FirewallRuleListResponse](docs/FirewallRuleListResponse.md)\n - [Model.FirewallRuleListResponseFirewallRules](docs/FirewallRuleListResponseFirewallRules.md)\n - [Model.FirewallRuleRequest](docs/FirewallRuleRequest.md)\n - [Model.IpAddress](docs/IpAddress.md)\n - [Model.IpAddressListResponse](docs/IpAddressListResponse.md)\n - [Model.IpAddresses](docs/IpAddresses.md)\n - [Model.ModifyIpRequest](docs/ModifyIpRequest.md)\n - [Model.ModifyStorageRequest](docs/ModifyStorageRequest.md)\n - [Model.ModifyTagRequest](docs/ModifyTagRequest.md)\n - [Model.Plan](docs/Plan.md)\n - [Model.Price](docs/Price.md)\n - [Model.PriceListResponse](docs/PriceListResponse.md)\n - [Model.PriceListResponsePrices](docs/PriceListResponsePrices.md)\n - [Model.PriceZone](docs/PriceZone.md)\n - [Model.RestartServer](docs/RestartServer.md)\n - [Model.Server](docs/Server.md)\n - [Model.ServerListResponse](docs/ServerListResponse.md)\n - [Model.ServerListResponseServers](docs/ServerListResponseServers.md)\n - [Model.ServerSize](docs/ServerSize.md)\n - [Model.ServerState](docs/ServerState.md)\n - [Model.ServerStorageDevices](docs/ServerStorageDevices.md)\n - [Model.ServerTags](docs/ServerTags.md)\n - [Model.StopServer](docs/StopServer.md)\n - [Model.StopServerRequest](docs/StopServerRequest.md)\n - [Model.Storage](docs/Storage.md)\n - [Model.StorageAccessType](docs/StorageAccessType.md)\n - [Model.StorageBackups](docs/StorageBackups.md)\n - [Model.StorageDevice](docs/StorageDevice.md)\n - [Model.StorageDeviceDetachRequest](docs/StorageDeviceDetachRequest.md)\n - [Model.StorageDeviceLoadRequest](docs/StorageDeviceLoadRequest.md)\n - [Model.StorageServers](docs/StorageServers.md)\n - [Model.StorageState](docs/StorageState.md)\n - [Model.StorageTier](docs/StorageTier.md)\n - [Model.StorageType](docs/StorageType.md)\n - [Model.SuccessStoragesResponse](docs/SuccessStoragesResponse.md)\n - [Model.SuccessStoragesResponseStorages](docs/SuccessStoragesResponseStorages.md)\n - [Model.Tag](docs/Tag.md)\n - [Model.TagCreateRequest](docs/TagCreateRequest.md)\n - [Model.TagListResponse](docs/TagListResponse.md)\n - [Model.TagListResponseTags](docs/TagListResponseTags.md)\n - [Model.TagServers](docs/TagServers.md)\n - [Model.TemplitizeStorageRequest](docs/TemplitizeStorageRequest.md)\n - [Model.Timezone](docs/Timezone.md)\n - [Model.TimezoneListResponse](docs/TimezoneListResponse.md)\n - [Model.TimezoneListResponseTimezones](docs/TimezoneListResponseTimezones.md)\n - [Model.Zone](docs/Zone.md)\n - [Model.ZoneListResponse](docs/ZoneListResponse.md)\n - [Model.ZoneListResponseZones](docs/ZoneListResponseZones.md)\n\n\n## Documentation for authorization\n\nIt's recommended to store the username and password as environmental variables while developing API applications to avoid accidentally publishing your account credentials.\n\n### baseAuth\n\n- **Type**: HTTP basic authentication\n- **Username**: Your UpCloud API username\n- **Password**: Your UpCloud API user's password\n\n\n## Issues\nFound a bug, have a problem using the client, or anything else about the library you would want to mention? [Open a new issue here](https://github.com/UpCloudLtd/upcloud-c-sharp-api/issues/new) to get in contact.\n\n## License\n\nThis project is distributed under the [MIT License](https://opensource.org/licenses/MIT), see LICENSE.txt for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxafero%2Fupcloud-c-sharp-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxafero%2Fupcloud-c-sharp-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxafero%2Fupcloud-c-sharp-api/lists"}