Purge By URL
This API is used to refreshes the cached content at edge nodes by URL.
request
Request-Line
POST /cdn/v1.0/services/{serviceId}/purgeUrl HTTP/1.1
Request Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| serviceId | Integer | Mandatory | service id. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| urls | String[] | Mandatory | The URLs path to be purged on edge server. |
Response
Response Body
| Parameter | Type | Description |
|---|---|---|
| batchId | Int | The id of batch purge. |
Status Codes, Error Codes and Error Messages
| Status Code | Error Code | Error Message |
|---|---|---|
| 400 | Request.BadRequest | Bad request. |
| 400 | InvalidCustomer.IdEmpty | Customer id can be empty or invalid. |
| 400 | InvalidService.IdIncorrect | Service id is empty or invalid. |
| 400 | ServiceId.IdPermission | ServiceId can not be found or unknown. |
| 400 | InvalidPurge.Url | Url cannot be empty. |
| 400 | InvalidPurge.PurgeFormat | Purge format is incorrect. |
Examples
Purge By URL
Request
POST /cdn/v1.0/services/228654/purgeURL HTTP/1.1
{
"urls": [
"https://cdn.example1.com/resources/load.js",
"https://cdn.example1.com/resources/load2.js",
"https://cdn.example1.com/resources/load3.js"
]
}
Successful Response Body
{
"batchId": 2
}