{"id":2539,"date":"2022-03-31T16:55:02","date_gmt":"2022-03-31T13:55:02","guid":{"rendered":"https:\/\/upcloud.com\/global\/us\/resources\/docs\/cloud-servers\/"},"modified":"2022-03-31T16:55:02","modified_gmt":"2022-03-31T13:55:02","slug":"cloud-servers","status":"publish","type":"documentation","link":"https:\/\/upcloud.com\/global\/resources\/docs\/cloud-servers\/","title":{"rendered":"Cloud Servers"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Cloud Servers offer on-demand availability of computer system resources, including data storage and computational capacity without the need to directly manage the server hardware. UpCloud users are able to deploy Cloud Servers by selecting from the predefined configuration options; General Purpose, High CPU and High Memory plans or by freely allocating resources as needed using the Flexible plan.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">General Purpose plans<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">General Purpose plans offer predefined configuration options with fixed monthly costs. Each plan bundles a set amount of server resources included in the plan pricing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">General Purpose plans include balanced sets of allocated CPU cores, amount of RAM, MaxIOPS storage and a monthly quota of outbound network transfer suitable for most use cases.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Global<\/strong>*<\/th><th><strong>Helsinki<\/strong>*<\/th><th><strong>CPU cores<\/strong><\/th><th><strong>RAM<\/strong><\/th><th><strong>Storage<\/strong><\/th><th><strong>Transfer<\/strong><\/th><th><strong>Identifier<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u20ac7<\/td><td>\u20ac7.5<\/td><td>1 core<\/td><td>1 GB<\/td><td>25 GB<\/td><td>1 TB<\/td><td>1xCPU-1GB<\/td><\/tr><tr><td>\u20ac13<\/td><td>\u20ac15<\/td><td>1 core<\/td><td>2 GB<\/td><td>50 GB<\/td><td>2 TB<\/td><td>1xCPU-2GB<\/td><\/tr><tr><td>\u20ac26<\/td><td>\u20ac30<\/td><td>2 cores<\/td><td>4 GB<\/td><td>80 GB<\/td><td>4 TB<\/td><td>2xCPU-4GB<\/td><\/tr><tr><td>\u20ac52<\/td><td>\u20ac60<\/td><td>4 cores<\/td><td>8 GB<\/td><td>160 GB<\/td><td>5 TB<\/td><td>4xCPU-8GB<\/td><\/tr><tr><td>\u20ac96<\/td><td>\u20ac120<\/td><td>6 cores<\/td><td>16 GB<\/td><td>320 GB<\/td><td>6 TB<\/td><td>6xCPU-16GB<\/td><\/tr><tr><td>\u20ac192<\/td><td>\u20ac240<\/td><td>8 cores<\/td><td>32 GB<\/td><td>640 GB<\/td><td>7 TB<\/td><td>8xCPU-32GB<\/td><\/tr><tr><td>\u20ac288<\/td><td>\u20ac360<\/td><td>12 cores<\/td><td>48 GB<\/td><td>960 GB<\/td><td>9 TB<\/td><td>12xCPU-48GB<\/td><\/tr><tr><td>\u20ac384<\/td><td>\u20ac480<\/td><td>16 cores<\/td><td>64 GB<\/td><td>1280 GB<\/td><td>10 TB<\/td><td>16xCPU-64GB<\/td><\/tr><tr><td>\u20ac576<\/td><td>\u20ac720<\/td><td>24 cores<\/td><td>96 GB<\/td><td>1920 GB<\/td><td>12 TB<\/td><td>24xCPU-96GB<\/td><\/tr><tr><td>\u20ac768<\/td><td>\u20ac960<\/td><td>32 cores<\/td><td>128 GB<\/td><td>2048 GB<\/td><td>24 TB<\/td><td>32xCPU-128GB<\/td><\/tr><tr><td>\u20ac1024<\/td><td>\u20ac1280<\/td><td>38 cores<\/td><td>192 GB<\/td><td>2048 GB<\/td><td>24 TB<\/td><td>38xCPU-192GB<\/td><\/tr><tr><td>\u20ac1364<\/td><td>\u20ac1705<\/td><td>48 cores<\/td><td>256 GB<\/td><td>2048 GB<\/td><td>24 TB<\/td><td>48xCPU-256GB<\/td><\/tr><tr><td>\u20ac1992<\/td><td>\u20ac2403<\/td><td>64 cores<\/td><td>384 GB<\/td><td>2048 GB<\/td><td>24 TB<\/td><td>64xCPU-384GB<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">* General Purpose plans are billed for 28 days per month to guarantee a fixed price for every month. Prices exclude any applicable\u00a0<a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/vat-gst-international-businesses\/?_ga=2.3893488.1185329529.1666081137-1570901545.1653404322\">local taxes<\/a>.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">High CPU plans<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">High CPU plans offer sets of resources ideal for higher computational needs while being price competitive.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">High CPU plans include the following configuration options for CPU cores, amount of RAM, MaxIOPS storage and a monthly quota of outbound network transfer.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th><strong>Global<\/strong>*<\/th><th>Helsinki*<\/th><th><strong>CPU cores<\/strong><\/th><th><strong>RAM<\/strong><\/th><th><strong>Storage<\/strong><\/th><th><strong>Transfer<\/strong><\/th><th><strong>Identifier<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u20ac130<\/td><td>\u20ac162<\/td><td>8 core<\/td><td>12 GB<\/td><td>100 GB<\/td><td>4 TB<\/td><td>HICPU-8xCPU-12GB<\/td><\/tr><tr><td>\u20ac160<\/td><td>\u20ac192<\/td><td>8 core<\/td><td>16 GB<\/td><td>200 GB<\/td><td>5 TB<\/td><td>HICPU-8xCPU-16GB<\/td><\/tr><tr><td>\u20ac260<\/td><td>\u20ac312<\/td><td>16 cores<\/td><td>24 GB<\/td><td>100 GB<\/td><td>5 TB<\/td><td>HICPU-16xCPU-24GB<\/td><\/tr><tr><td>\u20ac310<\/td><td>\u20ac372<\/td><td>16 cores<\/td><td>32 GB<\/td><td>200 GB<\/td><td>6 TB<\/td><td>HICPU-16xCPU-32GB<\/td><\/tr><tr><td>\u20ac530<\/td><td>\u20ac689<\/td><td>32 cores<\/td><td>48 GB<\/td><td>200 GB<\/td><td>6 TB<\/td><td>HICPU-32xCPU-48GB<\/td><\/tr><tr><td>\u20ac620<\/td><td>\u20ac806<\/td><td>32 cores<\/td><td>64 GB<\/td><td>300 GB<\/td><td>7 TB<\/td><td>HICPU-32xCPU-64GB<\/td><\/tr><tr><td>\u20ac1056<\/td><td>\u20ac1372<\/td><td>64 cores<\/td><td>96 GB<\/td><td>200 GB<\/td><td>7 TB<\/td><td>HICPU-64xCPU-96GB<\/td><\/tr><tr><td>\u20ac1248<\/td><td>\u20ac1620<\/td><td>64 cores<\/td><td>128 GB<\/td><td>300 GB<\/td><td>8 TB<\/td><td>HICPU-64xCPU-128GB<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">* High CPU plans are billed for 28 days per month to guarantee a fixed price for every month. Prices exclude any applicable\u00a0<a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/vat-gst-international-businesses\/?_ga=2.3893488.1185329529.1666081137-1570901545.1653404322\">local taxes<\/a>.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">High Memory plans<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">High Memory plans provide an increased amount of system memory for memory-intensive workloads.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">High Memory plans allocate CPU cores, amount of RAM, MaxIOPS storage and a monthly quota of outbound network transfer according to the list below.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-regular\"><table><thead><tr><th>Global*<\/th><th>Helsinki*<\/th><th><strong>CPU cores<\/strong><\/th><th><strong>RAM<\/strong><\/th><th><strong>Storage<\/strong><\/th><th><strong>Transfer<\/strong><\/th><th><strong>Identifier<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u20ac40<\/td><td>\u20ac50<\/td><td>2 core<\/td><td>8 GB<\/td><td>100 GB<\/td><td>2 TB<\/td><td>HIMEM-2xCPU-8GB<\/td><\/tr><tr><td>\u20ac65<\/td><td>\u20ac94<\/td><td>2 core<\/td><td>16 GB<\/td><td>100 GB<\/td><td>2 TB<\/td><td>HIMEM-2xCPU-16GB<\/td><\/tr><tr><td>\u20ac132<\/td><td>\u20ac168<\/td><td>4 cores<\/td><td>32 GB<\/td><td>100 GB<\/td><td>4 TB<\/td><td>HIMEM-4xCPU-32GB<\/td><\/tr><tr><td>\u20ac240<\/td><td>\u20ac340<\/td><td>4 cores<\/td><td>64 GB<\/td><td>200 GB<\/td><td>4 TB<\/td><td>HIMEM-4xCPU-64GB<\/td><\/tr><tr><td>\u20ac480<\/td><td>\u20ac680<\/td><td>6 cores<\/td><td>128 GB<\/td><td>300 GB<\/td><td>6 TB<\/td><td>HIMEM-6xCPU-128GB<\/td><\/tr><tr><td>\u20ac840<\/td><td>\u20ac1060<\/td><td>8 cores<\/td><td>192 GB<\/td><td>400 GB<\/td><td>8 TB<\/td><td>HIMEM-8xCPU-192GB<\/td><\/tr><tr><td>\u20ac1080<\/td><td>\u20ac1290<\/td><td>12 cores<\/td><td>256 GB<\/td><td>500 GB<\/td><td>10 TB<\/td><td>HIMEM-12xCPU-256GB<\/td><\/tr><tr><td>\u20ac1680<\/td><td>\u20ac1990<\/td><td>16 cores<\/td><td>384 GB<\/td><td>600 GB<\/td><td>12 TB<\/td><td>HIMEM-16xCPU-384GB<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">* High Memory plans are billed for 28 days per month to guarantee a fixed price for every month. Prices exclude any applicable\u00a0<a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/vat-gst-international-businesses\/?_ga=2.3893488.1185329529.1666081137-1570901545.1653404322\">local taxes<\/a>.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Predefined plans common features<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The predefined configuration; General Purpose, High CPU and High Memory plans include a versatile range of server resources for varying use cases. While the resource configurations differ between each plan type, they all enjoy many of the same benefits.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Billing per hour with a fixed monthly price<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Predefined plan Cloud Servers are priced by fixed monthly costs but billed per hour. This allows users to run persistent cloud servers at a predictable monthly cost but also deploy and delete short-term instances only paying for the hours used.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cloud Servers on the Simple plan are billed hourly and capped at 672 hours (24 h x 28 days) per month. This is done to ensure the monthly costs are the same every month regardless of the number of days in each month.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">What is included<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The predefined plans consolidate everything needed to run many types of web applications with no obligations for additional services. The monthly price includes the CPU, system memory, and MaxIOPS storage listed on the <a href=\"https:\/\/upcloud.com\/global\/pricing\/#cloud-servers\">pricing table<\/a>, as well as 1 public IPv4 address.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">What are billed separately<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Besides the essentials, we also offer additional services such as backups, firewalls, floating IPs, and SDN private networking. These additional services and usages exceeding plan allowances, such as extra storage and network transfer exceeding the monthly quota, are billed hourly for their usage according to our <a href=\"https:\/\/upcloud.com\/global\/pricing\/#additional-services\">listed pricing<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How predefined Cloud Servers plans are billed when shut down<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">General Purpose, High CPU and High Memory plan Cloud Servers are billed per hour regardless of whether the server is powered on or shut down. This is due to the discounted bundle pricing which in turn affords a lower monthly cost.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Trial limitations<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">We offer a 3-day free trial to new users which is intended to allow getting familiar with our services and test Cloud Server deployments without commitment. As such, the trial has some limitations. During the trial period, users are able to deploy only one \u20ac7 General Purpose plan Cloud Server at a time. However, it\u2019s possible to delete and re-deploy a Cloud Server to test different locations or operating systems.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When the free trial expires, user-created resources are deleted. Users are able to continue using the service and retain all resources created during the trial by making at least the minimum \u20ac10 deposit to their account.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Flexible plan<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">In addition to the set configuration plans; General Purpose, High CPU and High Memory, UpCloud offers the option of selecting Cloud Server resources exactly as needed using the Flexible plan. The Flexible plan allows users to configure their Cloud Server with the number of CPU cores and the amount of system memory and storage as required. Each resource can be configured independently from the other allowing a wide range of Cloud Server setups.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Configuration ranges<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">By selecting the Flexible plan, users can adjust CPU and system memory resources on a fine-grain control. Flexible plans allow the following ranges of resource configurations:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>CPU 1 &#8211; 20 cores in 1-core increments<\/li>\n\n\n\n<li>Memory 1 &#8211; 128 GB in 1 GB increments<\/li>\n\n\n\n<li>Storage 10 GB &#8211; 4 TB in 1 GB increments, up to 8 storage devices<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Billing per hour<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Flexible plans are billed per hour according to the used resources without bundling. The estimated monthly cost is displayed in the <a href=\"https:\/\/hub.upcloud.com\/\">UpCloud Control Panel<\/a> in the server settings under the Resize menu. The resources are billed for every day of the month as opposed to the set plans which are only billed for 28 days per month.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How Flexible plan Cloud Servers are billed when shut down<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Flexible plans also give users additional control over the costs of their cloud resources. Cloud Servers using Flexible plans are only billed for their storage, backups and network resources such as IP addresses and SDN private networks when powered down. When shutdown, CPU and RAM resources are not billed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Anti-affinity groups<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cloud Servers can be placed in server groups which support anti-affinity. During startup, servers in the same anti-affinity group will be attempted to be placed on separate hosts in order to achieve a better fault tolerance against hardware failures. It is recommended to enable anti-affinity when servers provide a redundant role, for example being members of the same load balancer backend group.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">UpCloud supports two anti-affinity policies: <strong>soft<\/strong> and <strong>strict<\/strong>. <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>With the soft policy, the Cloud Server is started even if anti-affinity cannot be met.<\/li>\n\n\n\n<li>With the hard policy, starting with unmet anti-affinity will throw an error.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Note that in certain circumstances it might not always be possible to start all Cloud Servers on separate hosts. Depending on the selected anti-affinity policy, failing the anti-affinity requirement may cause the startup to fail.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Resizing<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/using-simple-flexible-plans\/\">Cloud Servers can be reconfigured<\/a> even after deployment at the <a href=\"https:\/\/hub.upcloud.com\/\">UpCloud Control Panel<\/a> in the server settings and Resize menu. This allows users to increase or decrease their Cloud Server resources by simply powering down their server to make changes as required without the need for redeployment.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Scaling up<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Increasing Cloud Server resources also called scaling up, allows users to allocate more CPU cores, system memory and storage when more capacity is needed.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Users can <a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/using-simple-flexible-plans\/#point-3\">upgrade their Simple plan Cloud Servers<\/a> easily by selecting a higher tier plan at the control panel in the server settings and the Resize menu.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Flexible plan users also have the option to <a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/using-simple-flexible-plans\/#point-3\">increase Cloud Server resources<\/a> to the same degree of control as at deployment.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Scaling up does not automatically i<a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/managing-storage-devices\/#point-3\">ncrease the storage device size<\/a> which needs to be done separately.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Cloud Server must be in the stopped state during resizing.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Hot resize<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Hot resizing allows the user to increase their Cloud Server resources without needing to shut down the server. The feature is automatically enabled on Cloud Servers created on or after April 27th 2022. Servers created before this date require a single shutdown and start for hot resizing to become available.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The maximum increase amount available is dependent on the user\u2019s account resource limits and the available resources on the Cloud Server\u2019s current host machine.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The storage devices attached to the Cloud Server being resized are not increased automatically. This is done to enable users to also easily scale down to their previous server plan. <a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/managing-storage-devices\/#point-3\">Increasing the storage device<\/a> size needs to be done separately.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Hot resizing system memory is done using virtual memory slots. Each Cloud Server has a fixed number of memory slots. Every time memory is added using hot resized, these slots are used to include the added amount of memory. If all slots are already in use, system memory cannot be increased using hot resize until the server is shut down and started. After a full restart, allocated system memory is consolidated and the slots are freed for further hot resizing.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Scaling down<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Both Simple and Flexible plan Cloud Servers can be scaled down by selecting a plan with fewer resources.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Scaling down does not reduce the storage device size automatically. This needs to be done manually by the user. This can be accomplished by <a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/resizing-storage\/\">following our storage resizing tutorial.<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Cloud Server must be in the stopped state during resizing.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Swapping between Simple and Flexible<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In addition to being able to resize Cloud Servers, it\u2019s possible to freely <a href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/using-simple-flexible-plans\/#point-4\">change between the Simple and Flexible plans<\/a> at the UpCloud control panel under the resize menu. Selecting a plan of a different type will change how the Cloud Server is billed accordingly.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Cloud Server must be in the stopped state during resizing.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Metadata service<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">UpCloud Metadata service allows users to query already deployed Cloud Servers to get information about the server itself. The data can be utilised, for example, as the basis for the automatic configuration of the servers after the initial deployment.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Enabling Metadata service<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Metadata service can be <a rel=\"noreferrer noopener\" href=\"https:\/\/upcloud.com\/global\/resources\/tutorials\/upcloud-metadata-service\/\" target=\"_blank\">selected at deployment or enabled on any existing Cloud Servers<\/a> at the user&#8217;s <a rel=\"noreferrer noopener\" href=\"https:\/\/hub.upcloud.com\" target=\"_blank\">UpCloud Control Panel<\/a> or via the <a rel=\"noreferrer noopener\" href=\"https:\/\/developers.upcloud.com\/1.3\/8-servers\/#modify-server\" target=\"_blank\">UpCloud API<\/a>. The initial deployment of Cloud Servers using new public templates which require SSH-key only need to have Metadata service enabled.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cloud Servers deployed without the Metadata service can enable it at any point without the need to restart the server. This can be done either via the UpCloud Control Panel in the server Optional settings or by using the UpCloud API.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The toggle for the Metadata service can be found in the Cloud Server settings under the Optional settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Alternatively, metadata service can be enabled with the following API request by replacing the server-UUID with the UUID of the user\u2019s Cloud Server.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">PUT \/1.3\/server\/server-UUID\/\n{\n&nbsp;&nbsp;&nbsp;\"server\": {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"metadata\": \"yes\"\n&nbsp;&nbsp;&nbsp;&nbsp;}\n}<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Querying metadata<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Metadata is available as a cloud-init compatible JSON and via a filesystem-like traversable API. Both can be queried on any of the user\u2019s Cloud Servers using any HTTP client such as curl or wget.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Metadata is available to be queried through all networks: public, utility and SDN private networks.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Metadata endpoint<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">http:\/\/169.254.169.254\/metadata\/v1.json<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Metadata allows users to find specific information about resources which can include multiples of the same type, for example, storage and networks.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Below is a list of all currently available fields provided by the Metadata service.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Cloud name<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"cloud_name\": \"upcloud\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The name of the cloud provider for inter compatibility<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Instance ID<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"instance_id\": \"00bf9504-a4cb-4839-88ff-124a2c95e169\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The UUID is generated at deployment<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Hostname<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"hostname\": \"metadata.example.com\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Cloud Server&#8217;s hostname as defined by the user<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Platform<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"platform\": \"servers\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The type of platform in use<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Subplatform<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"subplatform\": \"metadata (http:\/\/169.254.169.254)\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Metadata endpoint address<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Public keys<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"public_keys\": [\n&nbsp;&nbsp;\"ssh-rsa AAAAB[...]ud1Cw== max@upcloud.com\"\n]<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">SSH keys included by the user<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Region<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"region\": \"de-fra1\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Server location<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Network<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"network\": {\n&nbsp;&nbsp;\"interfaces\": [\n&nbsp;&nbsp;  {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"index\": 1,\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"ip_addresses\": [\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"address\": \"94.237.90.209\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"dhcp\": true,\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"dns\": [\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"94.237.127.9\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"94.237.40.9\"\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"family\": \"IPv4\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"floating\": false,\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"gateway\": \"94.237.90.1\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"network\": \"94.237.90.0\/24\"\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"mac\": \"de:ad:be:ef:3f:c5\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"network_id\": \"03030473-8e9d-4f4f-bcfe-b2c300391a07\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"type\": \"public\"\n&nbsp;&nbsp;  },\n&nbsp;&nbsp;]\n&nbsp;&nbsp;\"dns\": [\n&nbsp;&nbsp;&nbsp;&nbsp;\"94.237.127.9\",\n&nbsp;&nbsp;&nbsp;&nbsp;\"94.237.40.9\"\n&nbsp;&nbsp;]\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Network interfaces and DNS addresses configured to the server<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Storage<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"storage\": {\n&nbsp;&nbsp;\"disks\": [\n&nbsp;&nbsp;&nbsp;&nbsp;{\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"id\": \"0187b8c5-7220-4c90-9026-047dff8be0b3\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"serial\": \"0187b8c572204c909026\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"size\": 25,\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"type\": \"disk\",\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;\"tier\": \"maxiops\"\n&nbsp;&nbsp;&nbsp;&nbsp;}\n&nbsp;&nbsp;]\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">All storage devices attached to the server<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Tags<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"tags\": [\n&nbsp;&nbsp;\"dev\",\n&nbsp;&nbsp;\"metadata\"\n]<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">User-defined tags assigned to the Cloud Server<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">User data<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"user_data\": \"apt-get update &amp;&amp; apt-get -y upgrade\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Deployment script or script URL<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Vendor data<\/h4>\n\n\n\n<pre class=\"wp-block-preformatted\">\"vendor_data\": \"\"<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Any specific data field can be queried using the filesystem-like traversable API. For example, the following query can be used to get the IP address of the first network interfaces.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">http:\/\/169.254.169.254\/metadata\/v1\/network\/interfaces\/1\/ip_addresses\/0\/address<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The Metadata service will then return the value of the queried field omitting the key. Meaning the output can be used directly without additional formatting.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">94.237.90.209<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The main advantage of Metadata allows it to be used to configure applications and services which require server-specific information that is not known before deployment.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Data centres<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">UpCloud runs data centres around the world to provide our users with a wide variety of regions and locations.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Our data centres are run in trusted enterprise-grade data centres that provide the state-of-art facilities needed to operate our services. We use our own hardware in every location.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Available locations<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">We currently offer data centres in the following locations:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Europe<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>DE-FRA1 &#8211; Frankfurt, Germany<\/li>\n\n\n\n<li>FI-HEL1 &#8211; Helsinki, Finland<\/li>\n\n\n\n<li>FI-HEL2 &#8211; Helsinki, Finland<\/li>\n\n\n\n<li>ES-MAD1 &#8211; Madrid, Spain<\/li>\n\n\n\n<li>NL-AMS1 &#8211; Amsterdam, Netherlands<\/li>\n\n\n\n<li>PL-WAW1 &#8211; Warsaw, Poland<\/li>\n\n\n\n<li>UK-LON1 &#8211; London, UK<\/li>\n\n\n\n<li><a href=\"https:\/\/upcloud.com\/global\/blog\/get-to-know-our-swedish-data-centre\">SE-STO1 &#8211; Stockholm, Sweden<\/a><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Asia-Pacific<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>AU-SYD1 &#8211; Sydney, Australia<\/li>\n\n\n\n<li>SG-SIN1 &#8211; Singapore, Singapore<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">North America<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>US-CHI1 &#8211; Chicago, USA<\/li>\n\n\n\n<li>US-NYC1 &#8211; New York City, USA<\/li>\n\n\n\n<li>US-SJO1 &#8211; San Jose, USA<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">New locations are added as we grow our infrastructure.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Different pricing in certain locations<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Cloud Servers deployed to FI-HEL1 or FI-HEL2 are priced at 50% higher than our other locations. The prices are displayed at deployment.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Computation backend<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">UpCloud is built on the principles of speed and reliability by employing the latest technologies and hardware.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Automated failover<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Our infrastructure is designed from the ground up with high availability in mind. All mission-critical components are backed up by N+1 redundancy, including all compute nodes hosting users\u2019 Cloud Servers. Should a compute node fail, the operations will be transferred over to another compute node and the Cloud Servers will continue running with minimal interruption.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Virtualisation<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">We use the true and tested Linux Kernel-based Virtual Machine, or KVM, virtualisation module to provide hardware-assisted virtualisation.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">CPU<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">We use top-of-the-range hardware at every one of our data centres, including high-powered enterprise-grade processors.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Automated balancing<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Our infrastructure optimises the load across compute nodes within data centres by deploying new and recently started Cloud Servers on the least used hosts. Users experiencing reduced performance can take advantage of the automated balancing by shutting down and starting the affected Cloud Server.<\/p>\n","protected":false},"featured_media":0,"template":"","class_list":["post-2539","documentation","type-documentation","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/documentation\/2539","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":0,"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/documentation\/2539\/revisions"}],"wp:attachment":[{"href":"https:\/\/upcloud.com\/global\/wp-json\/wp\/v2\/media?parent=2539"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}