docs: def do_alarm_update(mc, args):
      '''Update the alarm state.'''
      fields = {}
      fields['alarm_id'] = args.id
      if args.state.upper() not in state_types:
              errmsg = ('Invalid state, not one of [' +
                        ', '.join(state_types) + ']')
              print(errmsg)
              return
      fields['state'] = args.state
      fields['lifecycle_state'] = args.lifecycle_state
      fields['link'] = args.link
      try:
          alarm = mc.alarms.update(**fields)
      except (osc_exc.ClientException, k_exc.HttpError) as he:
          raise osc_exc.CommandError('%s\n%s' % (he.message, he.details))
      else:
          print(jsonutils.dumps(alarm, indent=2))