Caching

Edge Cache Expiration

This endpoint updates the Edge Cache Expiration settings for a CDN resource. Available for small and large resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization.

resource_uuidstring · uuidrequired

The ID of the resource to update.

Body

resource_uuidstringrequired

The UUID of the resource.

Example: *****-*****-****-*****

cache_typestring · enumrequired

The cache type, which can be either 'edge' or 'origin'.

Example: edge

Options: edge, origin

edge_cache_expiryinteger · min: 1 · max: 365

The duration for which the edge cache is valid. Required when cache_type is 'edge'.

Example: 6

edge_cache_unitstring · enum

The unit of the edge cache duration. Required when cache_type is 'edge'.

Example: d

Options: s, m, h, d, M

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_uuid": "*****-*****-****-*****",
    "cache_type": "edge",
    "edge_cache_expiry": 6,
    "edge_cache_unit": "d"
  }'

200

200

{
  "status": true,
  "data": {}
}

Edge Cache Expiry updated successfully.

Browser Cache Rules

This endpoint updates the browser cache rules for a specific resource. A maximum of 15 rules can be defined.This setting is available in small, large and dynamic(aksela) resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization.

resource_uuidstring · uuidrequired

The UUID of the resource to update.

Body

resource_uuidstringrequired

The UUID of the resource.

Example: ****-****-****-***

browser_cache_rulesobject[]required

browser_cache_with_htmlboolean

Controls whether HTML content is cached by the browser.

Example: false

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_uuid": "****-****-****-***",
    "browser_cache_rules": [
      {
        "type": "all_files",
        "content": [],
        "priority": 50,
        "cache_mode": "origin",
        "cache_time": 0,
        "directive": [],
        "exact_match": false
      },
      {
        "type": "full_path",
        "content": [
          "/example/images.jpg"
        ],
        "priority": 40,
        "cache_mode": "cache",
        "cache_time": 60,
        "directive": [
          "must-revalidate",
          "public",
          "private"
        ],
        "exact_match": false
      },
      {
        "type": "directory",
        "content": [
          "/test",
          "/test1/"
        ],
        "priority": 100,
        "cache_mode": "no_cache",
        "cache_time": 0,
        "directive": [],
        "exact_match": false
      },
      {
        "type": "file_extension",
        "content": [
          ".png",
          ".jpg"
        ],
        "priority": 30,
        "cache_mode": "cache",
        "cache_time": 30,
        "directive": [
          "must-revalidate",
          "no-cache",
          "no-store",
          "no-transform",
          "public",
          "private",
          "proxy-revalidate"
        ],
        "exact_match": false
      },
      {
        "type": "directory",
        "content": [
          "/sinem/"
        ],
        "priority": 30,
        "cache_mode": "cache",
        "cache_time": 30,
        "directive": [
          "must-revalidate",
          "no-cache",
          "no-store",
          "no-transform",
          "public",
          "private",
          "proxy-revalidate"
        ],
        "exact_match": true
      }
    ],
    "browser_cache_with_html": false
  }'

200

200

{
  "status": true,
  "data": {}
}

Browser cache rules updated successfully.

Query String Caching

This endpoint updates the query string caching settings for a specific resource. This setting is available in small and dynamic resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstring · uuidrequired

The UUID of the organization.

resource_uuidstring · uuidrequired

The UUID of the resource to update.

Body

resource_uuidstringrequired

The UUID of the resource.

Example: ****-****-****-****

status_qsstring · enumrequired

Controls query string caching behavior.

Example: on

Options: on, off, request_uri

status_qs_cache_ignorebooleanrequired

Determines if query string caching should be ignored.

Example: true

status_cqsbooleanrequired

Indicates if caching query string parameters should be enabled.

Example: false

qs_cache_ignore_paramstring[]

List of query string parameters to ignore for caching.

Example: ["test"]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_uuid": "****-****-****-****",
    "status_qs": "on",
    "status_qs_cache_ignore": true,
    "status_cqs": false,
    "qs_cache_ignore_param": [
      "test"
    ]
  }'

200

200

{
  "status": true,
  "data": {}
}

Query string caching settings updated successfully.

ETag verification

This setting is available in small, large and dynamic(aksela) resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Body

status_etag_verificationbooleanrequired

Enables or disables the ETag verification for the resource.

Example: true

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "status_etag_verification": true
  }'

200

200

{
  "status": true,
  "data": {}
}

Successfully updated the ETag verification setting for the resource.

Error Status Code Cache Expiration

This setting is available for small, large and Aksela resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Body

status_code_cacheobject[]required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "status_code_cache": [
      {
        "status_codes": [
          500,
          501
        ],
        "cache_expiry": 5,
        "cache_unit": "m"
      },
      {
        "status_codes": [
          400
        ],
        "cache_expiry": 1,
        "cache_unit": "m"
      }
    ]
  }'

200

200

{
  "status": true,
  "data": {}
}

Successfully updated the error status code cache expiration settings for the resource.

Shared Cache

This setting is available for small, large and Aksela resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Body

status_share_cachestring · enumrequired

Enables or disables the shared cache process. Can be 'default' or 'share'.

Example: share

Options: default, share

share_cachestringrequired

The domain information of the resource for which shared cache will be performed.

Example: static-test.mncdn.org

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "status_share_cache": "share",
    "share_cache": "static-test.mncdn.org"
  }'

200

200

{
  "status": true,
  "data": {}
}

Successfully updated the shared cache settings for the resource.

Stale Cache

This setting is available for small, large and dynamic resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Body

stale_cachingstring · enum[]required

Defines the stale caching conditions to apply.

Example: ["error","timeout","http_503"]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "stale_caching": [
      "error",
      "timeout",
      "invalid_header",
      "http_500",
      "http_502",
      "http_503",
      "http_504"
    ]
  }'

200

200

{
  "status": true,
  "data": {}
}

Successfully updated the stale caching settings for the resource.

Robots.txt file

This setting is available in small and large resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Body

resource_uuidstringrequired

UUID of the resource

status_robot_txtstring · enumrequired

Status of the robot.txt settings for the resource.

Options: enabled, disabled, origin

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "resource_uuid": "text",
    "status_robot_txt": "enabled"
  }'

200

200

{
  "status": true,
  "data": {}
}

Successfully updated the resource configuration.

Range Based Caching

This setting is available in small and large resource types.

put

/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuidstringrequired

UUID of the organization

resource_uuidstringrequired

UUID of the resource

Body

status_range_based_cachingbooleanrequired

Enables or disables range based caching.

Example: true

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}' \
  --header 'Content-Type: application/json' \
  --data '{
    "status_range_based_caching": true
  }'

200

200

{
  "status": true,
  "data": {}
}

Successfully updated the range based caching setting for the resource.