Prerequisite: Only contract administrators, owners, and users with accessAndManageCdn privilege can create and manage CDN distributions via the API. You can also set user privileges in the DCD. For more information, see Set User Privileges.
To update an existing CDN distribution, perform a PUT request with the distributionID of the CDN. The CDN distribution for a given distributionID is updated with the provided distribution details.
Note: If a CDN distribution for a given distributionID does not exist, a distribution is created instead.
Endpoint
Use the following endpoint to create or update a CDN distribution: https://cdn.de-fra.ionos.com/distributions/{distributionId}.
Request
Note: The following request contains a sample distributionId. Replace them with the distributionId value whose information you want to update.
Below is the list of mandatory path parameter:
Body Parameters
Type
Description
Example
Below is the list of mandatory body parameters:
Response
200 Successful operation
Following is an example of when a CDN distribution is successfully created.
Result: A CDN distribution is successfully updated or created.
Body Parameters
Type
Description
Example
id
string
The ID (UUID) of the CDN distribution.
9ba15778-16c4-543c-8775-e52acf4853f5
domain
string
The domain name for the CDN distribution.
example.com
scheme
string
Choose whether to allow http, https, or http/https protocol.
http/https
To make authenticated requests to the API, the following fields are mandatory in the request header:
Header Parameters
Required
Type
Description
Authorization
yes
string
The Bearer token enables requests to authenticate using a JSON Web Token (JWT). From the DCD, .