Update a cache overload profile

put

https://{hostname}/api/lcdn-services/v1/hypercache/cache-overload-profiles/{cacheOverloadProfileId}

This operation updates the details of each cache overload profile instance.

Path Params

cacheOverloadProfileId

integer

required

Uniquely identifies each cache overload profile instance.

Body Params

HPC overload profile update schema.

name

string

required

length between 1 and 128

A unique name assigned to the HPC Overload Profile. The minumum length is 1 and the maximum length is 128.

lowPriorityLoadThresholdPercent

integer

0 to 90

Defaults to 60

A value between 0 and 90 that represents the load capacity threshold above which LCDN nodes only accepts medium and high prefix traffic. Ensure that the low-priority traffic value you specify is equal to or less than the medium-priority traffic value. An HPC is considered overloaded for low-priority traffic when its average load capacity exceeds the configured load capacity threshold.

mediumPriorityLoadThresholdPercent

integer

0 to 90

Defaults to 70

A value between 0 and 90 that represents the load capacity threshold above which nodes only accepts high priority prefix traffic. Ensure that the medium-priority traffic value you specify is equal to or less than the high-priority traffic value. An HPC is considered overloaded for medium priority traffic when its average load capacity exceeds the configured load capacity threshold.

highPriorityLoadThresholdPercent

integer

0 to 90

Defaults to 80

A value between 0 and 90 that represents the load capacity threshold above which the HPC nodes should be considered overloaded.

lowPriorityBandwidthThresholdPercent

integer

0 to 100

Defaults to 100

A value between 0 and 100 that represents the bandwidth capacity threshold above which nodes only accepts medium and high priority prefix traffic. Ensure that the low-priority traffic value you specify is equal to or less than the medium-priority traffic value. An HPC is considered overloaded for low-priority traffic when its average bandwidth capacity exceeds the configured bandwidth capacity threshold.

mediumPriorityBandwidthThresholdPercent

integer

0 to 100

Defaults to 100

A value between 0 and 100 that represents the bandwidth capacity threshold above which nodes only accepts high priority prefix traffic. Ensure that the medium-priority traffic you specify is equal to or less than the high-priority traffic value. An HPC is considered overloaded for medium-priority traffic when its average bandwidth capacity exceeds the configured bandwidth capacity threshold.

highPriorityBandwidthThresholdPercent

integer

0 to 100

Defaults to 100

A value between 0 and 100 that represents the bandwidth capacity threshold above which the HPC nodes should be considered overloaded.

overloadAction

Overload action types are measures that HPCs take when the traffic levels for load average and bandwidth thresholds on HPCs exceed the configured load and bandwidth capacity thresholds. Reject Connection Overload Action Type tells the HPC to reject the persistent connection without sending an HTTP response header or disallow HPCs from rejecting the persistent connection. Site Redirect Overload Action Type tells the HPC to issue a 302 response redirecting HTTP client requests to another HPC in the site that is not overloaded. HTTP Response Code Options Overload Action Type lets you choose from among a list HTTP response codes that you want the HPC to return for a client request, when the HPC load exceeds the configured thresholds.

Responses

200An HTTP 200 will signify the successful update of an cache-overload-profile instance.

400An HTTP 400 will be returned if the request is badly formed or has constraint violations

403An HTTP 403 will be returned if the principal is not authorized to access the instance of cache-hierarchy that the request was made against.

404An HTTP 404 will be returned if the cache-memory-profile with the specified entityId is not found.

409An HTTP 409 will be returned if the cache-memory-profile offered for create/update would lead to a conflicting state.