Caching

PreviousCNAME & SSL NextHeaders

Last updated 1 month ago

Was this helpful?

ETag verification

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

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

Body

status_etag_verification*boolean

Enables or disables the ETag verification for the resource.

Example: true

Response

Successfully updated the ETag verification setting for the resource.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "status_etag_verification": true
    }),
});
const data = await response.json();

Response

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

Shared Cache

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

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

Body

status_share_cache*enum

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

Example: "share"

defaultshare

share_cache*string

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

Example: "static-test.mncdn.org"

Response

Successfully updated the shared cache settings for the resource.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "status_share_cache": "share",
      "share_cache": "static-test.mncdn.org"
    }),
});
const data = await response.json();

Response

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

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.

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string (uuid)

The UUID of the organization.

resource_uuid*string (uuid)

The UUID of the resource to update.

Body

resource_uuid*string

The UUID of the resource.

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

status_qs*enum

Controls query string caching behavior.

Example: "on"

onoffrequest_uri

status_qs_cache_ignore*boolean

Determines if query string caching should be ignored.

Example: true

status_cqs*boolean

Indicates if caching query string parameters should be enabled.

Example: false

qs_cache_ignore_paramarray of string

List of query string parameters to ignore for caching.

Example: ["test"]

Response

Query string caching settings updated successfully.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "resource_uuid": "****-****-****-****",
      "status_qs": "on",
      "status_qs_cache_ignore": true,
      "status_cqs": false,
      "qs_cache_ignore_param": [
        "test"
      ]
    }),
});
const data = await response.json();

Response

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

Error Status Code Cache Expiration

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

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

Body

status_code_cache*array of object

Response

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

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "status_code_cache": [
        {
          "status_codes": [
            500,
            501
          ],
          "cache_expiry": 5,
          "cache_unit": "m"
        },
        {
          "status_codes": [
            400
          ],
          "cache_expiry": 1,
          "cache_unit": "m"
        }
      ]
    }),
});
const data = await response.json();

Response

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

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.

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string (uuid)

The UUID of the organization.

resource_uuid*string (uuid)

The UUID of the resource to update.

Body

resource_uuid*string

The UUID of the resource.

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

browser_cache_rules*array of object

browser_cache_with_htmlboolean

Controls whether HTML content is cached by the browser.

Example: false

Response

Browser cache rules updated successfully.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "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
    }),
});
const data = await response.json();

Response

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

Edge Cache Expiration

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

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string (uuid)

The UUID of the organization.

resource_uuid*string (uuid)

The ID of the resource to update.

Body

resource_uuid*string

The UUID of the resource.

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

cache_type*enum

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

Example: "edge"

edgeorigin

edge_cache_expiryinteger

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

Example: 6

edge_cache_unitenum

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

Example: "d"

smhdM

Response

Edge Cache Expiry updated successfully.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "resource_uuid": "*****-*****-****-*****",
      "cache_type": "edge",
      "edge_cache_expiry": 6,
      "edge_cache_unit": "d"
    }),
});
const data = await response.json();

Response

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

Range Based Caching

This setting is available in small and large resource types.

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

Body

status_range_based_caching*boolean

Enables or disables range based caching.

Example: true

Response

Successfully updated the range based caching setting for the resource.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "status_range_based_caching": true
    }),
});
const data = await response.json();

Response

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

Stale Cache

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

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

Body

stale_caching*array of enum

The stale caching conditions to apply.

Response

Successfully updated the stale caching settings for the resource.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "stale_caching": [
        "error",
        "timeout",
        "invalid_header",
        "http_500",
        "http_502",
        "http_503",
        "http_504"
      ]
    }),
});
const data = await response.json();

Response

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

Robots.txt file

This setting is available in small and large resource types.

PUThttps://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}

Path parameters

organization_uuid*string

UUID of the organization

resource_uuid*string

UUID of the resource

Body

resource_uuid*string

UUID of the resource

status_robot_txt*enum

Status of the robot.txt settings for the resource.

enableddisabledorigin

Response

Successfully updated the resource configuration.

Body

statusboolean

Status of the update operation.

Example: true

dataobject

Details of the updated resource.

Request

const response = await fetch('https://cloud.medianova.com/api/v1/cdn/{organization_uuid}/resource/{resource_uuid}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "resource_uuid": "text",
      "status_robot_txt": "enabled"
    }),
});
const data = await response.json();

Response

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