Send Docs Feedback

Beta Release of SmartDocs

1. In the Resource URL, replace any values enclosed in "{}", such as your organization name.
2. Set the Basic Authentication credentials. These are your Edge email and password (user must be in the Org Admin role).
3. Tweak the Request Body as needed (if a body is needed).
4. Send the live request to Edge and view the response! You can also view Request data.

Update a cache in an environment

Resource Summary

Auth Type

BASICAUTH,

Content Type

application/json, text/xml

Category

Caches,

cacheUpdate

PUT

Update a cache in an environment

Updates a cache in an environment.

You must specify the complete definition of the cache, including the properties that you want to change and the ones that retain their current value. Any properties omitted from the request body are reset to their default value.

Use Get information about a cache to obtain an object containing the current value of all properties, then change only those that you want to update.

Resource URL

https://api.enterprise.apigee.com/v1 /organizations/{org_name}/environments/{env_name}/caches/{cache_name}

    Header Parameters

  • Name
    Value
    Description
  • Content-Type
    (required)
    Specify the content type as application/json or text/xml.

Request Body

Name

Description

Default

Required?

name

The name of the cache. Must be unique in the environment. Reference this cache from policies that interact with the cache resource.

N/A

No

description

A description of the cache resource.

N/A

No

diskSizeInMB Specifies the disk space used for the cache, in megabytes. 0 No

expirySettings

Enables different expiration mechanisms to be applied to entries in the cache. Cache entries can be expired a certain number of seconds after creation, at a specific time of day each day, or on a specific date.

Options include:

  • timeoutInSec
  • timeOfDay (hh:mm:ss)
  • expiryDate (mm-dd-yyyy)

The Populate Cache policy also lets you set expiry settings. The valuesNull property controls which expiry settings are applied for each entry.

  • If valuesNull is false (default), expiry settings in the Populate Cache policy are used.
  • If valuesNull = true, expiry settings in the policy are ignored.

300 seconds

No

maxElementsInMemory

Maximum number of entries the cache keeps in memory. Upon reaching the max limit the entries are evicted using the LRU algorithm.

100

No

maxElementsOnDisk Maximum number of entries kept on disk. Upon reaching the max limit the entries are evicted using the LRU algorithm. 1000 No

inMemorySizeInKB

All entries larger than the configured setting size, in kilobytes, will be compressed before being cached.

0

No

compression

If specified, enables you to configure the size threshold above which cache entries will be compressed. If not specified, compression is disabled.

Options include:

  • minimumSizeInKB: All entries larger than the configured setting size, in kilobytes, will be compressed before being cached.

false

No

overflowToDisk Specifies to overflow the in-memory cache to disk. false No
persistent Enables cache entries to be persistent across restarts. false No

skipCacheIfElementSizeInKBExceeds

If specified, enables you to configure the maximum size of data to be cached. Specify the size limit, in kilobytes, for cache entries. Data larger than the limit you set will not be cached.

disabled

No

org_name Mention the organization name true

env_name Mention the environment name true

cache_name Mention the cache name true

org_name Mention the organization name true

env_name Mention the environment name true

cache_name Mention the cache name true

Basic Auth

OAuth 2

Custom Token

Reset

Make a request and see the response.

Make a request and see the response.

Working...

Help or comments?

  • If something's not working: Ask the Apigee Community or see Apigee Support.
  • If something's wrong with the docs: Click Send Docs Feedback on this page.
    (Incorrect? Unclear? Broken link? Typo?)