Add delete method on alarm in Ceilometer API reference

Ceilometer API v2 supports alarm deletion, but API reference doesn't
mention it.

Change-Id: If7491cf4f0465605ac952431feb9783bf330ddad
Closes-Bug: #1278743
Merge "Add delete method on alarm in Ceilometer API reference"