Add aliases in bulk
curl --request POST \
--url https://api.gcore.com/cdn/aliases/add \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"resource_id": 4567,
"items": [
{
"cname": "shop.customer.com",
"ssl_id": 890,
"automated": false
}
]
}
'import requests
url = "https://api.gcore.com/cdn/aliases/add"
payload = {
"resource_id": 4567,
"items": [
{
"cname": "shop.customer.com",
"ssl_id": 890,
"automated": False
}
]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
resource_id: 4567,
items: [{cname: 'shop.customer.com', ssl_id: 890, automated: false}]
})
};
fetch('https://api.gcore.com/cdn/aliases/add', 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://api.gcore.com/cdn/aliases/add",
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([
'resource_id' => 4567,
'items' => [
[
'cname' => 'shop.customer.com',
'ssl_id' => 890,
'automated' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"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://api.gcore.com/cdn/aliases/add"
payload := strings.NewReader("{\n \"resource_id\": 4567,\n \"items\": [\n {\n \"cname\": \"shop.customer.com\",\n \"ssl_id\": 890,\n \"automated\": false\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
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://api.gcore.com/cdn/aliases/add")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"resource_id\": 4567,\n \"items\": [\n {\n \"cname\": \"shop.customer.com\",\n \"ssl_id\": 890,\n \"automated\": false\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/cdn/aliases/add")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"resource_id\": 4567,\n \"items\": [\n {\n \"cname\": \"shop.customer.com\",\n \"ssl_id\": 890,\n \"automated\": false\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"created": [
{
"id": 1,
"cname": "a.customer.com",
"status": "pending"
}
],
"exists": [
{
"id": 7,
"cname": "b.customer.com",
"status": "active"
}
]
}{
"errors": {
"items": [
{},
{
"cname": [
"Hostname b.customer.com already exists."
]
}
]
}
}Aliases
Add aliases in bulk
Create up to 1000 aliases for one CDN resource in a single request.
The request is atomic: if any item is invalid, nothing is created and the errors are returned per item,
in the same order as the request items. An item whose hostname is already an alias of the same CDN
resource is reported in exists and left unchanged.
The aliases limit of your account is checked against the items that would be created.
POST
/
cdn
/
aliases
/
add
Add aliases in bulk
curl --request POST \
--url https://api.gcore.com/cdn/aliases/add \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"resource_id": 4567,
"items": [
{
"cname": "shop.customer.com",
"ssl_id": 890,
"automated": false
}
]
}
'import requests
url = "https://api.gcore.com/cdn/aliases/add"
payload = {
"resource_id": 4567,
"items": [
{
"cname": "shop.customer.com",
"ssl_id": 890,
"automated": False
}
]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
resource_id: 4567,
items: [{cname: 'shop.customer.com', ssl_id: 890, automated: false}]
})
};
fetch('https://api.gcore.com/cdn/aliases/add', 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://api.gcore.com/cdn/aliases/add",
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([
'resource_id' => 4567,
'items' => [
[
'cname' => 'shop.customer.com',
'ssl_id' => 890,
'automated' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"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://api.gcore.com/cdn/aliases/add"
payload := strings.NewReader("{\n \"resource_id\": 4567,\n \"items\": [\n {\n \"cname\": \"shop.customer.com\",\n \"ssl_id\": 890,\n \"automated\": false\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
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://api.gcore.com/cdn/aliases/add")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"resource_id\": 4567,\n \"items\": [\n {\n \"cname\": \"shop.customer.com\",\n \"ssl_id\": 890,\n \"automated\": false\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/cdn/aliases/add")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"resource_id\": 4567,\n \"items\": [\n {\n \"cname\": \"shop.customer.com\",\n \"ssl_id\": 890,\n \"automated\": false\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"created": [
{
"id": 1,
"cname": "a.customer.com",
"status": "pending"
}
],
"exists": [
{
"id": 7,
"cname": "b.customer.com",
"status": "active"
}
]
}{
"errors": {
"items": [
{},
{
"cname": [
"Hostname b.customer.com already exists."
]
}
]
}
}Authorizations
API key for authentication. Make sure to include the word apikey, followed by a single space and then your token.
Example: apikey 1234_abcdef
Body
application/json
Was this page helpful?