IONOS Cloud (CDN) icon

IONOS Cloud (CDN)

Interact with IONOS Cloud CDN API

Actions7

Distribution → Create

AI-generated

Summary

Creates an IONOS Cloud CDN distribution with a domain and optional certificate and routing rules. Each routing rule maps a URL prefix and protocol scheme to an upstream host, with caching, WAF, geo-restriction, rate-limit, and SNI settings.

Inputs

  • Domain (required) — Domain name for the distribution, such as example.com.
  • Certificate ID — Optional ID of the SSL/TLS certificate from Certificate Manager. An empty value is omitted from the request body.
  • Routing Rules — Add one or more rules. Each requires an upstream host and can set a URL prefix (default /), scheme (default HTTP/HTTPS), caching and WAF (both default enabled), rate-limit class (default R100), SNI mode (default distribution), and optional geo-restriction JSON. Valid geo-restriction JSON is parsed into the upstream configuration; invalid JSON is silently omitted.
  • Include Response Headers — Defaults to false. When enabled, wraps each response body under body and adds statusCode and headers; requestId and requestStatusUrl are also retained if present.
  • Request Options — Optional batching, SSL certificate validation, proxy, and timeout settings for the API request. Batching defaults to 50 items per batch with a 1000 ms interval; timeout defaults to 10000 ms.

Output shape

A single API response item for the created distribution.

The node sends a POST request to /distributions. The API response body is returned as the item JSON by default. If Include Response Headers is enabled, the body is nested under body with statusCode and headers alongside it; requestId and requestStatusUrl are preserved when present.

Links

Discussion