Account7

Advanced analytics1

Advanced Rules9

AI5

Aliases9

Analytics12

Analyze1

API Discovery17

API Tokens8

Apps8

Bare Metal14

BGP announces2

Binaries4

Broadcasts6

CA certificates5

CDN activity logs2

CDN resources6

CDN service5

CDN Statistics9

Container as a Service19

Cost Reports6

Custom Page Sets7

Custom Rules10

DDoS Protection9

Directories5

DNS Clients1

DNS Locations4

DNSSEC4

Domains12

Edge Storage8

Event Logs2

Everywhere Inference28

Everywhere Inference Apps8

FastEdge Clients1

FastEdge Secrets6

FastEdge Templates5

File Shares17

Filter Templates5

Firewall Rules11

Floating IPs16

Function as a Service19

GPU Bare Metal46

GPU Virtual20

Images15

Instances44

IP addresses list2

IP Ranges1

IP Reputation3

IP Spotlight15

Let's Encrypt certificates6

Load Balancers57

Log viewer2

Logging10

Logs uploader24

Lookup1

Managed Kubernetes25

Managed PostgreSQL13

Metrics1

Network Organizations1

NetworkMappings7

Networks23

Notifications6

Origin shielding3

Origins6

Overlays6

Pickers2

Placement Groups4

Players6

Playlists6

Policies6

Policy Overrides6

Ports3

Pre-billing2

Presets8

Pricing1

Profiles10

Projects5

Protected Networks11

Protection Profiles7

Protection Templates3

Purge history1

QualitySets2

Quotas10

Regions2

Registry17

Reservations1

Reserved IPs11

Restreams5

Routers9

RRsets6

Rule templates6

Rules6

S3-Compatible Storage14

SecondaryZones13

Secrets5

Security Groups19

Security Insights14

Security Templates1

SFTP Storage5

Snapshot Schedules14

Snapshots7

SSH Keys14

SSHKeys9

SSL certificates6

Stats3

Storage24

Storage Locations3

Storage Statistics2

Streaming Statistics24

Streams11

Subtitles5

Tags1

Tasks6

Tools2

User Actions10

User Role Assignments6

Users8

Videos8

Volumes19

WAAP Service2

Zones10

Aliases

Create alias

Changed on Oct 21, 2026

Create an alias: a hostname you own that is served with the settings of one of your CDN resources and with its own SSL certificate.

By default, a Let's Encrypt certificate is issued for the alias automatically. Choose how its domain is validated with challenge_type.

To use your own certificate instead, pass its ID in ssl_id. The certificate must cover the alias hostname; a Let's Encrypt certificate issued for one of your CDN resources cannot be used.

The hostname must be unique across all CDN resources, additional CNAMEs and aliases.

The DNS record the hostname needs for Let's Encrypt domain validation is returned in ssl_provisioning of the alias details.

post/cdn/aliases

Request

Base URL
https://api.gcore.com
URL
https://api.gcore.com/cdn/aliases
Auth
HTTP apikey

Request body

cnamestring required

Alias hostname. Wildcard hostnames are not supported.

resource_idinteger required

ID of the CDN resource whose settings the alias is served with.

ssl_idinteger nullable

ID of your own SSL certificate to serve for the alias. The certificate must cover the alias hostname. A Let's Encrypt certificate issued for one of your CDN resources cannot be used.

Omit it to have a Let's Encrypt certificate issued automatically.

automatedboolean

How the alias certificate is managed. Defaults to true when ssl_id is omitted and to false when ssl_id is passed.

Possible values:

true – A Let's Encrypt certificate is issued and renewed automatically. ssl_id must be omitted.
false – Your own certificate referenced by ssl_id, if any, is served.

challenge_type'dns_01' | 'http_01'

Domain validation method used to issue the Let's Encrypt certificate for the alias.

Possible values:

dns_01 – Validation via a CNAME record for _acme-challenge.<alias hostname>, shown in ssl_provisioning.acme_delegation.
http_01 – Validation via an HTTP request to the alias hostname. The alias hostname must point to your CDN CNAME, shown in ssl_provisioning.http_validation. The request is served with the settings of the alias's CDN resource, so they must not block or redirect /.well-known/acme-challenge/.

activeboolean

Whether the alias is enabled. Defaults to true.

Example request

{
  "cname": "shop.example.com",
  "resource_id": 4567,
  "ssl_id": 890,
  "automated": true,
  "challenge_type": "http_01",
  "active": true
}

Response

Successful.

idinteger

Alias ID.

cnamestring

Alias hostname. Cannot be changed after creation.

resource_idinteger

ID of the CDN resource whose settings the alias is served with. Cannot be changed after creation.

automatedboolean

How the alias certificate is managed. Can be changed while the alias is served.

Possible values:

true – A Let's Encrypt certificate is issued and renewed automatically.
false – The certificate referenced by ssl_id, if any, was added by you.

challenge_type'dns_01' | 'http_01'

Domain validation method used to issue the Let's Encrypt certificate for the alias.

Possible values:

dns_01 – Validation via a CNAME record for _acme-challenge.<alias hostname>, shown in ssl_provisioning.acme_delegation.
http_01 – Validation via an HTTP request to the alias hostname. The alias hostname must point to your CDN CNAME, shown in ssl_provisioning.http_validation. The request is served with the settings of the alias's CDN resource, so they must not block or redirect /.well-known/acme-challenge/.

ssl_idinteger nullable

ID of the SSL certificate served for the alias.

activeboolean

Whether you have enabled the alias.

Possible values:

true – The alias is enabled.
false – The alias is paused and is not served.

enabledboolean

Whether the alias is enabled by the system. Follows the state of the CDN resource.

Possible values:

true – The alias can be served.
false – The alias is not served because its CDN resource is not active.

status'inactive' | 'pending' | 'http_only' | 'active'

Alias status.

Possible values:

inactive – The alias or its CDN resource is disabled; the alias is not served.
pending – The alias configuration has not reached the CDN yet.
http_only – The alias is served over HTTP only.
active – The alias is served over HTTP and HTTPS.

ssl_status'pending' | 'issued' | 'failed' nullable

Outcome of the certificate we manage for the alias.

Possible values:

pending – A certificate attempt is in progress, or was stopped by pausing the alias and starts again after it is resumed.
issued – The latest attempt succeeded.
failed – The latest attempt ended without a certificate.
null – No certificate is managed for the alias: the alias uses a certificate you provided, or is automated and has never opened an attempt.

ssl_validity_not_afterstring nullable

Date and time when the served certificate expires (ISO 8601/RFC 3339 format, UTC). null while no certificate is served.

createdstring

Date and time when the alias was created (ISO 8601/RFC 3339 format, UTC).

updatedstring

Date and time when the alias was last changed (ISO 8601/RFC 3339 format, UTC).

Example response

{
  "id": 123,
  "cname": "shop.example.com",
  "resource_id": 4567,
  "automated": true,
  "challenge_type": "http_01",
  "ssl_id": 890,
  "active": true,
  "enabled": true,
  "status": "active",
  "ssl_status": "issued",
  "ssl_validity_not_after": "2027-01-01T10:00:00Z",
  "created": "2026-09-01T10:00:00Z",
  "updated": "2026-09-01T10:05:00Z"
}

Changes

Oct 21, 2026d034c0d6d6ff Revision changes
- warning
  added the new http_only enum value to the response property for the response status
- info
  added the new optional request property
- info
  added the optional property to the response with the status
- info
  removed the ssl_error enum value from the response property for the response status
- info
  removed the ssl_issuing enum value from the response property for the response status
Sep 28, 20269b685d687b49 Revision changes
- breaking
  the response property became nullable for the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history (3 revisions)

Create alias

Request

Request body

Example request

Response 201Created

Example response

Changes

Response