# mls qos aggregate-police single-rate

モード
  グローバルコンフィグモード
カテゴリー
  トラフィック制御 / Quality of Service

## 構文

コマンド構文

`(config)# mls qos aggregate-police NAME single-rate MAXRATE MINBURST MAXBURST action ACTION`

`(config)# no mls qos aggregate-police NAME`

## コマンド説明

シングルレートの集約ポリサー（メーター/ポリサー）を定義する。
no形式で実行した場合は集約ポリサーの定義を削除する。
集約ポリサーは、複数のトラフィッククラスをひとまとめにし、これら全体に対して1つのポリサーを適用したい場合に使う。複数トラフィッククラスが対象になることを除き、個別ポリサーと動作は同じ。
シングルレート集約ポリサーは、本コマンドで設定した帯域基準値（最大トラフィックレートと最小・最大の各許容バーストサイズ）をもとに、対象トラフィッククラス群が実際にどの程度の帯域を使用しているかを計測し、その結果に基づいて該当トラフィッククラス群に属するパケットを3つの「帯域クラス」に分類する（メータリング）。

表 1
帯域クラス | 帯域使用量 | 取り扱いの一例
Green | 少ない | 帯域割り当ての優先度は最高
Yellow | 中程度 | 帯域割り当ての優先度は中。キューが混雑したときは（Redの次に）優先的に破棄
Red | 使いすぎ | 帯域割り当ての優先度は最低。キューへの格納前に破棄、あるいは、キューが混雑したとき優先的に破棄

帯域クラスへの分類後は、次のいずれかのアクションを実行できる。

- ポリシング
  帯域クラスRedに分類されたパケット（帯域超過パケット）を破棄することで、該当トラフィッククラス群の帯域使用量を最大トラフィックレート＋最大許容バーストサイズ以下に抑える

## パラメーター

`NAME`
  集約ポリサー名
`MAXRATE := <1-40000000>`
  最大トラフィックレート。単位はKbps。帯域クラスGreenの基準値（CIR）となる
`MINBURST := <1-16777216>`
  最大トラフィックレート（`MAXRATE`）に対する、帯域クラスGreenの最大許容バーストサイズ（CBS）。単位はByte。トラフィックの流入量が`MAXRATE`を上回った場合に、Greenのトラフィックに許容される超過データ量を指定する。バーストサイズが`MINBURST`を上回り、なおかつ、`MINBURST` + `MAXBURST`以下の場合、該当パケットは帯域クラスYellowに分類される。少なくとも`MINBURST`と`MAXBURST`のどちらかを、予期される最大パケットサイズ以上に設定する必要がある
`MAXBURST := <1-16777216>`
  最大トラフィックレート（`MAXRATE`）に対する、帯域クラスYellowの最大許容バーストサイズ（EBS）。単位はByte。トラフィックの流入量が`MAXRATE`を上回った場合に、Yellowのトラフィックに許容される超過データ量を指定する。バーストサイズが`MINBURST` + `MAXBURST`を上回った場合、該当パケットは帯域クラスRedに分類される。少なくとも`MINBURST`と`MAXBURST`のどちらかを、予期される最大パケットサイズ以上に設定する必要がある
`ACTION`
  帯域クラスへの分類後に実行するアクション。次のいずれかを指定する
  `drop-red`
    ポリシング（帯域クラスRedに分類されたパケットを破棄）
  `transmit`
    パケットを変更せずそのまま送信する

## 注意・補足事項

シングルレート集約ポリサーにおけるパラメーターの関係

本コマンドを実行するには、あらかじめQoS機能を有効にしておく必要がある（mls qos enableコマンド）。

## コマンドツリー

## 関連コマンド