# police single-rate

モード
  ポリシーマップ・クラスモード
カテゴリー
  トラフィック制御 / Quality of Service

## 構文

コマンド構文

`(config-pmap-c)# police single-rate MAXRATE MINBURST MAXBURST action ACTION`

`(config-pmap-c)# no police`

## コマンド説明

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

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

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

- ポリシング
  帯域クラスRedに分類されたパケット（帯域超過パケット）を破棄することで、該当トラフィッククラス群の帯域使用量を最大トラフィックレート＋最大許容バーストサイズ以下に抑える
- リマーキング
  帯域クラスをキーとしてremarkマップ（remark-mapコマンドで設定）を検索し、パケットのDSCP値と帯域クラスを変更する。これにより、キューイング時の動作に影響を与えたり、後続の機器に情報を提供したりする

## パラメーター

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

## 使用例

トラフィッククラスfiletxにシングルレート個別ポリサーを設定し、同トラフィックに割り当てる帯域幅を最大512Kbpsに制限する。

    awplus(config)# policy-map test
    awplus(config-pmap)# class filetx
    awplus(config-pmap-c)# police single-rate 512 8192 16384 action drop-red

## 注意・補足事項

MAXRATEの指定値が64Kbpsの倍数でない場合は、有効範囲内のもっとも近い倍数になるよう丸められる。
MINBURST、MAXBURSTの指定値が4096Byteの倍数でない場合は、有効範囲内のもっとも近い倍数になるよう丸められる。
複数のスイッチチップ（インスタンス）にまたがるトランクグループ（スタティックチャンネルグループ、LACPチャンネルグループとも）ではメータリングが動作しない。複数インスタンスにまたがるトランクグループに対しては、本コマンドを含むポリシーマップを適用しないこと（適用してもメータリングが動作しない）。
シングルレート個別ポリサーにおけるパラメーターの関係

## コマンドツリー

## 関連コマンド