Retrieve All Distributions 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 retrieve all the CDN distributions under a contract, perform a GET request.
Endpoint
Use the following endpoint to retrieve all CDN distributions for a contract: https://cdn.de-fra.ionos.com/distributions.
Request
Copy url --X \
--request GET 'https://cdn.de-fra.ionos.com/distributions?offset=0&limit=100' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json' \ Response
200 Successful operation
Copy {
"id" : "24c578a9-361f-54d4-a326-a3f3070d5a03" ,
"type" : "collection" ,
"href" : "/distributions" ,
"items" : [
{
"id" : "9ba15778-16c4-543c-8775-e52acf4853f5" ,
"type" : "distribution" ,
"href" : "/distributions/9ba15778-16c4-543c-8775-e52acf4853f5" ,
"metadata" : {
"createdDate" : "2020-12-10T13:37:50+01:00" ,
"createdBy" : "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3" ,
"createdByUserId" : "87f9a82e-b28d-49ed-9d04-fba2c0459cd3" ,
"lastModifiedDate" : "2020-12-11T13:37:50+01:00" ,
"lastModifiedBy" : "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3" ,
"lastModifiedByUserId" : "87f9a82e-b28d-49ed-9d04-fba2c0459cd3" ,
"resourceURN" : "ionos:<product>:<location>:<contract>:<resource-path>" ,
"publicEndpointIpv4" : "1.2.3.4" ,
"publicEndpointIpv6" : "2001:db8::ff00:42:8329" ,
"state" : "AVAILABLE" ,
"message" : "In progress."
},
"properties" : {
"domain" : "example.com" ,
"certificateId" : "5a029f4a-72e5-11ec-90d6-0242ac120003" ,
"routingRules" : [
{
"scheme" : "http/https" ,
"prefix" : "/api" ,
"upstream" : {
"host" : "server.example.com" ,
"caching" : true ,
"waf" : true ,
"geoRestrictions" : {
"blockList" : [
"CN" ,
"RU"
]
},
"rateLimitClass" : "none"
}
}
]
}
}
],
"offset" : 0,
"limit" : 42,
"_links" : {
"prev" : "http://PREVIOUS-PAGE-URI" ,
"self" : "http://THIS-PAGE-URI" ,
"next" : "http://NEXT-PAGE-URI"
}
} Result: All the existing CDN distributions and their details are successfully obtained for your contract.