Python
import os
from gcore import Gcore
client = Gcore(
api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted
)
response = client.cdn.aliases.create_multiple(
items=[{
"cname": "shop.customer.com"
}],
resource_id=4567,
)
print(response.created)package main
import (
"context"
"fmt"
"github.com/G-Core/gcore-go"
"github.com/G-Core/gcore-go/cdn"
"github.com/G-Core/gcore-go/option"
)
func main() {
client := gcore.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.CDN.Aliases.NewMultiple(context.TODO(), cdn.AliasNewMultipleParams{
Items: []cdn.AliasNewMultipleParamsItem{{
Cname: "shop.customer.com",
}},
ResourceID: 4567,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Created)
}
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.example.com",
"ssl_id": 890,
"automated": false,
"challenge_type": "http_01"
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
resource_id: 4567,
items: [
{
cname: 'shop.example.com',
ssl_id: 890,
automated: false,
challenge_type: 'http_01'
}
]
})
};
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.example.com',
'ssl_id' => 890,
'automated' => false,
'challenge_type' => 'http_01'
]
]
]),
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;
}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.example.com\",\n \"ssl_id\": 890,\n \"automated\": false,\n \"challenge_type\": \"http_01\"\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.example.com\",\n \"ssl_id\": 890,\n \"automated\": false,\n \"challenge_type\": \"http_01\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"created": [
{
"id": 1,
"cname": "shop.example.com",
"status": "pending",
"ssl_status": "pending"
}
],
"exists": [
{
"id": 7,
"cname": "www.example.com",
"status": "active",
"ssl_status": "issued"
}
]
}{
"errors": {
"items": [
{},
{
"cname": [
"Hostname www.example.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
Python
import os
from gcore import Gcore
client = Gcore(
api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted
)
response = client.cdn.aliases.create_multiple(
items=[{
"cname": "shop.customer.com"
}],
resource_id=4567,
)
print(response.created)package main
import (
"context"
"fmt"
"github.com/G-Core/gcore-go"
"github.com/G-Core/gcore-go/cdn"
"github.com/G-Core/gcore-go/option"
)
func main() {
client := gcore.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.CDN.Aliases.NewMultiple(context.TODO(), cdn.AliasNewMultipleParams{
Items: []cdn.AliasNewMultipleParamsItem{{
Cname: "shop.customer.com",
}},
ResourceID: 4567,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Created)
}
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.example.com",
"ssl_id": 890,
"automated": false,
"challenge_type": "http_01"
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
resource_id: 4567,
items: [
{
cname: 'shop.example.com',
ssl_id: 890,
automated: false,
challenge_type: 'http_01'
}
]
})
};
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.example.com',
'ssl_id' => 890,
'automated' => false,
'challenge_type' => 'http_01'
]
]
]),
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;
}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.example.com\",\n \"ssl_id\": 890,\n \"automated\": false,\n \"challenge_type\": \"http_01\"\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.example.com\",\n \"ssl_id\": 890,\n \"automated\": false,\n \"challenge_type\": \"http_01\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"created": [
{
"id": 1,
"cname": "shop.example.com",
"status": "pending",
"ssl_status": "pending"
}
],
"exists": [
{
"id": 7,
"cname": "www.example.com",
"status": "active",
"ssl_status": "issued"
}
]
}{
"errors": {
"items": [
{},
{
"cname": [
"Hostname www.example.com already exists."
]
}
]
}
}This endpoint is in beta. BETA
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?