---
title: "Cloud servers"
description: "Hourly cloud servers in Istanbul, Europe, US and Singapore: create, power, rebuild, snapshots, disks, IPs, firewall, templates and one-click apps."
url: https://www.gyrohosting.com/developers/en/products/compute.html
language: en
openapi: https://www.gyrohosting.com/developers/openapi.json
api_version: 2.30.0
---

# Cloud servers

Hourly cloud servers in Istanbul, Europe, US and Singapore: create, power, rebuild, snapshots, disks, IPs, firewall, templates and one-click apps.


## How-to guides

- [Create a cloud server](https://www.gyrohosting.com/developers/en/howto/create-server.md)
- [Money safety: dry run, confirm, idempotency](https://www.gyrohosting.com/developers/en/guides/money.md)
- [Asynchronous work and polling](https://www.gyrohosting.com/developers/en/guides/async.md)

## Servers

Cloud servers you own. Creating one places an order paid from your account balance.

- `GET /cloud/servers` — [List cloud servers](https://www.gyrohosting.com/developers/en/api/servers.md#listServers)
- `POST /cloud/servers` — [Create (order) a cloud server](https://www.gyrohosting.com/developers/en/api/servers.md#createServer)
- `GET /cloud/servers/{id}` — [Get a server with its live state](https://www.gyrohosting.com/developers/en/api/servers.md#getServer)
- `PATCH /cloud/servers/{id}` — [Rename a server or switch auto-renew](https://www.gyrohosting.com/developers/en/api/servers.md#updateServer)
- `DELETE /cloud/servers/{id}` — [Delete (cancel) a server](https://www.gyrohosting.com/developers/en/api/servers.md#deleteServer)
- `GET /cloud/servers/{id}/disks` — [List the server's additional disks](https://www.gyrohosting.com/developers/en/api/servers.md#listServerDisks)
- `POST /cloud/servers/{id}/disks` — [Add an additional disk](https://www.gyrohosting.com/developers/en/api/servers.md#addServerDisk)
- `PUT /cloud/servers/{id}/disks/{disk}` — [Grow an additional disk](https://www.gyrohosting.com/developers/en/api/servers.md#resizeServerDisk)
- `DELETE /cloud/servers/{id}/disks/{disk}` — [Remove an additional disk (with its data)](https://www.gyrohosting.com/developers/en/api/servers.md#removeServerDisk)

## Server actions

Power, rebuild, password and rescue operations. Asynchronous; poll the server until `live.locked` is false.

- `POST /cloud/servers/{id}/actions/{action}` — [Run a server action](https://www.gyrohosting.com/developers/en/api/server-actions.md#serverAction)
- `POST /cloud/servers/{id}/console` — [Open a one-time VNC console ticket](https://www.gyrohosting.com/developers/en/api/server-actions.md#openConsole)
- `POST /cloud/bulk` — [Run one action on up to 50 servers](https://www.gyrohosting.com/developers/en/api/server-actions.md#bulkServerAction)

## Snapshots and backups

Point-in-time images of a server disk. Snapshot space is an add-on quota in GB.

- `GET /cloud/servers/{id}/snapshots` — [List snapshots and the snapshot quota](https://www.gyrohosting.com/developers/en/api/snapshots-and-backups.md#listSnapshots)
- `POST /cloud/servers/{id}/snapshots` — [Take a snapshot](https://www.gyrohosting.com/developers/en/api/snapshots-and-backups.md#createSnapshot)
- `POST /cloud/servers/{id}/snapshots/{sid}/restore` — [Restore a snapshot onto the server (overwrites the disk)](https://www.gyrohosting.com/developers/en/api/snapshots-and-backups.md#restoreSnapshot)
- `DELETE /cloud/servers/{id}/snapshots/{sid}` — [Delete a snapshot](https://www.gyrohosting.com/developers/en/api/snapshots-and-backups.md#deleteSnapshot)
- `GET /cloud/servers/{id}/backups` — [List automatic backups](https://www.gyrohosting.com/developers/en/api/snapshots-and-backups.md#listBackups)
- `POST /cloud/servers/{id}/backups` — [Take a manual backup (backup add-on required)](https://www.gyrohosting.com/developers/en/api/snapshots-and-backups.md#createBackup)

## Networking

Reverse DNS and the inbound firewall of a server.

- `GET /cloud/servers/{id}/rdns` — [List reverse DNS entries](https://www.gyrohosting.com/developers/en/api/networking.md#listRdns)
- `PUT /cloud/servers/{id}/rdns` — [Set (or reset) the PTR record of one address](https://www.gyrohosting.com/developers/en/api/networking.md#setRdns)
- `GET /cloud/servers/{id}/firewall` — [Inbound firewall rules](https://www.gyrohosting.com/developers/en/api/networking.md#getFirewall)
- `POST /cloud/servers/{id}/firewall/rules` — [Add a firewall rule](https://www.gyrohosting.com/developers/en/api/networking.md#addFirewallRule)
- `DELETE /cloud/servers/{id}/firewall/rules/{n}` — [Remove a firewall rule (the last one needs confirm)](https://www.gyrohosting.com/developers/en/api/networking.md#deleteFirewallRule)
- `GET /cloud/servers/{id}/firewall/policy` — [Network firewall policy (rules, default action, status)](https://www.gyrohosting.com/developers/en/api/networking.md#getFirewallPolicy)
- `PUT /cloud/servers/{id}/firewall/policy` — [Replace the network firewall policy](https://www.gyrohosting.com/developers/en/api/networking.md#putFirewallPolicy)
- `DELETE /cloud/servers/{id}/firewall/policy` — [Remove your firewall rules](https://www.gyrohosting.com/developers/en/api/networking.md#deleteFirewallPolicy)
- `POST /cloud/servers/{id}/firewall/policy/confirm` — [Make the running firewall trial permanent](https://www.gyrohosting.com/developers/en/api/networking.md#confirmFirewallPolicy)
- `GET /cloud/servers/{id}/ips` — [List the server's IPv4 addresses](https://www.gyrohosting.com/developers/en/api/networking.md#listServerIps)
- `POST /cloud/servers/{id}/ips` — [Add additional IPv4 addresses](https://www.gyrohosting.com/developers/en/api/networking.md#addServerIps)
- `DELETE /cloud/servers/{id}/ips/{ip}` — [Release an additional IPv4 address](https://www.gyrohosting.com/developers/en/api/networking.md#removeServerIp)

## Monitoring

CPU, disk and network metrics and the provider-side action history.

- `GET /cloud/servers/{id}/metrics` — [CPU, disk and network time series](https://www.gyrohosting.com/developers/en/api/monitoring.md#getMetrics)
- `GET /cloud/servers/{id}/activity` — [Recent platform actions on the server](https://www.gyrohosting.com/developers/en/api/monitoring.md#serverActivity)

## SSH keys

Account-level public keys you can install on new servers.

- `GET /cloud/ssh-keys` — [List SSH keys](https://www.gyrohosting.com/developers/en/api/ssh-keys.md#listSshKeys)
- `POST /cloud/ssh-keys` — [Add an SSH key](https://www.gyrohosting.com/developers/en/api/ssh-keys.md#createSshKey)
- `GET /cloud/ssh-keys/{id}` — [Get an SSH key](https://www.gyrohosting.com/developers/en/api/ssh-keys.md#getSshKey)
- `DELETE /cloud/ssh-keys/{id}` — [Delete an SSH key](https://www.gyrohosting.com/developers/en/api/ssh-keys.md#deleteSshKey)

## Templates

Custom templates from your own tr-ist-1 servers (no image upload)

- `GET /cloud/templates` — [List your templates](https://www.gyrohosting.com/developers/en/api/templates.md#listTemplates)
- `GET /cloud/templates/{id}` — [Get a template](https://www.gyrohosting.com/developers/en/api/templates.md#getTemplate)
- `PATCH /cloud/templates/{id}` — [Rename a template](https://www.gyrohosting.com/developers/en/api/templates.md#updateTemplate)
- `DELETE /cloud/templates/{id}` — [Delete a template](https://www.gyrohosting.com/developers/en/api/templates.md#deleteTemplate)
- `POST /cloud/servers/{id}/templates` — [Capture a server as a template](https://www.gyrohosting.com/developers/en/api/templates.md#createTemplate)
- `POST /cloud/templates/{id}/servers` — [New server from a template](https://www.gyrohosting.com/developers/en/api/templates.md#createServerFromTemplate)
- `POST /cloud/templates/{id}/rebuild` — [Reinstall a server from a template](https://www.gyrohosting.com/developers/en/api/templates.md#rebuildFromTemplate)

## Security groups

Reusable allow lists (AWS security group model) for servers with the network firewall add-on. Up to 5 groups per server, evaluated after Gyro rules and your advanced ordered rules; with groups and no advanced rules inbound traffic is denied by default. Rules count against the server's rule allowance. A change that could cut SSH/RDP access runs as a 5 minute trial: confirm it.

- `GET /cloud/security-groups` — [List security groups](https://www.gyrohosting.com/developers/en/api/security-groups.md#listSecurityGroups)
- `POST /cloud/security-groups` — [Create a security group](https://www.gyrohosting.com/developers/en/api/security-groups.md#createSecurityGroup)
- `GET /cloud/security-groups/{sg}` — [Get a security group](https://www.gyrohosting.com/developers/en/api/security-groups.md#getSecurityGroup)
- `PATCH /cloud/security-groups/{sg}` — [Rename / describe a security group](https://www.gyrohosting.com/developers/en/api/security-groups.md#updateSecurityGroup)
- `DELETE /cloud/security-groups/{sg}` — [Delete a security group](https://www.gyrohosting.com/developers/en/api/security-groups.md#deleteSecurityGroup)
- `PUT /cloud/security-groups/{sg}/rules` — [Replace the rules of a security group](https://www.gyrohosting.com/developers/en/api/security-groups.md#putSecurityGroupRules)
- `POST /cloud/security-groups/{sg}/confirm` — [Make the running rule trial permanent](https://www.gyrohosting.com/developers/en/api/security-groups.md#confirmSecurityGroup)
- `GET /cloud/servers/{id}/security-groups` — [Security groups attached to a server](https://www.gyrohosting.com/developers/en/api/security-groups.md#listServerSecurityGroups)
- `PUT /cloud/servers/{id}/security-groups` — [Set the exact list of attached groups](https://www.gyrohosting.com/developers/en/api/security-groups.md#setServerSecurityGroups)
- `POST /cloud/servers/{id}/security-groups/{sg}` — [Attach a security group to a server](https://www.gyrohosting.com/developers/en/api/security-groups.md#attachSecurityGroup)
- `DELETE /cloud/servers/{id}/security-groups/{sg}` — [Detach a security group from a server](https://www.gyrohosting.com/developers/en/api/security-groups.md#detachSecurityGroup)

## One-click apps

Install a one-click app on a cloud server (the disk is rebuilt).

- `GET /cloud/apps` — [List installable apps](https://www.gyrohosting.com/developers/en/api/one-click-apps.md#listApps)
- `GET /cloud/servers/{id}/app` — [App install status (credentials shown once when ready)](https://www.gyrohosting.com/developers/en/api/one-click-apps.md#getAppInstall)
- `POST /cloud/servers/{id}/app` — [Install an app (rebuilds the disk; confirm required; 3 per server per day)](https://www.gyrohosting.com/developers/en/api/one-click-apps.md#installApp)
- `GET /cloud/servers/{id}/app/log` — [Live progress log of the latest app install (step changes, server log tail)](https://www.gyrohosting.com/developers/en/api/one-click-apps.md#getAppInstallLog)
- `POST /cloud/servers/{id}/app/retry` — [Retry a failed or silent app install (rebuilds the disk; confirm required; 3 per server per hour)](https://www.gyrohosting.com/developers/en/api/one-click-apps.md#retryAppInstall)

## Catalog

Orderable products, locations and operating system images.

- `GET /cloud/products` — [List orderable cloud server products](https://www.gyrohosting.com/developers/en/api/catalog.md#listProducts)
- `GET /cloud/locations` — [List locations with orderable products](https://www.gyrohosting.com/developers/en/api/catalog.md#listLocations)
- `GET /cloud/images` — [List operating system images](https://www.gyrohosting.com/developers/en/api/catalog.md#listImages)
- `GET /products` — [List products](https://www.gyrohosting.com/developers/en/api/catalog.md#coreGetProducts)
- `GET /products/categories` — [List product categories](https://www.gyrohosting.com/developers/en/api/catalog.md#coreGetProductCategories)
- `GET /products/{id}` — [Get product (path: {id})](https://www.gyrohosting.com/developers/en/api/catalog.md#coreGetProduct)