traffic-policy rate-limit adaptive

Configures an ACL-based flexible-bandwidth traffic policy to define rate limits on packets so that you can allow for bursts above the limit.
Syntax
traffic-policy traffic-policy-defrate-limit{byte-based|packet-based}adaptivecircir-valuecbscbs-valuepirpir-valuepbspbs-valuecount
traffic-policy traffic-policy-defrate-limit{byte-based|packet-based}adaptivecircir-valuecbscbs-valuepirpir-valuepbspbs-valueexceed-actiondrop[count]
traffic-policy traffic-policy-defrate-limit{byte-based|packet-based}adaptivecircir-valuecbscbs-valuepirpir-valuepbspbs-valueexceed-actionpermit-at-low-pri[count|remark-cos[count]]
no traffic-policy traffic-policy-defrate-limit{byte-based|packet-based}adaptivecircir-valuecbscbs-valuepirpir-valuepbspbs-valuecount
no traffic-policy traffic-policy-defrate-limit{byte-based|packet-based}adaptivecircir-valuecbscbs-valuepirpir-valuepbspbs-valueexceed-actiondrop[count]
no traffic-policy traffic-policy-defrate-limit{byte-based|packet-based}adaptivecircir-valuecbscbs-valuepirpir-valuepbspbs-valueexceed-actionpermit-at-low-pri[count|remark-cos[count]]
Command Default

No traffic policy is applied.

Parameters
traffic-policy-def

Specifies the name of the traffic policy definition, in no more than seven alphanumeric characters.

{byte-based|packet-based}

Specifies the rate as either based on a packet count or a byte count.

count

Enables counting the number of bytes and the conformance level per packet. The single-rate three-color marker (srTCM) mechanism described in RFC 2697 is used.

circir-value
Specifies the committed information rate (CIR) in Kbps/Pps, that is, the guaranteed rate of inbound traffic that is allowed on a port. The range is 64 through 1,000,000 Kbps.
cbscbs-value
Specifies the committed burst size (CBS), that is, the number of bytes per second allowed on a port before some packets exceed the CIR. You must specify a value greater than 0.
pirpir-value
Specifies the peak information rate (PIR) in Kbps/Pps, that is, the most inbound traffic that is allowed on a port. The pir-value must be equal to or greater than the cir-value.
pbspbs-value
Specifies the peak burst size (PBS), that is, the most bytes per second allowed in a burst before all packets exceed the PIR. You must specify a value greater than 0.
exceed-action
Specifies the action for traffic that is more than is configured in the cir-value variable. If you do not configure this keyword, traffic that exceeds the cir-value is dropped
drop
Specifies dropping traffic that exceeds the rate limit.
count

Enables counting the number of bytes and the conformance level per packet. The two-rate three-color marker (trTCM) mechanism described in RFC 2698 is used.

permit-at-low-pri

Specifies permitting packets that exceed the cir-value and forward them at the lowest priority.

remark-cos

Sets the 802.1p priority of dropped packets to 0, that is, it sets the COS/PCP field value to 0 for the low priority traffic for any packet exceeding the rate limit set by the traffic policy

Modes

Global configuration mode

Usage Guidelines

The no form of this command deletes a traffic policy definition.

Traffic policies must be referenced by one or more ACLs before they can be effective. The policies are effective on ports to which the ACLs that reference them are bound.

Note: You cannot delete a traffic policy definition that a port is currently using. To delete a traffic policy, you must first unbind the associated ACL.

It is recommended that you specify a PBS value that is equal to or greater than the size of the largest possible IP packet in the stream.

Examples

The following example configures a traffic policy named TPDA4 that specifies a byte-based CIR of 10000 Kbps, a CBS of 1600 Kbps, a PIR of 20000 Kbps, and a PBS of 1000 Kbps a and dropping any traffic that exceeds those limits. 

device# configure terminal
device(config)# traffic-policy TPDA4 rate-limit byte-based adaptive cir 10000 cbs 1600 pir 20000 pbs 4000 exceed-action drop

The following example configures a traffic policy named tpd3 that specifies a byte-based CIR of 300 Kbps, a CBS of 300 Kbps, a PIR of 301 Kbps, and a PBS of 302 Kbps. If these limits are exceeded, traffic is permitted at low priority. 

device# configure terminal
device(config)# traffic-policy tpd3 rate-limit byte-based adaptive cir 300 cbs 300 pir 301 pbs 302 exceed-action permit-at-low-pri
History
Release version Command history
08.0.95 This command was modified to support a committed information rate (CIR) specified as either bytes or packets.
Parent topic: Commands Si - Z