Transfer resources to another team
curl --request POST \
--url https://console.advinservers.com/api/v1/client/transfers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"moves": [
{
"resource": "server",
"uuids": [
"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b",
"304e1794-a5b7-41f2-9a20-c0d444eb6683"
]
},
{
"resource": "iso",
"uuids": [
"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b"
]
},
{
"resource": "firewall_group",
"uuids": [
"72a4a737-236f-456f-827f-6145d9c95727"
]
},
{
"resource": "firewall_ip_group",
"uuids": [
"145e6e6f-a6b0-4b9e-9060-2d4f017baff8"
]
},
{
"resource": "private_network",
"uuids": [
"5220f263-0e8e-4917-bf4f-4cae109ca4c5"
]
},
{
"resource": "floating_ip",
"uuids": [
"1b8349e5-3568-43e0-bf89-fc3350dd7a08"
]
}
],
"team": "48454223-c5ac-461f-bead-ba8dda13eea9"
}
'import requests
url = "https://console.advinservers.com/api/v1/client/transfers"
payload = {
"moves": [
{
"resource": "server",
"uuids": ["ecc6f4f1-c89b-4dce-a20b-a330641c5b0b", "304e1794-a5b7-41f2-9a20-c0d444eb6683"]
},
{
"resource": "iso",
"uuids": ["ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b"]
},
{
"resource": "firewall_group",
"uuids": ["72a4a737-236f-456f-827f-6145d9c95727"]
},
{
"resource": "firewall_ip_group",
"uuids": ["145e6e6f-a6b0-4b9e-9060-2d4f017baff8"]
},
{
"resource": "private_network",
"uuids": ["5220f263-0e8e-4917-bf4f-4cae109ca4c5"]
},
{
"resource": "floating_ip",
"uuids": ["1b8349e5-3568-43e0-bf89-fc3350dd7a08"]
}
],
"team": "48454223-c5ac-461f-bead-ba8dda13eea9"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
moves: [
{
resource: 'server',
uuids: ['ecc6f4f1-c89b-4dce-a20b-a330641c5b0b', '304e1794-a5b7-41f2-9a20-c0d444eb6683']
},
{resource: 'iso', uuids: ['ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b']},
{resource: 'firewall_group', uuids: ['72a4a737-236f-456f-827f-6145d9c95727']},
{resource: 'firewall_ip_group', uuids: ['145e6e6f-a6b0-4b9e-9060-2d4f017baff8']},
{resource: 'private_network', uuids: ['5220f263-0e8e-4917-bf4f-4cae109ca4c5']},
{resource: 'floating_ip', uuids: ['1b8349e5-3568-43e0-bf89-fc3350dd7a08']}
],
team: '48454223-c5ac-461f-bead-ba8dda13eea9'
})
};
fetch('https://console.advinservers.com/api/v1/client/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://console.advinservers.com/api/v1/client/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'moves' => [
[
'resource' => 'server',
'uuids' => [
'ecc6f4f1-c89b-4dce-a20b-a330641c5b0b',
'304e1794-a5b7-41f2-9a20-c0d444eb6683'
]
],
[
'resource' => 'iso',
'uuids' => [
'ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b'
]
],
[
'resource' => 'firewall_group',
'uuids' => [
'72a4a737-236f-456f-827f-6145d9c95727'
]
],
[
'resource' => 'firewall_ip_group',
'uuids' => [
'145e6e6f-a6b0-4b9e-9060-2d4f017baff8'
]
],
[
'resource' => 'private_network',
'uuids' => [
'5220f263-0e8e-4917-bf4f-4cae109ca4c5'
]
],
[
'resource' => 'floating_ip',
'uuids' => [
'1b8349e5-3568-43e0-bf89-fc3350dd7a08'
]
]
],
'team' => '48454223-c5ac-461f-bead-ba8dda13eea9'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://console.advinservers.com/api/v1/client/transfers"
payload := strings.NewReader("{\n \"moves\": [\n {\n \"resource\": \"server\",\n \"uuids\": [\n \"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b\",\n \"304e1794-a5b7-41f2-9a20-c0d444eb6683\"\n ]\n },\n {\n \"resource\": \"iso\",\n \"uuids\": [\n \"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b\"\n ]\n },\n {\n \"resource\": \"firewall_group\",\n \"uuids\": [\n \"72a4a737-236f-456f-827f-6145d9c95727\"\n ]\n },\n {\n \"resource\": \"firewall_ip_group\",\n \"uuids\": [\n \"145e6e6f-a6b0-4b9e-9060-2d4f017baff8\"\n ]\n },\n {\n \"resource\": \"private_network\",\n \"uuids\": [\n \"5220f263-0e8e-4917-bf4f-4cae109ca4c5\"\n ]\n },\n {\n \"resource\": \"floating_ip\",\n \"uuids\": [\n \"1b8349e5-3568-43e0-bf89-fc3350dd7a08\"\n ]\n }\n ],\n \"team\": \"48454223-c5ac-461f-bead-ba8dda13eea9\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://console.advinservers.com/api/v1/client/transfers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"moves\": [\n {\n \"resource\": \"server\",\n \"uuids\": [\n \"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b\",\n \"304e1794-a5b7-41f2-9a20-c0d444eb6683\"\n ]\n },\n {\n \"resource\": \"iso\",\n \"uuids\": [\n \"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b\"\n ]\n },\n {\n \"resource\": \"firewall_group\",\n \"uuids\": [\n \"72a4a737-236f-456f-827f-6145d9c95727\"\n ]\n },\n {\n \"resource\": \"firewall_ip_group\",\n \"uuids\": [\n \"145e6e6f-a6b0-4b9e-9060-2d4f017baff8\"\n ]\n },\n {\n \"resource\": \"private_network\",\n \"uuids\": [\n \"5220f263-0e8e-4917-bf4f-4cae109ca4c5\"\n ]\n },\n {\n \"resource\": \"floating_ip\",\n \"uuids\": [\n \"1b8349e5-3568-43e0-bf89-fc3350dd7a08\"\n ]\n }\n ],\n \"team\": \"48454223-c5ac-461f-bead-ba8dda13eea9\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"moves\": [\n {\n \"resource\": \"server\",\n \"uuids\": [\n \"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b\",\n \"304e1794-a5b7-41f2-9a20-c0d444eb6683\"\n ]\n },\n {\n \"resource\": \"iso\",\n \"uuids\": [\n \"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b\"\n ]\n },\n {\n \"resource\": \"firewall_group\",\n \"uuids\": [\n \"72a4a737-236f-456f-827f-6145d9c95727\"\n ]\n },\n {\n \"resource\": \"firewall_ip_group\",\n \"uuids\": [\n \"145e6e6f-a6b0-4b9e-9060-2d4f017baff8\"\n ]\n },\n {\n \"resource\": \"private_network\",\n \"uuids\": [\n \"5220f263-0e8e-4917-bf4f-4cae109ca4c5\"\n ]\n },\n {\n \"resource\": \"floating_ip\",\n \"uuids\": [\n \"1b8349e5-3568-43e0-bf89-fc3350dd7a08\"\n ]\n }\n ],\n \"team\": \"48454223-c5ac-461f-bead-ba8dda13eea9\"\n}"
response = http.request(request)
puts response.read_body{
"resource": null,
"resources": [
"server",
"iso",
"firewall_group",
"firewall_ip_group",
"private_network",
"floating_ip"
],
"moved": 7,
"team": {
"id": "48454223-c5ac-461f-bead-ba8dda13eea9",
"name": "Lambda Complex"
}
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "The name field is required.",
"errors": {}
}{
"message": "Too Many Attempts."
}Transfers
Transfer resources to another team
Overview
Moves resources from the current team to another team. Send the destination team’s UUID as team and a moves list with one {resource, uuids} entry per kind. Supported resources are server, ssh_key, user_script, iso, firewall_group, firewall_ip_group, private_network, floating_ip and snapshot_storage. Up to 100 resources can move in one request.
A floating IP attached to a server moves only with that server: list it in a floating_ip entry beside the server. Attached floating IPs left out of the list are detached from the server and stay in the current team, with their billing unchanged. A server’s primary address always moves with it. A detached floating IP can move on its own. A snapshot storage takes every snapshot in it along; a server’s snapshots stay in their storage.
Move attached resources together. For example, a server and its firewall group cannot move separately while attached. If anything in the list cannot move, nothing moves.
The permission needed depends on what moves: network.transfer for a floating IP moved on its own, snapshot.transfer for a snapshot storage, and server.transfer for a server (including the floating IPs listed with it) and every other kind.
A member working in another customer’s team can move one server with its chosen floating IPs, one detached floating IP or one snapshot storage onto their own account. Ownership changes require settled invoices for everything being transferred, matching billing currencies and enough address quota. Automatic payments are cancelled; shared subscriptions must be stopped first. The paid service period is kept. Ownership changes cannot be reversed through this endpoint. Moves between the account’s own teams keep billing and automatic payments unchanged.
The response names the kinds that moved (resource, or null when several kinds moved), the number of resources moved, including floating IPs listed with a server, and the destination team.
Permissions
Requires one of the server.transfer (Transfer servers to their own account), network.transfer (Transfer floating IPs to their own account) or snapshot.transfer (Transfer snapshot storage to their own account) permissions for the selected team, depending on the request. Resources outside that team return 404.
POST
/
transfers
Transfer resources to another team
curl --request POST \
--url https://console.advinservers.com/api/v1/client/transfers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"moves": [
{
"resource": "server",
"uuids": [
"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b",
"304e1794-a5b7-41f2-9a20-c0d444eb6683"
]
},
{
"resource": "iso",
"uuids": [
"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b"
]
},
{
"resource": "firewall_group",
"uuids": [
"72a4a737-236f-456f-827f-6145d9c95727"
]
},
{
"resource": "firewall_ip_group",
"uuids": [
"145e6e6f-a6b0-4b9e-9060-2d4f017baff8"
]
},
{
"resource": "private_network",
"uuids": [
"5220f263-0e8e-4917-bf4f-4cae109ca4c5"
]
},
{
"resource": "floating_ip",
"uuids": [
"1b8349e5-3568-43e0-bf89-fc3350dd7a08"
]
}
],
"team": "48454223-c5ac-461f-bead-ba8dda13eea9"
}
'import requests
url = "https://console.advinservers.com/api/v1/client/transfers"
payload = {
"moves": [
{
"resource": "server",
"uuids": ["ecc6f4f1-c89b-4dce-a20b-a330641c5b0b", "304e1794-a5b7-41f2-9a20-c0d444eb6683"]
},
{
"resource": "iso",
"uuids": ["ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b"]
},
{
"resource": "firewall_group",
"uuids": ["72a4a737-236f-456f-827f-6145d9c95727"]
},
{
"resource": "firewall_ip_group",
"uuids": ["145e6e6f-a6b0-4b9e-9060-2d4f017baff8"]
},
{
"resource": "private_network",
"uuids": ["5220f263-0e8e-4917-bf4f-4cae109ca4c5"]
},
{
"resource": "floating_ip",
"uuids": ["1b8349e5-3568-43e0-bf89-fc3350dd7a08"]
}
],
"team": "48454223-c5ac-461f-bead-ba8dda13eea9"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
moves: [
{
resource: 'server',
uuids: ['ecc6f4f1-c89b-4dce-a20b-a330641c5b0b', '304e1794-a5b7-41f2-9a20-c0d444eb6683']
},
{resource: 'iso', uuids: ['ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b']},
{resource: 'firewall_group', uuids: ['72a4a737-236f-456f-827f-6145d9c95727']},
{resource: 'firewall_ip_group', uuids: ['145e6e6f-a6b0-4b9e-9060-2d4f017baff8']},
{resource: 'private_network', uuids: ['5220f263-0e8e-4917-bf4f-4cae109ca4c5']},
{resource: 'floating_ip', uuids: ['1b8349e5-3568-43e0-bf89-fc3350dd7a08']}
],
team: '48454223-c5ac-461f-bead-ba8dda13eea9'
})
};
fetch('https://console.advinservers.com/api/v1/client/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://console.advinservers.com/api/v1/client/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'moves' => [
[
'resource' => 'server',
'uuids' => [
'ecc6f4f1-c89b-4dce-a20b-a330641c5b0b',
'304e1794-a5b7-41f2-9a20-c0d444eb6683'
]
],
[
'resource' => 'iso',
'uuids' => [
'ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b'
]
],
[
'resource' => 'firewall_group',
'uuids' => [
'72a4a737-236f-456f-827f-6145d9c95727'
]
],
[
'resource' => 'firewall_ip_group',
'uuids' => [
'145e6e6f-a6b0-4b9e-9060-2d4f017baff8'
]
],
[
'resource' => 'private_network',
'uuids' => [
'5220f263-0e8e-4917-bf4f-4cae109ca4c5'
]
],
[
'resource' => 'floating_ip',
'uuids' => [
'1b8349e5-3568-43e0-bf89-fc3350dd7a08'
]
]
],
'team' => '48454223-c5ac-461f-bead-ba8dda13eea9'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://console.advinservers.com/api/v1/client/transfers"
payload := strings.NewReader("{\n \"moves\": [\n {\n \"resource\": \"server\",\n \"uuids\": [\n \"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b\",\n \"304e1794-a5b7-41f2-9a20-c0d444eb6683\"\n ]\n },\n {\n \"resource\": \"iso\",\n \"uuids\": [\n \"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b\"\n ]\n },\n {\n \"resource\": \"firewall_group\",\n \"uuids\": [\n \"72a4a737-236f-456f-827f-6145d9c95727\"\n ]\n },\n {\n \"resource\": \"firewall_ip_group\",\n \"uuids\": [\n \"145e6e6f-a6b0-4b9e-9060-2d4f017baff8\"\n ]\n },\n {\n \"resource\": \"private_network\",\n \"uuids\": [\n \"5220f263-0e8e-4917-bf4f-4cae109ca4c5\"\n ]\n },\n {\n \"resource\": \"floating_ip\",\n \"uuids\": [\n \"1b8349e5-3568-43e0-bf89-fc3350dd7a08\"\n ]\n }\n ],\n \"team\": \"48454223-c5ac-461f-bead-ba8dda13eea9\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://console.advinservers.com/api/v1/client/transfers")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"moves\": [\n {\n \"resource\": \"server\",\n \"uuids\": [\n \"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b\",\n \"304e1794-a5b7-41f2-9a20-c0d444eb6683\"\n ]\n },\n {\n \"resource\": \"iso\",\n \"uuids\": [\n \"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b\"\n ]\n },\n {\n \"resource\": \"firewall_group\",\n \"uuids\": [\n \"72a4a737-236f-456f-827f-6145d9c95727\"\n ]\n },\n {\n \"resource\": \"firewall_ip_group\",\n \"uuids\": [\n \"145e6e6f-a6b0-4b9e-9060-2d4f017baff8\"\n ]\n },\n {\n \"resource\": \"private_network\",\n \"uuids\": [\n \"5220f263-0e8e-4917-bf4f-4cae109ca4c5\"\n ]\n },\n {\n \"resource\": \"floating_ip\",\n \"uuids\": [\n \"1b8349e5-3568-43e0-bf89-fc3350dd7a08\"\n ]\n }\n ],\n \"team\": \"48454223-c5ac-461f-bead-ba8dda13eea9\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://console.advinservers.com/api/v1/client/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"moves\": [\n {\n \"resource\": \"server\",\n \"uuids\": [\n \"ecc6f4f1-c89b-4dce-a20b-a330641c5b0b\",\n \"304e1794-a5b7-41f2-9a20-c0d444eb6683\"\n ]\n },\n {\n \"resource\": \"iso\",\n \"uuids\": [\n \"ec4fa5b5-cc7c-4fcf-b280-ee55eca8d44b\"\n ]\n },\n {\n \"resource\": \"firewall_group\",\n \"uuids\": [\n \"72a4a737-236f-456f-827f-6145d9c95727\"\n ]\n },\n {\n \"resource\": \"firewall_ip_group\",\n \"uuids\": [\n \"145e6e6f-a6b0-4b9e-9060-2d4f017baff8\"\n ]\n },\n {\n \"resource\": \"private_network\",\n \"uuids\": [\n \"5220f263-0e8e-4917-bf4f-4cae109ca4c5\"\n ]\n },\n {\n \"resource\": \"floating_ip\",\n \"uuids\": [\n \"1b8349e5-3568-43e0-bf89-fc3350dd7a08\"\n ]\n }\n ],\n \"team\": \"48454223-c5ac-461f-bead-ba8dda13eea9\"\n}"
response = http.request(request)
puts response.read_body{
"resource": null,
"resources": [
"server",
"iso",
"firewall_group",
"firewall_ip_group",
"private_network",
"floating_ip"
],
"moved": 7,
"team": {
"id": "48454223-c5ac-461f-bead-ba8dda13eea9",
"name": "Lambda Complex"
}
}{
"message": "Unauthenticated."
}{
"message": "This API key is not allowed to do that in this team. It needs the \"snapshot.delete\" permission."
}{
"message": "The name field is required.",
"errors": {}
}{
"message": "Too Many Attempts."
}Authorizations
Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.
Body
application/json
Send a JSON object containing the fields below. Required fields are marked in the schema.
Response
The record, as a JSON object. There is no envelope.
The type of resource this entry describes.
Example:
null
The value of resources.
Example:
[
"server",
"iso",
"firewall_group",
"firewall_ip_group",
"private_network",
"floating_ip"
]
The value of moved.
Example:
7
The destination team UUID.
Show child attributes
Show child attributes
Example:
{
"id": "48454223-c5ac-461f-bead-ba8dda13eea9",
"name": "Lambda Complex"
}