Querying metadata<\/h3>\r\n\r\n\r\n\r\n

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>\r\n\r\n\r\n\r\n

Metadata is available to be queried through all networks: public, utility and SDN private networks.<\/p>\r\n\r\n\r\n\r\n

Metadata endpoint<\/h4>\r\n\r\n\r\n\r\n

http:\/\/169.254.169.254\/metadata\/v1.json<\/pre>\r\n\r\n\r\n\r\n
Metadata allows users to find specific information about resources which can include multiples of the same type, for example, storage and networks.<\/p>\r\n\r\n\r\n\r\n
Below is a list of all currently available fields provided by the Metadata service.<\/p>\r\n\r\n\r\n\r\n
Cloud name<\/h4>\r\n\r\n\r\n\r\n
\"cloud_name\": \"upcloud\"<\/pre>\r\n\r\n\r\n\r\n
The name of the cloud provider for inter compatibility<\/p>\r\n\r\n\r\n\r\n
Instance ID<\/h4>\r\n\r\n\r\n\r\n
\"instance_id\": \"00bf9504-a4cb-4839-88ff-124a2c95e169\"<\/pre>\r\n\r\n\r\n\r\n
The UUID is generated at deployment<\/p>\r\n\r\n\r\n\r\n
Hostname<\/h4>\r\n\r\n\r\n\r\n
\"hostname\": \"metadata.example.com\"<\/pre>\r\n\r\n\r\n\r\n
Cloud Server’s hostname as defined by the user<\/p>\r\n\r\n\r\n\r\n
Platform<\/h4>\r\n\r\n\r\n\r\n
\"platform\": \"servers\"<\/pre>\r\n\r\n\r\n\r\n
The type of platform in use<\/p>\r\n\r\n\r\n\r\n
Subplatform<\/h4>\r\n\r\n\r\n\r\n
\"subplatform\": \"metadata (http:\/\/169.254.169.254)\"<\/pre>\r\n\r\n\r\n\r\n
Metadata endpoint address<\/p>\r\n\r\n\r\n\r\n
Public keys<\/h4>\r\n\r\n\r\n\r\n
\"public_keys\": [\r\n\u00a0\u00a0\"ssh-rsa AAAAB[...]ud1Cw== max@upcloud.com\"\r\n]<\/pre>\r\n\r\n\r\n\r\n
SSH keys included by the user<\/p>\r\n\r\n\r\n\r\n
Region<\/h4>\r\n\r\n\r\n\r\n
\"region\": \"de-fra1\"<\/pre>\r\n\r\n\r\n\r\n
Server location<\/p>\r\n\r\n\r\n\r\n
Network<\/h4>\r\n\r\n\r\n\r\n
\"network\": {\r\n\u00a0\u00a0\"interfaces\": [\r\n\u00a0\u00a0  {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"index\": 1,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"ip_addresses\": [\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0{\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"address\": \"94.237.90.209\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"dhcp\": true,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"dns\": [\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"94.237.127.9\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"94.237.40.9\"\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0],\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"family\": \"IPv4\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"floating\": false,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"gateway\": \"94.237.90.1\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"network\": \"94.237.90.0\/24\"\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0}\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0],\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"mac\": \"de:ad:be:ef:3f:c5\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"network_id\": \"03030473-8e9d-4f4f-bcfe-b2c300391a07\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"type\": \"public\"\r\n\u00a0\u00a0  },\r\n\u00a0\u00a0]\r\n\u00a0\u00a0\"dns\": [\r\n\u00a0\u00a0\u00a0\u00a0\"94.237.127.9\",\r\n\u00a0\u00a0\u00a0\u00a0\"94.237.40.9\"\r\n\u00a0\u00a0]\r\n}<\/pre>\r\n\r\n\r\n\r\n
Network interfaces and DNS addresses configured to the server<\/p>\r\n\r\n\r\n\r\n
Storage<\/h4>\r\n\r\n\r\n\r\n
\"storage\": {\r\n\u00a0\u00a0\"disks\": [\r\n\u00a0\u00a0\u00a0\u00a0{\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"id\": \"0187b8c5-7220-4c90-9026-047dff8be0b3\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"serial\": \"0187b8c572204c909026\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"size\": 25,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"type\": \"disk\",\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\"tier\": \"maxiops\"\r\n\u00a0\u00a0\u00a0\u00a0}\r\n\u00a0\u00a0]\r\n}<\/pre>\r\n\r\n\r\n\r\n
All storage devices attached to the server<\/p>\r\n\r\n\r\n\r\n
Tags<\/h4>\r\n\r\n\r\n\r\n
\"tags\": [\r\n\u00a0\u00a0\"dev\",\r\n\u00a0\u00a0\"metadata\"\r\n]<\/pre>\r\n\r\n\r\n\r\n
User-defined tags assigned to the Cloud Server<\/p>\r\n\r\n\r\n\r\n
User data<\/h4>\r\n\r\n\r\n\r\n
\"user_data\": \"apt-get update && apt-get -y upgrade\"<\/pre>\r\n\r\n\r\n\r\n
Deployment script or script URL<\/p>\r\n\r\n\r\n\r\n
Vendor data<\/h4>\r\n\r\n\r\n\r\n
\"vendor_data\": \"\"<\/pre>\r\n\r\n\r\n\r\n
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>\r\n\r\n\r\n\r\n
http:\/\/169.254.169.254\/metadata\/v1\/network\/interfaces\/1\/ip_addresses\/0\/address<\/pre>\r\n\r\n\r\n\r\n
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>\r\n\r\n\r\n\r\n
94.237.90.209<\/pre>\r\n\r\n\r\n\r\n
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>\r\n\r\n\r\n\r\n
Data centres<\/h2>\r\n\r\n\r\n\r\n
UpCloud runs data centres around the world to provide our users with a wide variety of regions and locations.<\/p>\r\n\r\n\r\n\r\n
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>\r\n\r\n\r\n\r\n
Available locations<\/h3>\r\n\r\n\r\n\r\n
We currently offer data centres in the following locations:<\/p>\r\n\r\n\r\n\r\n
Europe<\/p>\r\n\r\n\r\n\r\n
\r\n
DE-FRA1 – Frankfurt, Germany<\/li>\r\n\r\n\r\n\r\n
FI-HEL1 – Helsinki, Finland<\/li>\r\n\r\n\r\n\r\n
FI-HEL2 – Helsinki, Finland<\/li>\r\n\r\n\r\n\r\n
ES-MAD1 – Madrid, Spain<\/li>\r\n\r\n\r\n\r\n
NL-AMS1 – Amsterdam, Netherlands<\/li>\r\n\r\n\r\n\r\n
PL-WAW1 – Warsaw, Poland<\/li>\r\n\r\n\r\n\r\n
UK-LON1 – London, UK<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
Asia-Pacific<\/p>\r\n\r\n\r\n\r\n
\r\n
AU-SYD1 – Sydney, Australia<\/li>\r\n\r\n\r\n\r\n
SG-SIN1 – Singapore, Singapore<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
North America<\/p>\r\n\r\n\r\n\r\n
\r\n
US-CHI1 – Chicago, USA<\/li>\r\n\r\n\r\n\r\n
US-NYC1 – New York City, USA<\/li>\r\n\r\n\r\n\r\n
US-SJO1 – San Jose, USA<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n
New locations are added as we grow our infrastructure.<\/p>\r\n\r\n\r\n\r\n
Different pricing in certain locations<\/h3>\r\n\r\n\r\n\r\n
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>\r\n\r\n\r\n\r\n
Computation backend<\/h2>\r\n\r\n\r\n\r\n
UpCloud is built on the principles of speed and reliability by employing the latest technologies and hardware.<\/p>\r\n\r\n\r\n\r\n
Automated failover<\/h3>\r\n\r\n\r\n\r\n
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>\r\n\r\n\r\n\r\n
Virtualisation<\/h3>\r\n\r\n\r\n\r\n
We use the true and tested Linux Kernel-based Virtual Machine, or KVM, virtualisation module to provide hardware-assisted virtualisation.<\/p>\r\n\r\n\r\n\r\n
CPU<\/h3>\r\n\r\n\r\n\r\n
We use top-of-the-range hardware at every one of our data centres, including high-powered enterprise-grade processors.<\/p>\r\n\r\n\r\n\r\n
Automated balancing<\/h3>\r\n\r\n\r\n\r\n
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>\r\n","protected":false},"featured_media":1141,"template":"","documentation_category":[],"class_list":["post-34894","documentation","type-documentation","status-publish","has-post-thumbnail","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/documentation\/34894","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/types\/documentation"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/media\/1141"}],"wp:attachment":[{"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/media?parent=34894"}],"wp:term":[{"taxonomy":"documentation_category","embeddable":true,"href":"https:\/\/studiogo.tech\/upcloudold\/wp-json\/wp\/v2\/documentation_category?post=34894"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}