Download OpenAPI specification:Download
Most of the endpoints require authentication. Authenticating is done with an Bearer Token in the Authorization
header.
curl -H 'Authorization: Bearer my_authentication_token'
Authentication tokens are used to identify the user your application is connecting to the Cherry Servers API on behalf of. Think of authentication tokens as permanent sessions—the user creates authentication tokens, and your app can use them to connect to the API on their behalf until they delete the token.
Users can create authentication tokens in the Cherry Server client portal.
Communicate with the API by making an HTTP request at the correct endpoint. The chosen method determines the action taken.
GET | To retrieve information about a resource, use the GET method. The data is returned as a JSON object. GET methods are read-only and do not affect any resources. |
POST | Issue a POST method to create a new object. Include all needed attributes in the request body encoded as JSON. |
PATCH | Some resources support partial modification with PATCH, which modifies specific attributes without updating the entire object representation. |
PUT | Use the PUT method to update information about a resource. PUT will set new values on the item without regard to their current values. |
DELETE | Use the DELETE method to destroy a resource in your account. If it is not found, the operation will return a 4xx error and an appropriate message. |
Rate Limit: Cherry Servers safeguards the API against bursts of incoming traffic based on the request's IP address to ensure stability for all users. If your application sends more than 4 requests per second, the API may return HTTP status code 429.
Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, a charge failed, etc.). Codes in the 5xx range indicate an error with internal servers.
200, 201, 204 | Everything worked as expexted. |
400 | Bad parameters or request can't be made. |
401 | No valid API key provided. |
403 | Insufficient permissions to access resource. |
404 | Resource doesn't exist. |
500 | Internal error. Something went wrong in our side. |
List parameters:
Limit Ofset X-Total-Count header
More params:
query parameter fields
serverId required | string |
fields required | string Default: "server,href,specs,plan,pricing,ip,region,bmc,software,vlan,storage,bgp,id,name" |
type required | string Type of action |
image | string
|
hostname | string <HostnameConstraint> Only for |
password | string <PasswordConstraint> Only for |
plan | string Object |
plan_id | integer\d+ Deprecated Only for |
ssh_keys required | Array of integers Default: [] List of ssh keys |
os_partition_size | integer <OsPartitionSizeConstraint> Only for |
os_disk | string <OsDiskConstraint> Only for |
os_raid_level | string <OsRaidLevelConstraint> Only for |
user_data required | string <UserDataConstraint> Default: "" Base64 encoded User-Data blob. It should be either bash or cloud-config script |
allowed_ip | string Default: "" Only for |
{- "type": "string",
- "image": "string",
- "hostname": "string",
- "password": "string",
- "plan": "string",
- "plan_id": 0,
- "ssh_keys": [ ],
- "os_partition_size": 0,
- "os_disk": "string",
- "os_raid_level": "string",
- "user_data": "",
- "allowed_ip": ""
}
{- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "password": "string",
- "ip": "string",
- "allowed_ip": "string",
- "expires": "string",
- "user": "kuser"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": {
- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}, - "software": {
- "addons": { }
}, - "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "href": "string",
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "vlan": 0,
- "storage": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}, - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": {
- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string"
}, - "backup_storage": {
- "id": 0,
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}
serverId required | string |
fields required | string Default: "server,href,specs,plan,pricing,ip,region,bmc,software,vlan,storage,bgp,id,name,os_raid_level,os_disk" |
{- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "password": "string",
- "ip": "string",
- "allowed_ip": "string",
- "expires": "string",
- "user": "kuser"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": {
- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}, - "software": {
- "addons": { }
}, - "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "href": "string",
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "vlan": 0,
- "storage": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}, - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": {
- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string"
}, - "backup_storage": {
- "id": 0,
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}
serverId required | string |
fields required | string Default: "server,href,specs,plan,pricing,region,software,vlan,storage,bgp,id" |
name | string |
hostname | string <HostnameConstraint> |
tags | string <TagsConstraint> Object |
bgp | boolean True to enable BGP or false to disable. |
enable_ipv6 | string <IPv6ChangeStateConstraint> |
{- "name": "string",
- "hostname": "string",
- "tags": "string",
- "bgp": true,
- "enable_ipv6": "string"
}
{- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": { },
- "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": {
- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}, - "software": {
- "addons": { }
}, - "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "href": "string",
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "vlan": 0,
- "storage": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}, - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": {
- "id": 0,
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string"
}, - "backup_storage": {
- "id": 0,
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}
projectId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
bgp_status | array<string> |
bgp_enabled | boolean |
bgp_available | boolean |
bgp_active | boolean |
bgp_connected | boolean |
backup_storage_activated | boolean |
state | array<string> |
status | array<string> |
search | string Search by public IP address or hostname |
fields required | string Default: "server,href,specs,plan,pricing,ip,region,software,vlan,storage,bgp,id,name" |
[- {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": {
- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}, - "software": {
- "addons": { }
}, - "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "href": "string",
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "vlan": 0,
- "storage": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}, - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": {
- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string"
}, - "backup_storage": {
- "id": 0,
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}
]
projectId required | string |
fields required | string Default: "server,href,specs,plan,pricing,region,software,vlan,storage,bgp,id" |
plan_id | integer <PlanIdConstraint> Deprecated |
plan required | string object |
image | string <ServerImageConstraint> object |
os_partition_size | integer <OsPartitionSizeConstraint> |
region required | string <RegionConstraint>
|
hostname | string <HostnameConstraint> Default: "" |
ssh_keys | Array of integers Default: [] List of ssh keys |
ip_addresses | Array of strings Default: [] List of ip addresses |
addons | Array of integers Deprecated Default: [] List of addons |
variant_ids | Array of integers Default: [] List of custom variants |
user_data | string <UserDataConstraint> Base64 encoded User-Data blob. It should be either bash or cloud-config script |
tags | string <TagsConstraint> Object |
spot_market | integer|bool Default: false Request a server as a spot instance |
storage_id | integer Elastic block storage |
discount | string Default: "" Discount title |
{- "plan_id": 0,
- "plan": "string",
- "image": "string",
- "os_partition_size": 0,
- "region": "string",
- "hostname": "",
- "ssh_keys": [ ],
- "ip_addresses": [ ],
- "addons": [ ],
- "variant_ids": [ ],
- "user_data": "string",
- "tags": "string",
- "spot_market": false,
- "storage_id": 0,
- "discount": ""
}
{- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": { },
- "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": {
- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}, - "software": {
- "addons": { }
}, - "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "href": "string",
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "vlan": 0,
- "storage": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}, - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": {
- "id": 0,
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string"
}, - "backup_storage": {
- "id": 0,
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}
When Spot Server termination process is initiated, termination_date
attribute will be changed from None to actual date, typically it will be two minutes before server termination to have time to finish your work.
serverId required | string |
{- "termination_date": "string"
}
serverId required | string |
fields required | string Default: "backup,server,plan,region,pricing,ip" |
slug required | string Backup storage plan |
ssh_key | string <SshKeyConstraint> Public SSH key. |
region required | string Default: "eu_nord_1"
|
{- "slug": "string",
- "ssh_key": "string",
- "region": "eu_nord_1"
}
{- "id": 0,
- "status": "string",
- "state": "string",
- "private_ip": "string",
- "public_ip": "string",
- "size_gigabytes": 0,
- "used_gigabytes": 0,
- "methods": [
- {
- "password": "string",
- "name": "string",
- "host": "string",
- "port": 0,
- "username": "string",
- "whitelist": { },
- "ssh_key": "string",
- "enabled": true,
- "processing": true
}
], - "rules": [
- {
- "ip": { },
- "methods": { }
}
], - "available_addresses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": { },
- "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": { },
- "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": { },
- "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}
], - "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "attached_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": { },
- "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "upgradable": true,
- "href": "string"
}
backupStorageId required | string |
fields required | string Default: "backup,server,plan,pricing,ip,region" |
{- "id": 0,
- "status": "string",
- "state": "string",
- "private_ip": "string",
- "public_ip": "string",
- "size_gigabytes": 0,
- "used_gigabytes": 0,
- "methods": [
- {
- "password": "string",
- "name": "string",
- "host": "string",
- "port": 0,
- "username": "string",
- "whitelist": { },
- "ssh_key": "string",
- "enabled": true,
- "processing": true
}
], - "rules": [
- {
- "ip": { },
- "methods": { }
}
], - "available_addresses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": { },
- "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": { },
- "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": { },
- "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}
], - "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "attached_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": { },
- "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "upgradable": true,
- "href": "string"
}
backupStorageId required | string |
fields required | string Default: "backup,server,plan,pricing,ip,region" |
slug | string Slug of backup plan upgrade to |
password | string <PasswordConstraint> Change backup access method user password. |
ssh_key | string <SshKeyConstraint> Change backup access method ssh key. |
{- "slug": "string",
- "password": "string",
- "ssh_key": "string"
}
backupStorageId required | string |
method required | string |
fields required | string Default: "backup" |
enabled | boolean True to enable or false to disable. |
whitelist | Array of strings A list of IP addresses. |
ssh_key | string <SshKeyConstraint> |
{- "enabled": true,
- "whitelist": [
- "string"
], - "ssh_key": "string"
}
The request will retrieve all Load Balancers in a specified project.
projectId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
This request will create a new Load Balancer.
projectId required | string |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
name | string |
slug required | string <BalancerPlanSlugConstraint> |
region required | string Default: "eu_nord_1" |
cycle_id required | string <CycleIdConstraint> Default: 37 |
{- "name": "string",
- "slug": "string",
- "region": "eu_nord_1",
- "cycle_id": 37
}
{- "id": 0,
- "name": "string",
- "hostname": "string",
- "state": "string",
- "status": "string",
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "attributes": { }
}, - "href": "string",
- "servers": { },
- "rules": { },
- "ip_addresses": { },
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "backends": { },
- "metrics": { },
- "primary_ip_address": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": { },
- "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}, - "sticky_cookie": "string",
- "sticky_enabled": true,
- "https_redirect_enabled": true,
- "proxy_enabled": true,
- "certificates": { },
- "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "health_check": {
- "enabled": true,
- "path": "string",
- "interval": 0,
- "healthy_threshold": 0,
- "unhealthy_threshold": 0
}
}
The request will retrieve an existing Load Balancer object.
loadBalancerId required | string |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
{- "id": 0,
- "name": "string",
- "hostname": "string",
- "state": "string",
- "status": "string",
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "attributes": { }
}, - "href": "string",
- "servers": { },
- "rules": { },
- "ip_addresses": { },
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "backends": { },
- "metrics": { },
- "primary_ip_address": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": { },
- "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}, - "sticky_cookie": "string",
- "sticky_enabled": true,
- "https_redirect_enabled": true,
- "proxy_enabled": true,
- "certificates": { },
- "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "health_check": {
- "enabled": true,
- "path": "string",
- "interval": 0,
- "healthy_threshold": 0,
- "unhealthy_threshold": 0
}
}
The request will update an existing Load Balancer object.
loadBalancerId required | string |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
name | string |
slug | string <BalancerPlanSlugConstraint> |
sticky_cookie | string |
sticky_enabled | string |
https_redirect_enabled | string |
proxy_enabled | string |
health_check_enabled | string |
health_check_path | string.+ |
health_check_interval | string\d+ |
healthy_threshold | string\d+ |
unhealthy_threshold | string\d+ |
{- "name": "string",
- "slug": "string",
- "sticky_cookie": "string",
- "sticky_enabled": "string",
- "https_redirect_enabled": "string",
- "proxy_enabled": "string",
- "health_check_enabled": "string",
- "health_check_path": "string",
- "health_check_interval": "string",
- "healthy_threshold": "string",
- "unhealthy_threshold": "string"
}
{- "id": 0,
- "name": "string",
- "hostname": "string",
- "state": "string",
- "status": "string",
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "attributes": { }
}, - "href": "string",
- "servers": { },
- "rules": { },
- "ip_addresses": { },
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "backends": { },
- "metrics": { },
- "primary_ip_address": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": { },
- "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}, - "sticky_cookie": "string",
- "sticky_enabled": true,
- "https_redirect_enabled": true,
- "proxy_enabled": true,
- "certificates": { },
- "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "health_check": {
- "enabled": true,
- "path": "string",
- "interval": 0,
- "healthy_threshold": 0,
- "unhealthy_threshold": 0
}
}
This endpoint allows you to perform various actions on a Load Balancer object, such as resetting it.
loadBalancerId required | string |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
type required | stringreset Type of action |
{- "type": "string"
}
{- "id": 0,
- "name": "string",
- "hostname": "string",
- "state": "string",
- "status": "string",
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "attributes": { }
}, - "href": "string",
- "servers": { },
- "rules": { },
- "ip_addresses": { },
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "backends": { },
- "metrics": { },
- "primary_ip_address": {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": { },
- "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "plan": {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "ip_addresses": { },
- "ssh_keys": [
- { }
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7"
}, - "upgradable_note": "string",
- "project": { },
- "backup_storage": {
- "plan": {
- "id": 0,
- "name": "string",
- "slug": "string",
- "size_gigabytes": 0,
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
], - "href": "string",
- "disabled": true
}, - "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}, - "sticky_cookie": "string",
- "sticky_enabled": true,
- "https_redirect_enabled": true,
- "proxy_enabled": true,
- "certificates": { },
- "pricing": {
- "id": 0,
- "currency": "string",
- "unit": "string",
- "unit_price": 0,
- "discount": 0,
- "discount_percentage": true,
- "price_subtotal": 0,
- "taxed": true,
- "price_total": 0,
- "price": 0
}, - "health_check": {
- "enabled": true,
- "path": "string",
- "interval": 0,
- "healthy_threshold": 0,
- "unhealthy_threshold": 0
}
}
This endpoint allows you to create the rules for a Load Balancer object.
loadBalancerId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "load_balancer,rule" |
source_port required | string^(?!(22|3000|5555|6666|666|5656)$)\d+$ |
source_protocol required | stringhttp|https|http2|tcp |
destination_port required | string\d+ |
destination_protocol required | stringtcp|http|https|http2 |
certificate_id | string |
balance required | stringroundrobin|static-rr|leastconn|source Default: "roundrobin" |
{- "source_port": "string",
- "source_protocol": "string",
- "destination_port": "string",
- "destination_protocol": "string",
- "certificate_id": "string",
- "balance": "roundrobin"
}
This request will retrieve a Load Balancer rule object by specified ID.
loadBalancerId required | string |
loadBalancerRuleId required | string |
fields required | string Default: "load_balancer,rule" |
{- "id": 0,
- "name": "string",
- "hostname": "string",
- "state": "string",
- "status": "string",
- "plan": { },
- "href": "string",
- "servers": { },
- "rules": { },
- "ip_addresses": { },
- "region": { },
- "backends": { },
- "metrics": { },
- "primary_ip_address": { },
- "sticky_cookie": "string",
- "sticky_enabled": true,
- "https_redirect_enabled": true,
- "proxy_enabled": true,
- "certificates": { },
- "pricing": { },
- "health_check": {
- "enabled": true,
- "path": "string",
- "interval": 0,
- "healthy_threshold": 0,
- "unhealthy_threshold": 0
}
}
The request provides you with a brief overview of the servers involved in the Load Balancer.
loadBalancerId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
This endpoint allows you to add a server to a Load Balancer object.
loadBalancerId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "load_balancer,server,ip,region,plan,pricing" |
server_id required | string |
server_weight required | string\d+ Default: 99 |
{- "server_id": "string",
- "server_weight": 99
}
This endpoint allows you to add SSL certificates to a Load Balancer object.
loadBalancerId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "load_balancer,certificate" |
key required | string |
certificate required | string |
{- "key": "string",
- "certificate": "string"
}
projectId required | string |
fields required | string Default: "bgp" |
enabled required | boolean Default: false True to enable or false to disable BGP in project. |
{- "enabled": false
}
{- "enabled": true,
- "local_asn": 0
}
serverId required | string |
fields required | string Default: "bgp" |
{- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}
serverId required | string |
fields required | string Default: "bgp" |
enabled required | boolean Default: false True to enable BGP or false to disable. |
{- "enabled": false
}
{- "enabled": true,
- "available": true,
- "status": "Not Supported",
- "routers": 0,
- "connected": 0,
- "limit": 0,
- "active": 0,
- "routes": [
- {
- "subnet": "127.0.0.1/32",
- "active": true,
- "router": "46.166.166.122",
- "age": "2019-08-24T14:15:22Z",
- "updated": "2019-08-24T14:15:22Z"
}
], - "updated": "2019-08-24T14:15:22Z"
}
Retrieve available operating systems without Bearer token
plan required | string Plan object |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "images,pricing" |
[- {
- "id": 0,
- "name": "CentOS 6 64bit",
- "slug": "centos_7",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true
}
]
}
]
plan required | string Plan object |
teamId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "images,pricing" |
[- {
- "id": 0,
- "name": "CentOS 6 64bit",
- "slug": "centos_7",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true
}
]
}
]
teamId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "invitation,href" |
[- {
- "id": 0,
- "href": "string",
- "invitee": "example@cherryservers.com",
- "message": "Lorem ipsum dolor sit amet.",
- "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "invited_by": {
- "href": "string"
}, - "team": {
- "href": "string"
}, - "roles": [
- "string"
], - "projects": [
- {
- "href": "string"
}
]
}
]
teamId required | string |
fields required | string Default: "invitation,href" |
email required | string |
message required | string Default: "" |
projects | Array of integers Default: [] List of accessible projects for invitee, leave empty for all projects |
required | Array of itemsROLE_ADMIN|ROLE_BILLING|ROLE_COLLABORATOR Default: ["ROLE_COLLABORATOR"] List of roles for invitee |
{- "email": "string",
- "message": "",
- "projects": [ ],
- "roles": [
- "ROLE_COLLABORATOR"
]
}
{- "id": 0,
- "href": "string",
- "invitee": "example@cherryservers.com",
- "message": "Lorem ipsum dolor sit amet.",
- "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "invited_by": {
- "href": "string"
}, - "team": {
- "href": "string"
}, - "roles": [
- "string"
], - "projects": [
- {
- "href": "string"
}
]
}
invitationId required | string |
fields required | string Default: "invitation,href" |
{- "id": 0,
- "href": "string",
- "invitee": "example@cherryservers.com",
- "message": "Lorem ipsum dolor sit amet.",
- "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "invited_by": {
- "href": "string"
}, - "team": {
- "href": "string"
}, - "roles": [
- "string"
], - "projects": [
- {
- "href": "string"
}
]
}
serverId required | string |
type | Array of strings Default: ["subnet","primary-ip","floating-ip","private-ip"] Items Enum: "subnet" "primary-ip" "floating-ip" "private-ip" Filter ips by given types |
status | Array of strings Default: ["assigned"] Items Enum: "available" "assigned" Filter ips by given status |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
address_family | integer4|6 |
fields required | string Default: "ip,href,region,id" |
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "href": "string"
}
]
serverId required | string |
fields required | string Default: "ip,href,id" |
ptr_record | string |
a_record | string |
aaaa_record | string <AAAARecordConstraint> |
ddos_scrubbing | boolean <AntiDDosConstraint> Deprecated |
region required | string |
tags | string <TagsConstraint> Object `{"key": "value", "key2": "value2"}`` |
{- "ptr_record": "string",
- "a_record": "string",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "region": "string",
- "tags": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "href": "string"
}, - "assigned_to": {
- "id": 0,
- "href": "string"
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string"
}, - "href": "string"
}
projectId required | string |
type | Array of strings Default: ["subnet","primary-ip","floating-ip","private-ip"] Items Enum: "subnet" "primary-ip" "floating-ip" "private-ip" Filter ips by given types |
status | Array of strings Default: ["assigned"] Items Enum: "available" "assigned" Filter ips by given status |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "ip,href,region,id" |
region | string |
tag | string |
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "href": "string"
}
]
projectId required | string |
fields required | string Default: "ip,href,id,region" |
region required | string Object |
routed_to | string^(?!.*^((?i)null|(?i)false|^0$)).* Subnet or server primary ip uuid |
assigned_to | integer^[1-9][0-9]* Server |
targeted_to | integer^[1-9][0-9]* Server |
ptr_record | string |
a_record | string |
aaaa_record | string <AAAARecordConstraint> |
ddos_scrubbing | boolean <AntiDDosConstraint> Deprecated |
tags | string <TagsConstraint> Object |
configure | string |
{- "region": "string",
- "routed_to": "string",
- "assigned_to": 0,
- "targeted_to": 0,
- "ptr_record": "string",
- "a_record": "string",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": "string",
- "configure": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "href": "string"
}
ipId required | string |
fields required | string Default: "ip,href,region,server,id" |
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": { },
- "upgradable_note": "string",
- "project": {
- "id": 0,
- "href": "string"
}, - "backup_storage": {
- "id": 0,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": { },
- "upgradable_note": "string",
- "project": {
- "id": 0,
- "href": "string"
}, - "backup_storage": {
- "id": 0,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}
Floating ip addresses can be routed_to
server primary ip address or subnet ip address.
Subnet ip addresses can be assigned_to
servers.
ipId required | string |
fields required | string Default: "ip,href,id,region,server" |
routed_to | string^(?!.*^((?i)null|(?i)false|^0$)).* Subnet or server primary ip uuid |
assigned_to | integer^[1-9][0-9]* Server |
targeted_to | integer^[1-9][0-9]* Server |
ptr_record | string <PtrRecordConstraint> |
a_record | string <ARecordConstraint> |
aaaa_record | string <AAAARecordConstraint> |
tags | string <TagsConstraint> Object |
configure | string |
{- "routed_to": "string",
- "assigned_to": 0,
- "targeted_to": 0,
- "ptr_record": "string",
- "a_record": "string",
- "aaaa_record": "string",
- "tags": "string",
- "configure": "string"
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": { },
- "upgradable_note": "string",
- "project": {
- "id": 0,
- "href": "string"
}, - "backup_storage": {
- "id": 0,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": { },
- "upgradable_note": "string",
- "project": {
- "id": 0,
- "href": "string"
}, - "backup_storage": {
- "id": 0,
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}
projectId required | string |
fields required | string Default: "ip,href,region,id" |
region required | string |
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "href": "string"
}
]
subnetId required | string |
fields required | string Default: "ip,href,id,region" |
ip_address required | string |
configure required | string Default: false |
{- "ip_address": "string",
- "configure": false
}
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "assigned_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
}, - "href": "string"
}
teamId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "membership,href,project,user" |
[- {
- "id": 0,
- "href": "string",
- "roles": { },
- "user": {
- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "projects": [
- {
- "id": 0,
- "name": "My Project",
- "bgp": { },
- "project_memberships": [
- {
- "id": 0,
- "user": {
- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
}
], - "href": "string"
}
]
}
]
membershipId required | string |
fields required | string Default: "membership,href,project,user" |
{- "id": 0,
- "href": "string",
- "roles": { },
- "user": {
- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "projects": [
- {
- "id": 0,
- "name": "My Project",
- "bgp": { },
- "project_memberships": [
- {
- "id": 0,
- "user": {
- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
}
], - "href": "string"
}
]
}
Only members with ROLE_ADMIN can update a membership
membershipId required | string |
fields required | string Default: "membership,href,project,user" |
required | Array of itemsROLE_ADMIN|ROLE_BILLING|ROLE_COLLABORATOR List of roles for member |
projects required | Array of integers\d+ List of accessible projects |
{- "roles": [
- null
], - "projects": [
- 0
]
}
{- "id": 0,
- "href": "string",
- "roles": { },
- "user": {
- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "projects": [
- {
- "id": 0,
- "name": "My Project",
- "bgp": { },
- "project_memberships": [
- {
- "id": 0,
- "user": {
- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
}
], - "href": "string"
}
]
}
teamId required | string |
type | Array of strings Default: ["baremetal","virtual"] Items Enum: "baremetal" "virtual" Filter plans by given types |
region | string Filter plans by given region slug |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "plan,specs,pricing,region,softwares,software" |
[- {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "softwares": [
- {
- "image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
]
}, - "addons": { }
}
], - "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}
]
Retrieve plans without Bearer token
type required | Array of strings Default: ["baremetal","virtual"] Items Enum: "baremetal" "virtual" Filter plans by given types |
region | string Filter plans by given region slug |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "plan,specs,pricing,region,softwares,software" |
[- {
- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "softwares": [
- {
- "image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
]
}, - "addons": { }
}
], - "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}
]
Retrieve a plan without Bearer token
plan required | string Plan object |
fields required | string Default: "plan,specs,pricing,region,softwares,software" |
{- "id": 0,
- "href": "string",
- "name": "E3-1240v3",
- "slug": "e3_1240v3",
- "title": "E3-1240v3",
- "type": "baremetal",
- "category": "Dedicated resources",
- "softwares": [
- {
- "image": {
- "name": "CentOS 6 64bit",
- "slug": "centos_7",
- "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
]
}, - "addons": { }
}
], - "specs": {
- "vcpus": { },
- "cpus": { },
- "memory": { },
- "gpus": { },
- "storage": { },
- "raid": { },
- "nics": { },
- "bandwidth": { }
}, - "pricing": [
- {
- "id": 37,
- "unit": "Monthly",
- "price": 0,
- "currency": "EUR",
- "taxed": true,
- "left_to_pay": 0
}
], - "disabled": true,
- "available_regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "region_iso_2": "LT",
- "stock_qty": 0,
- "spot_qty": 0,
- "slug": "eu_nord_1",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}
teamId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "href,project,bgp,traffic" |
[- {
- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string",
- "traffic": [
- {
- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}
}
]
}
]
}
]
teamId required | string |
fields required | string Default: "href,project,bgp,traffic" |
name required | string^[\p{L}0-9'. _()-]*$ |
bgp | boolean True to enable BGP in project. |
{- "name": "string",
- "bgp": true
}
{- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string",
- "traffic": [
- {
- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}
}
]
}
]
}
projectId required | string |
fields required | string Default: "href,project,bgp,cidr,id,traffic" |
{- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string",
- "traffic": [
- {
- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}
}
]
}
]
}
projectId required | string |
fields required | string Default: "href,project,bgp,traffic" |
name | string^[\p{L}0-9'. _()-]*$ |
bgp | boolean True to enable BGP in project. |
{- "name": "string",
- "bgp": true
}
{- "id": 0,
- "name": "My Project",
- "bgp": {
- "enabled": true,
- "local_asn": 0
}, - "href": "string",
- "traffic": [
- {
- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}
}
]
}
]
}
Retrieve available regions without Bearer token
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "region,href" |
[- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
Retrieve a region without Bearer token
region required | string |
fields required | string Default: "region,href" |
{- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "ssh_key,href" |
[- {
- "id": 0,
- "label": "example",
- "key": "string",
- "fingerprint": "string",
- "user": {
- "href": "string",
- "ssh_keys": [
- { }
]
}, - "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "href": "string"
}
]
fields required | string Default: "ssh_key,href" |
label required | string <SshKeyLabelUniqueConstraint> |
key required | string |
{- "label": "string",
- "key": "string"
}
{- "id": 0,
- "label": "example",
- "key": "string",
- "fingerprint": "string",
- "user": {
- "href": "string",
- "ssh_keys": [
- { }
]
}, - "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "href": "string"
}
keyId required | string |
fields required | string Default: "ssh_key,href" |
{- "id": 0,
- "label": "example",
- "key": "string",
- "fingerprint": "string",
- "user": {
- "href": "string",
- "ssh_keys": [
- { }
]
}, - "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "href": "string"
}
keyId required | string |
fields required | string Default: "ssh_key,href" |
label | string <SshKeyLabelUniqueConstraint> |
key | string |
{- "label": "string",
- "key": "string"
}
{- "id": 0,
- "label": "example",
- "key": "string",
- "fingerprint": "string",
- "user": {
- "href": "string",
- "ssh_keys": [
- { }
]
}, - "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "href": "string"
}
serverId required | string |
fields required | string Default: "ssh_keys,href" |
{- "id": 0,
- "label": "example",
- "key": "string",
- "fingerprint": "string",
- "user": {
- "href": "string",
- "ssh_keys": [
- { }
]
}, - "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "href": "string"
}
projectId required | string |
fields required | string Default: "ssh_keys,href" |
{- "id": 0,
- "label": "example",
- "key": "string",
- "fingerprint": "string",
- "user": {
- "href": "string",
- "ssh_keys": [
- { }
]
}, - "updated": "2019-08-24T14:15:22Z",
- "created": "2019-08-24T14:15:22Z",
- "href": "string"
}
projectId required | string |
fields required | string Default: "storage,href,region" |
plan_id required | integer500 Default: "500" |
description | string^[\p{L}0-9'. _()-]*$ |
size required | integer^\d+$ Storage size in gigabytes |
region required | string |
{- "plan_id": "500",
- "description": "string",
- "size": 0,
- "region": "string"
}
{- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}
storageId required | string |
fields required | string Default: "id,storage,href,region,hostname" |
attach_to required | integer^\d+$ The server ID to which the storage volume will be attached |
{- "attach_to": 0
}
{- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}
Note: Storage volume size
can't be downgraded. After resize, new volume ID will be set
storageId required | string |
fields required | string Default: "id,storage,href,region,hostname" |
size | integer^\d+$ Storage size in gigabytes |
description | string^[\p{L}0-9'. _()-]*$ |
{- "size": 0,
- "description": "string"
}
{- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}
serverId required | string |
status | Array of strings Items Enum: "available" "attached" Filter ips by given status |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "id,storage,href,region,hostname" |
[- {
- "id": 0,
- "href": "string",
- "region": {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "href": "string",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}, - "size": 0,
- "allow_edit_size": true,
- "unit": "string",
- "description": "string",
- "vlan_id": "string",
- "vlan_ip": "string",
- "initiator": "string",
- "discovery_ip": "string"
}
]
projectId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
address_family | integer4|6 |
fields required | string Default: "subnet,href,id" |
[- {
- "id": 0,
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.1",
- "network_address": "127.0.0.1",
- "broadcast": "127.0.0.8",
- "netmask": "255.255.255.255",
- "vlan": 123,
- "region": {
- "id": 0,
- "href": "string"
}, - "addresses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "href": "string",
- "size": 0,
- "range": [
- "string"
], - "project": {
- "id": 0,
- "href": "string"
}
}
]
projectId required | string |
fields required | string Default: "subnet,href,id" |
quantity required | integer <SubnetQtyConstraint>
|
region required | string |
tags | string <TagsConstraint> Object |
{- "quantity": 0,
- "region": "string",
- "tags": "string"
}
{- "id": 0,
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.1",
- "network_address": "127.0.0.1",
- "broadcast": "127.0.0.8",
- "netmask": "255.255.255.255",
- "vlan": 123,
- "region": {
- "id": 0,
- "href": "string"
}, - "addresses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "href": "string",
- "size": 0,
- "range": [
- "string"
], - "project": {
- "id": 0,
- "href": "string"
}
}
subnetId required | string |
fields required | string Default: "subnet,href,id" |
tags | string <TagsConstraint> Object |
prefix | string(56|60|64) |
{- "tags": "string",
- "prefix": "string"
}
{- "id": 0,
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.1",
- "network_address": "127.0.0.1",
- "broadcast": "127.0.0.8",
- "netmask": "255.255.255.255",
- "vlan": 123,
- "region": {
- "id": 0,
- "href": "string"
}, - "addresses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "href": "string",
- "size": 0,
- "range": [
- "string"
], - "project": {
- "id": 0,
- "href": "string"
}
}
serverId required | string |
status | Array of strings Default: ["assigned"] Items Enum: "available" "assigned" Filter subnets by given status |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
address_family | integer4|6 |
fields required | string Default: "subnet,href,id" |
[- {
- "id": 0,
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.1",
- "network_address": "127.0.0.1",
- "broadcast": "127.0.0.8",
- "netmask": "255.255.255.255",
- "vlan": 123,
- "region": {
- "id": 0,
- "href": "string"
}, - "addresses": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "href": "string",
- "size": 0,
- "range": [
- "string"
], - "project": {
- "id": 0,
- "href": "string"
}
}
]
subnetId required | string |
fields required | string Default: "ip,href,server,id" |
ips_ids | Array of strings Multiple IPs |
server_id required | integer\d+ Server |
{- "ips_ids": [
- "string"
], - "server_id": 0
}
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "href": "string"
}, - "assigned_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "href": "string"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": { },
- "upgradable_note": "string",
- "project": {
- "id": 0,
- "href": "string"
}, - "backup_storage": {
- "id": 0,
- "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "name": "E3-1240v3",
- "href": "string",
- "bmc": {
- "ip": "string"
}, - "hostname": "localhost",
- "password": "p@$$wor&",
- "username": "root",
- "image": "string",
- "spot_instance": true,
- "region": {
- "id": 0,
- "href": "string"
}, - "state": "active",
- "status": "deploying",
- "bgp": { },
- "ip_addresses": { },
- "ssh_keys": [
- {
- "id": 0,
- "href": "string"
}
], - "tags": {
- "property1": "string",
- "property2": "string"
}, - "termination_date": "string",
- "upgradable": true,
- "created_at": "2019-08-24T14:15:22Z",
- "traffic_used_bytes": 0,
- "network": "string",
- "deployed_image": { },
- "upgradable_note": "string",
- "project": {
- "id": 0,
- "href": "string"
}, - "backup_storage": {
- "id": 0,
- "href": "string"
}, - "os_raid_level": "string",
- "os_disk": "string",
- "bandwidth_speed_mbps": { }
}, - "href": "string"
}
]
subnetId required | string |
fields required | string Default: "ip,href,id" |
ips_ids | Array of strings Multiple IPs |
{- "ips_ids": [
- "string"
]
}
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "address": "127.0.0.1",
- "address_family": 4,
- "cidr": "127.0.0.0/27",
- "gateway": "127.0.0.0",
- "type": "floating-ip",
- "region": {
- "id": 0,
- "href": "string"
}, - "assigned_to": {
- "id": 0,
- "href": "string"
}, - "ptr_record": "example.cherryservers.com",
- "a_record": "example",
- "aaaa_record": "string",
- "ddos_scrubbing": true,
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "project": {
- "id": 0,
- "href": "string"
}, - "targeted_to": {
- "id": 0,
- "href": "string"
}, - "href": "string"
}
]
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "team" |
[- {
- "id": 0,
- "name": "My Team",
- "credit": {
- "account": { },
- "promo": { },
- "resources": { }
}, - "billing": {
- "type": "personal",
- "company_name": "My Company",
- "company_code": "string",
- "first_name": "Johnny",
- "last_name": "Bravo",
- "address_1": "string",
- "address_2": "string",
- "country_iso_2": "string",
- "city": "string",
- "vat": {
- "amount": 0,
- "number": "string",
- "valid": true
}, - "cc_verified": true,
- "state": "string",
- "currency": "EUR",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "href": "string"
}
]
fields required | string Default: "team" |
name required | string^[\p{L}0-9'. _()-]*$ |
company_name | string Default: "" |
company_code | string Default: "" |
vat_number | string Default: "" |
first_name | string Default: "" |
last_name | string Default: "" |
address_1 | string Default: "" |
address_2 | string Default: "" |
country_iso_2 | string <CountryConstraint> |
city | string Default: "" |
state | string <OrganizationCountryStateConstraint> |
type required | stringbusiness|personal Default: "personal" |
currency | stringUSD|EUR |
date_of_birth | string |
national_id_number | string |
{- "name": "string",
- "company_name": "",
- "company_code": "",
- "vat_number": "",
- "first_name": "",
- "last_name": "",
- "address_1": "",
- "address_2": "",
- "country_iso_2": "string",
- "city": "",
- "state": "string",
- "type": "personal",
- "currency": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
{- "id": 0,
- "name": "My Team",
- "credit": {
- "account": { },
- "promo": { },
- "resources": { }
}, - "billing": {
- "type": "personal",
- "company_name": "My Company",
- "company_code": "string",
- "first_name": "Johnny",
- "last_name": "Bravo",
- "address_1": "string",
- "address_2": "string",
- "country_iso_2": "string",
- "city": "string",
- "vat": {
- "amount": 0,
- "number": "string",
- "valid": true
}, - "cc_verified": true,
- "state": "string",
- "currency": "EUR",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "href": "string"
}
teamId required | string |
fields required | string Default: "team" |
{- "id": 0,
- "name": "My Team",
- "credit": {
- "account": { },
- "promo": { },
- "resources": { }
}, - "billing": {
- "type": "personal",
- "company_name": "My Company",
- "company_code": "string",
- "first_name": "Johnny",
- "last_name": "Bravo",
- "address_1": "string",
- "address_2": "string",
- "country_iso_2": "string",
- "city": "string",
- "vat": {
- "amount": 0,
- "number": "string",
- "valid": true
}, - "cc_verified": true,
- "state": "string",
- "currency": "EUR",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "href": "string"
}
teamId required | string |
fields required | string Default: "team" |
name | string^[\p{L}0-9'. _()-]*$ |
company_name | string |
company_code | string |
vat_number | string |
first_name | string |
last_name | string |
address_1 | string |
address_2 | string |
country_iso_2 | string <CountryConstraint> |
city | string |
state | string <OrganizationCountryStateConstraint> |
type | stringbusiness|personal |
currency | stringUSD|EUR |
date_of_birth | string |
national_id_number | string |
{- "name": "string",
- "company_name": "string",
- "company_code": "string",
- "vat_number": "string",
- "first_name": "string",
- "last_name": "string",
- "address_1": "string",
- "address_2": "string",
- "country_iso_2": "string",
- "city": "string",
- "state": "string",
- "type": "string",
- "currency": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
{- "id": 0,
- "name": "My Team",
- "credit": {
- "account": { },
- "promo": { },
- "resources": { }
}, - "billing": {
- "type": "personal",
- "company_name": "My Company",
- "company_code": "string",
- "first_name": "Johnny",
- "last_name": "Bravo",
- "address_1": "string",
- "address_2": "string",
- "country_iso_2": "string",
- "city": "string",
- "vat": {
- "amount": 0,
- "number": "string",
- "valid": true
}, - "cc_verified": true,
- "state": "string",
- "currency": "EUR",
- "date_of_birth": "string",
- "national_id_number": "string"
}, - "href": "string"
}
fields required | string Default: "token" |
label required | string |
{- "label": "string"
}
{- "token": "string",
- "id": 0,
- "href": "string",
- "label": "string"
}
tokenId required | string |
fields required | string Default: "token" |
label required | string |
{- "label": "string"
}
{- "token": "string",
- "id": 0,
- "href": "string",
- "label": "string"
}
projectId required | string |
limit | integer\d+ Default: 0 |
offset | integer\d+ Default: 0 |
fields required | string Default: "traffic,region" |
[- {
- "traffic": [
- {
- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}
]
}
]
trafficId required | string |
fields required | string Default: "traffic,region" |
{- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}
trafficId required | string |
fields required | string Default: "traffic,region" |
adjust required | integer\d+ How many traffic is needed in terabytes. |
{- "adjust": 0
}
{- "id": "string",
- "used_bytes": 0,
- "allowance_bytes": 0,
- "limited_bytes": 0,
- "name": "string",
- "regions": [
- {
- "id": 0,
- "name": "EU-Nord-1",
- "slug": "eu_nord_1",
- "region_iso_2": "LT",
- "bgp": {
- "hosts": [
- "127.0.0.1"
], - "asn": 0
}, - "location": "Lithuania, Vilnius"
}
]
}
fields required | string Default: "user" |
{- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
userId required | string |
fields | string Default: "user" |
{- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
userId required | string |
fields | string Default: "user" |
first_name | string |
last_name | string |
string^[a-zA-Z0-9_.\+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-... | |
phone | string^(\+?[0-9])*$ |
skype_username | string |
linkedin_profile | string |
country_iso_2 required | string <CountryConstraint> |
state | string <UserCountryStateConstraint> |
city | string |
address_1 | string |
address_2 | string |
date_of_birth | string |
national_id_number | string |
{- "first_name": "string",
- "last_name": "string",
- "email": "string",
- "phone": "string",
- "skype_username": "string",
- "linkedin_profile": "string",
- "country_iso_2": "string",
- "state": "string",
- "city": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}
{- "id": 0,
- "first_name": "Johnny",
- "last_name": "Bravo",
- "email": "example@cherryservers.com",
- "email_verified": true,
- "phone": "37060000000",
- "security_phone_verified": true,
- "state": "string",
- "city": "string",
- "country_iso_2": "string",
- "href": "string",
- "security_phone": "37060000000",
- "skype_username": "string",
- "linkedin_profile": "string",
- "address_1": "string",
- "address_2": "string",
- "date_of_birth": "string",
- "national_id_number": "string"
}