UAPI Functions - CacheBuster::update - Knowledgebase

Description

This function generates a random integer (the CacheBuster ID). Use this ID to work with and around a browser's caching mechanism.

Examples

cPanel or Webmail Session URL

https://hostname.example.com:2083/cpsess##########/execute/CacheBuster/update

LiveAPI PHP Class

$cpanel = new CPANEL(); // Connect to cPanel - only do this once.

// Generate a new CacheBuster ID and return it.

$whoyagonnacall = $cpanel->uapi(

'CacheBuster', 'update'

);

LiveAPI Perl Module

my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once.

# Generate a new CacheBuster ID and return it.

my $whoyagonnacall = $cpliveapi->uapi(

'CacheBuster', 'update'

);

cPanel Template Toolkit

[% data = execute( 'CacheBuster', 'update' ); %]

Command Line

uapi --user=username CacheBuster update

Notes:

You must URI-encode values.
username represents your account-level username.

 Output (JSON)

{
  "messages": null,
  "errors": null,
  "status": 1,
  "metadata": {
     
  },
  "data": {
    "cache_id": "11381138"
  }
}

Note:

Use cPanel's API Shell interface (Home >> Advanced >> API Shell) to directly test cPanel API calls.

Parameters

This function does not accept parameters.

Returns

Return	Type	Description	Possible values	Example
cache_id	integer	A random integer that the system uses to work with and around a browser's caching mechanism.	An eight-digit integer.	11381138

Knowledgebase

Categories

Categories