From e6835249b4ee2f0fa3ea6ed9a3aca0d24091f91f Mon Sep 17 00:00:00 2001
From: chenxing <chen.xing@99cloud.net>
Date: Tue, 11 Jul 2017 00:17:30 +0800
Subject: [PATCH] import content from cli-reference in openstack-manuals

Change-Id: I27226913d8120136f312c0cd6391d01fea6a3a73
---
 doc/source/cli.rst   | 2202 ++++++++++++++++++++++++++++++++++++++++++
 doc/source/index.rst |   11 +
 2 files changed, 2213 insertions(+)
 create mode 100644 doc/source/cli.rst

diff --git a/doc/source/cli.rst b/doc/source/cli.rst
new file mode 100644
index 00000000..aa0c8c27
--- /dev/null
+++ b/doc/source/cli.rst
@@ -0,0 +1,2202 @@
+.. ###################################################
+.. ##  WARNING  ######################################
+.. ##############  WARNING  ##########################
+.. ##########################  WARNING  ##############
+.. ######################################  WARNING  ##
+.. ###################################################
+.. ###################################################
+.. ##
+.. This file is tool-generated. Do not edit manually.
+.. http://docs.openstack.org/contributor-guide/
+.. doc-tools/cli-reference.html
+..                                                  ##
+.. ##  WARNING  ######################################
+.. ##############  WARNING  ##########################
+.. ##########################  WARNING  ##############
+.. ######################################  WARNING  ##
+.. ###################################################
+
+==================================================================
+Telemetry Data Collection service (ceilometer) command-line client
+==================================================================
+
+The ceilometer client is the command-line interface (CLI) for
+the Telemetry Data Collection service (ceilometer) API
+and its extensions.
+
+This chapter documents :command:`ceilometer` version ``2.9.0``.
+
+For help on a specific :command:`ceilometer` command, enter:
+
+.. code-block:: console
+
+   $ ceilometer help COMMAND
+
+.. _ceilometer_command_usage:
+
+ceilometer usage
+~~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+   usage: ceilometer [--version] [-d] [-v] [--timeout TIMEOUT]
+                     [--ceilometer-url <CEILOMETER_URL>]
+                     [--ceilometer-api-version CEILOMETER_API_VERSION]
+                     [--os-tenant-id <tenant-id>]
+                     [--os-region-name <region-name>]
+                     [--os-auth-token <auth-token>]
+                     [--os-service-type <service-type>]
+                     [--os-endpoint-type <endpoint-type>] [--os-cacert <cacert>]
+                     [--os-insecure <insecure>] [--os-cert-file <cert-file>]
+                     [--os-key-file <key-file>] [--os-cert <cert>]
+                     [--os-key <key>] [--os-project-name <project-name>]
+                     [--os-project-id <project-id>]
+                     [--os-project-domain-id <project-domain-id>]
+                     [--os-project-domain-name <project-domain-name>]
+                     [--os-user-id <user-id>]
+                     [--os-user-domain-id <user-domain-id>]
+                     [--os-user-domain-name <user-domain-name>]
+                     [--os-endpoint <endpoint>] [--os-auth-system <auth-system>]
+                     [--os-username <username>] [--os-password <password>]
+                     [--os-tenant-name <tenant-name>] [--os-token <token>]
+                     [--os-auth-url <auth-url>]
+                     <subcommand> ...
+
+**Subcommands:**
+
+``alarm-combination-create``
+  Create a new alarm based on state of other
+  alarms.
+
+``alarm-combination-update``
+  Update an existing alarm based on state of
+  other alarms.
+
+``alarm-create``
+  Create a new alarm (Deprecated). Use alarm-threshold-create instead.
+
+``alarm-delete``
+  Delete an alarm.
+
+``alarm-event-create``
+  Create a new alarm based on events.
+
+``alarm-event-update``
+  Update an existing alarm based on events.
+
+``alarm-gnocchi-aggregation-by-metrics-threshold-create``
+  Create a new alarm based on computed
+  statistics.
+
+``alarm-gnocchi-aggregation-by-metrics-threshold-update``
+  Update an existing alarm based on computed
+  statistics.
+
+``alarm-gnocchi-aggregation-by-resources-threshold-create``
+  Create a new alarm based on computed
+  statistics.
+
+``alarm-gnocchi-aggregation-by-resources-threshold-update``
+  Update an existing alarm based on computed
+  statistics.
+
+``alarm-gnocchi-resources-threshold-create``
+  Create a new alarm based on computed
+  statistics.
+
+``alarm-gnocchi-resources-threshold-update``
+  Update an existing alarm based on computed
+  statistics.
+
+``alarm-history``
+  Display the change history of an alarm.
+
+``alarm-list``
+  List the user's alarms.
+
+``alarm-show``
+  Show an alarm.
+
+``alarm-state-get``
+  Get the state of an alarm.
+
+``alarm-state-set``
+  Set the state of an alarm.
+
+``alarm-threshold-create``
+  Create a new alarm based on computed
+  statistics.
+
+``alarm-threshold-update``
+  Update an existing alarm based on computed
+  statistics.
+
+``alarm-update``
+  Update an existing alarm (Deprecated).
+
+``capabilities``
+  Print Ceilometer capabilities.
+
+``event-list``
+  List events.
+
+``event-show``
+  Show a particular event.
+
+``event-type-list``
+  List event types.
+
+``meter-list``
+  List the user's meters.
+
+``query-alarm-history``
+  Query Alarm History.
+
+``query-alarms``
+  Query Alarms.
+
+``query-samples``
+  Query samples.
+
+``resource-list``
+  List the resources.
+
+``resource-show``
+  Show the resource.
+
+``sample-create``
+  Create a sample.
+
+``sample-create-list``
+  Create a sample list.
+
+``sample-list``
+  List the samples (return OldSample objects if
+  -m/--meter is set).
+
+``sample-show``
+  Show a sample.
+
+``statistics``
+  List the statistics for a meter.
+
+``trait-description-list``
+  List trait info for an event type.
+
+``trait-list``
+  List all traits with name <trait_name> for
+  Event Type <event_type>.
+
+``bash-completion``
+  Prints all of the commands and options to
+  stdout.
+
+``help``
+  Display help about this program or one of its
+  subcommands.
+
+.. _ceilometer_command_options:
+
+ceilometer optional arguments
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``--version``
+  show program's version number and exit
+
+``-d, --debug``
+  Defaults to ``env[CEILOMETERCLIENT_DEBUG]``.
+
+``-v, --verbose``
+  Print more verbose output.
+
+``--timeout TIMEOUT``
+  Number of seconds to wait for a response.
+
+``--ceilometer-url <CEILOMETER_URL>``
+  **DEPRECATED**, use --os-endpoint instead.
+  Defaults to ``env[CEILOMETER_URL]``.
+
+``--ceilometer-api-version CEILOMETER_API_VERSION``
+  Defaults to ``env[CEILOMETER_API_VERSION]`` or 2.
+
+``--os-tenant-id <tenant-id>``
+  Defaults to ``env[OS_TENANT_ID]``.
+
+``--os-region-name <region-name>``
+  Defaults to ``env[OS_REGION_NAME]``.
+
+``--os-auth-token <auth-token>``
+  Defaults to ``env[OS_AUTH_TOKEN]``.
+
+``--os-service-type <service-type>``
+  Defaults to ``env[OS_SERVICE_TYPE]``.
+
+``--os-endpoint-type <endpoint-type>``
+  Defaults to ``env[OS_ENDPOINT_TYPE]``.
+
+``--os-cacert <cacert>``
+  Defaults to ``env[OS_CACERT]``.
+
+``--os-insecure <insecure>``
+  Defaults to ``env[OS_INSECURE]``.
+
+``--os-cert-file <cert-file>``
+  Defaults to ``env[OS_CERT_FILE]``.
+
+``--os-key-file <key-file>``
+  Defaults to ``env[OS_KEY_FILE]``.
+
+``--os-cert <cert>``
+  Defaults to ``env[OS_CERT]``.
+
+``--os-key <key>``
+  Defaults to ``env[OS_KEY]``.
+
+``--os-project-name <project-name>``
+  Defaults to ``env[OS_PROJECT_NAME]``.
+
+``--os-project-id <project-id>``
+  Defaults to ``env[OS_PROJECT_ID]``.
+
+``--os-project-domain-id <project-domain-id>``
+  Defaults to ``env[OS_PROJECT_DOMAIN_ID]``.
+
+``--os-project-domain-name <project-domain-name>``
+  Defaults to ``env[OS_PROJECT_DOMAIN_NAME]``.
+
+``--os-user-id <user-id>``
+  Defaults to ``env[OS_USER_ID]``.
+
+``--os-user-domain-id <user-domain-id>``
+  Defaults to ``env[OS_USER_DOMAIN_ID]``.
+
+``--os-user-domain-name <user-domain-name>``
+  Defaults to ``env[OS_USER_DOMAIN_NAME]``.
+
+``--os-endpoint <endpoint>``
+  Defaults to ``env[OS_ENDPOINT]``.
+
+``--os-auth-system <auth-system>``
+  Defaults to ``env[OS_AUTH_SYSTEM]``.
+
+``--os-username <username>``
+  Defaults to ``env[OS_USERNAME]``.
+
+``--os-password <password>``
+  Defaults to ``env[OS_PASSWORD]``.
+
+``--os-tenant-name <tenant-name>``
+  Defaults to ``env[OS_TENANT_NAME]``.
+
+``--os-token <token>``
+  Defaults to ``env[OS_TOKEN]``.
+
+``--os-auth-url <auth-url>``
+  Defaults to ``env[OS_AUTH_URL]``.
+
+.. _ceilometer_alarm-combination-create:
+
+ceilometer alarm-combination-create
+-----------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-combination-create --name <NAME>
+                                              [--project-id <ALARM_PROJECT_ID>]
+                                              [--user-id <ALARM_USER_ID>]
+                                              [--description <DESCRIPTION>]
+                                              [--state <STATE>]
+                                              [--severity <SEVERITY>]
+                                              [--enabled {True|False}]
+                                              [--alarm-action <Webhook URL>]
+                                              [--ok-action <Webhook URL>]
+                                              [--insufficient-data-action <Webhook URL>]
+                                              [--time-constraint <Time Constraint>]
+                                              [--repeat-actions {True|False}]
+                                              --alarm_ids <ALARM IDS>
+                                              [--operator <OPERATOR>]
+
+Create a new alarm based on state of other alarms.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+  Required.
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--alarm_ids <ALARM IDS>``
+  List of alarm IDs. Required.
+
+``--operator <OPERATOR>``
+  Operator to compare with, one of: ['and',
+  'or'].
+
+.. _ceilometer_alarm-combination-update:
+
+ceilometer alarm-combination-update
+-----------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-combination-update [--name <NAME>]
+                                              [--project-id <ALARM_PROJECT_ID>]
+                                              [--user-id <ALARM_USER_ID>]
+                                              [--description <DESCRIPTION>]
+                                              [--state <STATE>]
+                                              [--severity <SEVERITY>]
+                                              [--enabled {True|False}]
+                                              [--alarm-action <Webhook URL>]
+                                              [--ok-action <Webhook URL>]
+                                              [--insufficient-data-action <Webhook URL>]
+                                              [--time-constraint <Time Constraint>]
+                                              [--repeat-actions {True|False}]
+                                              [--remove-time-constraint <Constraint names>]
+                                              [--alarm_ids <ALARM IDS>]
+                                              [--operator <OPERATOR>]
+                                              [<ALARM_ID>]
+
+Update an existing alarm based on state of other alarms.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to update.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--remove-time-constraint <Constraint names>``
+  Name or list of names of the time constraints
+  to remove.
+
+``--alarm_ids <ALARM IDS>``
+  List of alarm IDs.
+
+``--operator <OPERATOR>``
+  Operator to compare with, one of: ['and',
+  'or'].
+
+.. _ceilometer_alarm-delete:
+
+ceilometer alarm-delete
+-----------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-delete [<ALARM_ID>]
+
+Delete an alarm.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to delete.
+
+.. _ceilometer_alarm-event-create:
+
+ceilometer alarm-event-create
+-----------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-event-create --name <NAME>
+                                        [--project-id <ALARM_PROJECT_ID>]
+                                        [--user-id <ALARM_USER_ID>]
+                                        [--description <DESCRIPTION>]
+                                        [--state <STATE>] [--severity <SEVERITY>]
+                                        [--enabled {True|False}]
+                                        [--alarm-action <Webhook URL>]
+                                        [--ok-action <Webhook URL>]
+                                        [--insufficient-data-action <Webhook URL>]
+                                        [--time-constraint <Time Constraint>]
+                                        [--repeat-actions {True|False}]
+                                        [--event-type <EVENT_TYPE>] [-q <QUERY>]
+
+Create a new alarm based on events.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+  Required.
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--event-type <EVENT_TYPE>``
+  Event type for event alarm.
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list for filtering
+  events. data_type is optional, but if supplied
+  must be string, integer, float or datetime.
+
+.. _ceilometer_alarm-event-update:
+
+ceilometer alarm-event-update
+-----------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-event-update [--name <NAME>]
+                                        [--project-id <ALARM_PROJECT_ID>]
+                                        [--user-id <ALARM_USER_ID>]
+                                        [--description <DESCRIPTION>]
+                                        [--state <STATE>] [--severity <SEVERITY>]
+                                        [--enabled {True|False}]
+                                        [--alarm-action <Webhook URL>]
+                                        [--ok-action <Webhook URL>]
+                                        [--insufficient-data-action <Webhook URL>]
+                                        [--time-constraint <Time Constraint>]
+                                        [--repeat-actions {True|False}]
+                                        [--event-type <EVENT_TYPE>] [-q <QUERY>]
+                                        [<ALARM_ID>]
+
+Update an existing alarm based on events.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to update.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--event-type <EVENT_TYPE>``
+  Event type for event alarm.
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list for filtering
+  events. data_type is optional, but if supplied
+  must be string, integer, float or datetime.
+
+.. _ceilometer_alarm-gnocchi-aggregation-by-metrics-threshold-create:
+
+ceilometer alarm-gnocchi-aggregation-by-metrics-threshold-create
+----------------------------------------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-gnocchi-aggregation-by-metrics-threshold-create
+          --name <NAME> [--project-id <ALARM_PROJECT_ID>]
+          [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>]
+          [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}]
+          [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>]
+          [--insufficient-data-action <Webhook URL>]
+          [--time-constraint <Time Constraint>] [--repeat-actions {True|False}]
+          [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>]
+          --aggregation-method <AGGREATION> [--comparison-operator <OPERATOR>]
+          --threshold <THRESHOLD> -m <METRICS>
+
+Create a new alarm based on computed statistics.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+  Required.
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--granularity <GRANULARITY>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--aggregation-method <AGGREATION>``
+  Aggregation method to use, one of: ['last',
+  'min', 'median', 'sum', 'std', 'first',
+  'mean', 'count', 'moving-average', 'max',
+  '1pct', '2pct', '3pct', '4pct', '5pct',
+  '6pct', '7pct', '8pct', '9pct', '10pct',
+  '11pct', '12pct', '13pct', '14pct', '15pct',
+  '16pct', '17pct', '18pct', '19pct', '20pct',
+  '21pct', '22pct', '23pct', '24pct', '25pct',
+  '26pct', '27pct', '28pct', '29pct', '30pct',
+  '31pct', '32pct', '33pct', '34pct', '35pct',
+  '36pct', '37pct', '38pct', '39pct', '40pct',
+  '41pct', '42pct', '43pct', '44pct', '45pct',
+  '46pct', '47pct', '48pct', '49pct', '50pct',
+  '51pct', '52pct', '53pct', '54pct', '55pct',
+  '56pct', '57pct', '58pct', '59pct', '60pct',
+  '61pct', '62pct', '63pct', '64pct', '65pct',
+  '66pct', '67pct', '68pct', '69pct', '70pct',
+  '71pct', '72pct', '73pct', '74pct', '75pct',
+  '76pct', '77pct', '78pct', '79pct', '80pct',
+  '81pct', '82pct', '83pct', '84pct', '85pct',
+  '86pct', '87pct', '88pct', '89pct', '90pct',
+  '91pct', '92pct', '93pct', '94pct', '95pct',
+  '96pct', '97pct', '98pct', '99pct']. Required.
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against. Required.
+
+``-m <METRICS>, --metrics <METRICS>``
+  Metric to evaluate against. Required.
+
+.. _ceilometer_alarm-gnocchi-aggregation-by-metrics-threshold-update:
+
+ceilometer alarm-gnocchi-aggregation-by-metrics-threshold-update
+----------------------------------------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-gnocchi-aggregation-by-metrics-threshold-update
+          [--name <NAME>] [--project-id <ALARM_PROJECT_ID>]
+          [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>]
+          [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}]
+          [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>]
+          [--insufficient-data-action <Webhook URL>]
+          [--time-constraint <Time Constraint>] [--repeat-actions {True|False}]
+          [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>]
+          [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>]
+          [--threshold <THRESHOLD>] [-m <METRICS>]
+          [--remove-time-constraint <Constraint names>]
+          [<ALARM_ID>]
+
+Update an existing alarm based on computed statistics.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to update.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--granularity <GRANULARITY>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--aggregation-method <AGGREATION>``
+  Aggregation method to use, one of: ['last',
+  'min', 'median', 'sum', 'std', 'first',
+  'mean', 'count', 'moving-average', 'max',
+  '1pct', '2pct', '3pct', '4pct', '5pct',
+  '6pct', '7pct', '8pct', '9pct', '10pct',
+  '11pct', '12pct', '13pct', '14pct', '15pct',
+  '16pct', '17pct', '18pct', '19pct', '20pct',
+  '21pct', '22pct', '23pct', '24pct', '25pct',
+  '26pct', '27pct', '28pct', '29pct', '30pct',
+  '31pct', '32pct', '33pct', '34pct', '35pct',
+  '36pct', '37pct', '38pct', '39pct', '40pct',
+  '41pct', '42pct', '43pct', '44pct', '45pct',
+  '46pct', '47pct', '48pct', '49pct', '50pct',
+  '51pct', '52pct', '53pct', '54pct', '55pct',
+  '56pct', '57pct', '58pct', '59pct', '60pct',
+  '61pct', '62pct', '63pct', '64pct', '65pct',
+  '66pct', '67pct', '68pct', '69pct', '70pct',
+  '71pct', '72pct', '73pct', '74pct', '75pct',
+  '76pct', '77pct', '78pct', '79pct', '80pct',
+  '81pct', '82pct', '83pct', '84pct', '85pct',
+  '86pct', '87pct', '88pct', '89pct', '90pct',
+  '91pct', '92pct', '93pct', '94pct', '95pct',
+  '96pct', '97pct', '98pct', '99pct'].
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against.
+
+``-m <METRICS>, --metrics <METRICS>``
+  Metric to evaluate against.
+
+``--remove-time-constraint <Constraint names>``
+  Name or list of names of the time constraints
+  to remove.
+
+.. _ceilometer_alarm-gnocchi-aggregation-by-resources-threshold-create:
+
+ceilometer alarm-gnocchi-aggregation-by-resources-threshold-create
+------------------------------------------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-gnocchi-aggregation-by-resources-threshold-create
+          --name <NAME> [--project-id <ALARM_PROJECT_ID>]
+          [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>]
+          [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}]
+          [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>]
+          [--insufficient-data-action <Webhook URL>]
+          [--time-constraint <Time Constraint>] [--repeat-actions {True|False}]
+          [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>]
+          --aggregation-method <AGGREATION> [--comparison-operator <OPERATOR>]
+          --threshold <THRESHOLD> -m <METRIC> --resource-type <RESOURCE_TYPE>
+          --query <QUERY>
+
+Create a new alarm based on computed statistics.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+  Required.
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--granularity <GRANULARITY>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--aggregation-method <AGGREATION>``
+  Aggregation method to use, one of: ['last',
+  'min', 'median', 'sum', 'std', 'first',
+  'mean', 'count', 'moving-average', 'max',
+  '1pct', '2pct', '3pct', '4pct', '5pct',
+  '6pct', '7pct', '8pct', '9pct', '10pct',
+  '11pct', '12pct', '13pct', '14pct', '15pct',
+  '16pct', '17pct', '18pct', '19pct', '20pct',
+  '21pct', '22pct', '23pct', '24pct', '25pct',
+  '26pct', '27pct', '28pct', '29pct', '30pct',
+  '31pct', '32pct', '33pct', '34pct', '35pct',
+  '36pct', '37pct', '38pct', '39pct', '40pct',
+  '41pct', '42pct', '43pct', '44pct', '45pct',
+  '46pct', '47pct', '48pct', '49pct', '50pct',
+  '51pct', '52pct', '53pct', '54pct', '55pct',
+  '56pct', '57pct', '58pct', '59pct', '60pct',
+  '61pct', '62pct', '63pct', '64pct', '65pct',
+  '66pct', '67pct', '68pct', '69pct', '70pct',
+  '71pct', '72pct', '73pct', '74pct', '75pct',
+  '76pct', '77pct', '78pct', '79pct', '80pct',
+  '81pct', '82pct', '83pct', '84pct', '85pct',
+  '86pct', '87pct', '88pct', '89pct', '90pct',
+  '91pct', '92pct', '93pct', '94pct', '95pct',
+  '96pct', '97pct', '98pct', '99pct']. Required.
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against. Required.
+
+``-m <METRIC>, --metric <METRIC>``
+  Metric to evaluate against. Required.
+
+``--resource-type <RESOURCE_TYPE>``
+  Resource_type to evaluate against. Required.
+
+``--query <QUERY>``
+  Gnocchi resources search query filter
+  Required.
+
+.. _ceilometer_alarm-gnocchi-aggregation-by-resources-threshold-update:
+
+ceilometer alarm-gnocchi-aggregation-by-resources-threshold-update
+------------------------------------------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-gnocchi-aggregation-by-resources-threshold-update
+          [--name <NAME>] [--project-id <ALARM_PROJECT_ID>]
+          [--user-id <ALARM_USER_ID>] [--description <DESCRIPTION>]
+          [--state <STATE>] [--severity <SEVERITY>] [--enabled {True|False}]
+          [--alarm-action <Webhook URL>] [--ok-action <Webhook URL>]
+          [--insufficient-data-action <Webhook URL>]
+          [--time-constraint <Time Constraint>] [--repeat-actions {True|False}]
+          [--granularity <GRANULARITY>] [--evaluation-periods <COUNT>]
+          [--aggregation-method <AGGREATION>] [--comparison-operator <OPERATOR>]
+          [--threshold <THRESHOLD>] [-m <METRIC>]
+          [--resource-type <RESOURCE_TYPE>] [--query <QUERY>]
+          [--remove-time-constraint <Constraint names>]
+          [<ALARM_ID>]
+
+Update an existing alarm based on computed statistics.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to update.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--granularity <GRANULARITY>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--aggregation-method <AGGREATION>``
+  Aggregation method to use, one of: ['last',
+  'min', 'median', 'sum', 'std', 'first',
+  'mean', 'count', 'moving-average', 'max',
+  '1pct', '2pct', '3pct', '4pct', '5pct',
+  '6pct', '7pct', '8pct', '9pct', '10pct',
+  '11pct', '12pct', '13pct', '14pct', '15pct',
+  '16pct', '17pct', '18pct', '19pct', '20pct',
+  '21pct', '22pct', '23pct', '24pct', '25pct',
+  '26pct', '27pct', '28pct', '29pct', '30pct',
+  '31pct', '32pct', '33pct', '34pct', '35pct',
+  '36pct', '37pct', '38pct', '39pct', '40pct',
+  '41pct', '42pct', '43pct', '44pct', '45pct',
+  '46pct', '47pct', '48pct', '49pct', '50pct',
+  '51pct', '52pct', '53pct', '54pct', '55pct',
+  '56pct', '57pct', '58pct', '59pct', '60pct',
+  '61pct', '62pct', '63pct', '64pct', '65pct',
+  '66pct', '67pct', '68pct', '69pct', '70pct',
+  '71pct', '72pct', '73pct', '74pct', '75pct',
+  '76pct', '77pct', '78pct', '79pct', '80pct',
+  '81pct', '82pct', '83pct', '84pct', '85pct',
+  '86pct', '87pct', '88pct', '89pct', '90pct',
+  '91pct', '92pct', '93pct', '94pct', '95pct',
+  '96pct', '97pct', '98pct', '99pct'].
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against.
+
+``-m <METRIC>, --metric <METRIC>``
+  Metric to evaluate against.
+
+``--resource-type <RESOURCE_TYPE>``
+  Resource_type to evaluate against.
+
+``--query <QUERY>``
+  Gnocchi resources search query filter
+
+``--remove-time-constraint <Constraint names>``
+  Name or list of names of the time constraints
+  to remove.
+
+.. _ceilometer_alarm-gnocchi-resources-threshold-create:
+
+ceilometer alarm-gnocchi-resources-threshold-create
+---------------------------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-gnocchi-resources-threshold-create --name <NAME>
+                                                              [--project-id <ALARM_PROJECT_ID>]
+                                                              [--user-id <ALARM_USER_ID>]
+                                                              [--description <DESCRIPTION>]
+                                                              [--state <STATE>]
+                                                              [--severity <SEVERITY>]
+                                                              [--enabled {True|False}]
+                                                              [--alarm-action <Webhook URL>]
+                                                              [--ok-action <Webhook URL>]
+                                                              [--insufficient-data-action <Webhook URL>]
+                                                              [--time-constraint <Time Constraint>]
+                                                              [--repeat-actions {True|False}]
+                                                              [--granularity <GRANULARITY>]
+                                                              [--evaluation-periods <COUNT>]
+                                                              --aggregation-method
+                                                              <AGGREATION>
+                                                              [--comparison-operator <OPERATOR>]
+                                                              --threshold
+                                                              <THRESHOLD> -m
+                                                              <METRIC>
+                                                              --resource-type
+                                                              <RESOURCE_TYPE>
+                                                              --resource-id
+                                                              <RESOURCE_ID>
+
+Create a new alarm based on computed statistics.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+  Required.
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--granularity <GRANULARITY>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--aggregation-method <AGGREATION>``
+  Aggregation method to use, one of: ['last',
+  'min', 'median', 'sum', 'std', 'first',
+  'mean', 'count', 'moving-average', 'max',
+  '1pct', '2pct', '3pct', '4pct', '5pct',
+  '6pct', '7pct', '8pct', '9pct', '10pct',
+  '11pct', '12pct', '13pct', '14pct', '15pct',
+  '16pct', '17pct', '18pct', '19pct', '20pct',
+  '21pct', '22pct', '23pct', '24pct', '25pct',
+  '26pct', '27pct', '28pct', '29pct', '30pct',
+  '31pct', '32pct', '33pct', '34pct', '35pct',
+  '36pct', '37pct', '38pct', '39pct', '40pct',
+  '41pct', '42pct', '43pct', '44pct', '45pct',
+  '46pct', '47pct', '48pct', '49pct', '50pct',
+  '51pct', '52pct', '53pct', '54pct', '55pct',
+  '56pct', '57pct', '58pct', '59pct', '60pct',
+  '61pct', '62pct', '63pct', '64pct', '65pct',
+  '66pct', '67pct', '68pct', '69pct', '70pct',
+  '71pct', '72pct', '73pct', '74pct', '75pct',
+  '76pct', '77pct', '78pct', '79pct', '80pct',
+  '81pct', '82pct', '83pct', '84pct', '85pct',
+  '86pct', '87pct', '88pct', '89pct', '90pct',
+  '91pct', '92pct', '93pct', '94pct', '95pct',
+  '96pct', '97pct', '98pct', '99pct']. Required.
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against. Required.
+
+``-m <METRIC>, --metric <METRIC>``
+  Metric to evaluate against. Required.
+
+``--resource-type <RESOURCE_TYPE>``
+  Resource_type to evaluate against. Required.
+
+``--resource-id <RESOURCE_ID>``
+  Resource id to evaluate against Required.
+
+.. _ceilometer_alarm-gnocchi-resources-threshold-update:
+
+ceilometer alarm-gnocchi-resources-threshold-update
+---------------------------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-gnocchi-resources-threshold-update [--name <NAME>]
+                                                              [--project-id <ALARM_PROJECT_ID>]
+                                                              [--user-id <ALARM_USER_ID>]
+                                                              [--description <DESCRIPTION>]
+                                                              [--state <STATE>]
+                                                              [--severity <SEVERITY>]
+                                                              [--enabled {True|False}]
+                                                              [--alarm-action <Webhook URL>]
+                                                              [--ok-action <Webhook URL>]
+                                                              [--insufficient-data-action <Webhook URL>]
+                                                              [--time-constraint <Time Constraint>]
+                                                              [--repeat-actions {True|False}]
+                                                              [--granularity <GRANULARITY>]
+                                                              [--evaluation-periods <COUNT>]
+                                                              [--aggregation-method <AGGREATION>]
+                                                              [--comparison-operator <OPERATOR>]
+                                                              [--threshold <THRESHOLD>]
+                                                              [-m <METRIC>]
+                                                              [--resource-type <RESOURCE_TYPE>]
+                                                              [--resource-id <RESOURCE_ID>]
+                                                              [--remove-time-constraint <Constraint names>]
+                                                              [<ALARM_ID>]
+
+Update an existing alarm based on computed statistics.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to update.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--granularity <GRANULARITY>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--aggregation-method <AGGREATION>``
+  Aggregation method to use, one of: ['last',
+  'min', 'median', 'sum', 'std', 'first',
+  'mean', 'count', 'moving-average', 'max',
+  '1pct', '2pct', '3pct', '4pct', '5pct',
+  '6pct', '7pct', '8pct', '9pct', '10pct',
+  '11pct', '12pct', '13pct', '14pct', '15pct',
+  '16pct', '17pct', '18pct', '19pct', '20pct',
+  '21pct', '22pct', '23pct', '24pct', '25pct',
+  '26pct', '27pct', '28pct', '29pct', '30pct',
+  '31pct', '32pct', '33pct', '34pct', '35pct',
+  '36pct', '37pct', '38pct', '39pct', '40pct',
+  '41pct', '42pct', '43pct', '44pct', '45pct',
+  '46pct', '47pct', '48pct', '49pct', '50pct',
+  '51pct', '52pct', '53pct', '54pct', '55pct',
+  '56pct', '57pct', '58pct', '59pct', '60pct',
+  '61pct', '62pct', '63pct', '64pct', '65pct',
+  '66pct', '67pct', '68pct', '69pct', '70pct',
+  '71pct', '72pct', '73pct', '74pct', '75pct',
+  '76pct', '77pct', '78pct', '79pct', '80pct',
+  '81pct', '82pct', '83pct', '84pct', '85pct',
+  '86pct', '87pct', '88pct', '89pct', '90pct',
+  '91pct', '92pct', '93pct', '94pct', '95pct',
+  '96pct', '97pct', '98pct', '99pct'].
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against.
+
+``-m <METRIC>, --metric <METRIC>``
+  Metric to evaluate against.
+
+``--resource-type <RESOURCE_TYPE>``
+  Resource_type to evaluate against.
+
+``--resource-id <RESOURCE_ID>``
+  Resource id to evaluate against
+
+``--remove-time-constraint <Constraint names>``
+  Name or list of names of the time constraints
+  to remove.
+
+.. _ceilometer_alarm-history:
+
+ceilometer alarm-history
+------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-history [-q <QUERY>] [<ALARM_ID>]
+
+Display the change history of an alarm.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm for which history is shown.
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+.. _ceilometer_alarm-list:
+
+ceilometer alarm-list
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-list [-q <QUERY>]
+
+List the user's alarms.
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+.. _ceilometer_alarm-show:
+
+ceilometer alarm-show
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-show [<ALARM_ID>]
+
+Show an alarm.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to show.
+
+.. _ceilometer_alarm-state-get:
+
+ceilometer alarm-state-get
+--------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-state-get [<ALARM_ID>]
+
+Get the state of an alarm.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm state to show.
+
+.. _ceilometer_alarm-state-set:
+
+ceilometer alarm-state-set
+--------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-state-set --state <STATE> [<ALARM_ID>]
+
+Set the state of an alarm.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm state to set.
+
+**Optional arguments:**
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm', 'insufficient
+  data']. Required.
+
+.. _ceilometer_alarm-threshold-create:
+
+ceilometer alarm-threshold-create
+---------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-threshold-create --name <NAME>
+                                            [--project-id <ALARM_PROJECT_ID>]
+                                            [--user-id <ALARM_USER_ID>]
+                                            [--description <DESCRIPTION>]
+                                            [--state <STATE>]
+                                            [--severity <SEVERITY>]
+                                            [--enabled {True|False}]
+                                            [--alarm-action <Webhook URL>]
+                                            [--ok-action <Webhook URL>]
+                                            [--insufficient-data-action <Webhook URL>]
+                                            [--time-constraint <Time Constraint>]
+                                            [--repeat-actions {True|False}] -m
+                                            <METRIC> [--period <PERIOD>]
+                                            [--evaluation-periods <COUNT>]
+                                            [--statistic <STATISTIC>]
+                                            [--comparison-operator <OPERATOR>]
+                                            --threshold <THRESHOLD> [-q <QUERY>]
+
+Create a new alarm based on computed statistics.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+  Required.
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``-m <METRIC>, --meter-name <METRIC>``
+  Metric to evaluate against. Required.
+
+``--period <PERIOD>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--statistic <STATISTIC>``
+  Statistic to evaluate, one of: ['max', 'min',
+  'avg', 'sum', 'count'].
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against. Required.
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+.. _ceilometer_alarm-threshold-update:
+
+ceilometer alarm-threshold-update
+---------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer alarm-threshold-update [--name <NAME>]
+                                            [--project-id <ALARM_PROJECT_ID>]
+                                            [--user-id <ALARM_USER_ID>]
+                                            [--description <DESCRIPTION>]
+                                            [--state <STATE>]
+                                            [--severity <SEVERITY>]
+                                            [--enabled {True|False}]
+                                            [--alarm-action <Webhook URL>]
+                                            [--ok-action <Webhook URL>]
+                                            [--insufficient-data-action <Webhook URL>]
+                                            [--time-constraint <Time Constraint>]
+                                            [--repeat-actions {True|False}]
+                                            [--remove-time-constraint <Constraint names>]
+                                            [-m <METRIC>] [--period <PERIOD>]
+                                            [--evaluation-periods <COUNT>]
+                                            [--statistic <STATISTIC>]
+                                            [--comparison-operator <OPERATOR>]
+                                            [--threshold <THRESHOLD>]
+                                            [-q <QUERY>]
+                                            [<ALARM_ID>]
+
+Update an existing alarm based on computed statistics.
+
+**Positional arguments:**
+
+``<ALARM_ID>``
+  ID of the alarm to update.
+
+**Optional arguments:**
+
+``--name <NAME>``
+  Name of the alarm (must be unique per tenant).
+
+``--project-id <ALARM_PROJECT_ID>``
+  Tenant to associate with alarm (configurable
+  by admin users only).
+
+``--user-id <ALARM_USER_ID>``
+  User to associate with alarm (configurable by
+  admin users only).
+
+``--description <DESCRIPTION>``
+  Free text description of the alarm.
+
+``--state <STATE>``
+  State of the alarm, one of: ['ok', 'alarm',
+  'insufficient data']
+
+``--severity <SEVERITY>``
+  Severity of the alarm, one of: ['low',
+  'moderate', 'critical']
+
+``--enabled {True|False}``
+  True if alarm evaluation/actioning is enabled.
+
+``--alarm-action <Webhook URL>``
+  URL to invoke when state transitions to alarm.
+  May be used multiple times. Defaults to None.
+
+``--ok-action <Webhook URL>``
+  URL to invoke when state transitions to OK.
+  May be used multiple times. Defaults to None.
+
+``--insufficient-data-action <Webhook URL>``
+  URL to invoke when state transitions to
+  insufficient data. May be used multiple times.
+  Defaults to None.
+
+``--time-constraint <Time Constraint>``
+  Only evaluate the alarm if the time at
+  evaluation is within this time constraint.
+  Start point(s) of the constraint are specified
+  with a cron expression, whereas its duration
+  is given in seconds. Can be specified multiple
+  times for multiple time constraints, format
+  is: name=<CONSTRAINT_NAME>;start=<CRON>;durati
+  on=<SECONDS>;[description=<DESCRIPTION>;[timez
+  one=<IANA Timezone>]] Defaults to None.
+
+``--repeat-actions {True|False}``
+  True if actions should be repeatedly notified
+  while alarm remains in target state.
+
+``--remove-time-constraint <Constraint names>``
+  Name or list of names of the time constraints
+  to remove.
+
+``-m <METRIC>, --meter-name <METRIC>``
+  Metric to evaluate against.
+
+``--period <PERIOD>``
+  Length of each period (seconds) to evaluate
+  over.
+
+``--evaluation-periods <COUNT>``
+  Number of periods to evaluate over.
+
+``--statistic <STATISTIC>``
+  Statistic to evaluate, one of: ['max', 'min',
+  'avg', 'sum', 'count'].
+
+``--comparison-operator <OPERATOR>``
+  Operator to compare with, one of: ['lt', 'le',
+  'eq', 'ne', 'ge', 'gt'].
+
+``--threshold <THRESHOLD>``
+  Threshold to evaluate against.
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+.. _ceilometer_capabilities:
+
+ceilometer capabilities
+-----------------------
+
+.. code-block:: console
+
+   usage: ceilometer capabilities
+
+Print Ceilometer capabilities.
+
+.. _ceilometer_event-list:
+
+ceilometer event-list
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer event-list [-q <QUERY>] [--no-traits] [-l <NUMBER>]
+
+List events.
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float or datetime.
+
+``--no-traits``
+  If specified, traits will not be printed.
+
+``-l <NUMBER>, --limit <NUMBER>``
+  Maximum number of events to return. API server
+  limits result to <default_api_return_limit>
+  rows if no limit provided. Option is
+  configured in ceilometer.conf [api] group
+
+.. _ceilometer_event-show:
+
+ceilometer event-show
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer event-show <message_id>
+
+Show a particular event.
+
+**Positional arguments:**
+
+``<message_id>``
+  The ID of the event. Should be a UUID.
+
+.. _ceilometer_event-type-list:
+
+ceilometer event-type-list
+--------------------------
+
+.. code-block:: console
+
+   usage: ceilometer event-type-list
+
+List event types.
+
+.. _ceilometer_meter-list:
+
+ceilometer meter-list
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer meter-list [-q <QUERY>] [-l <NUMBER>]
+                                [--unique {True|False}]
+
+List the user's meters.
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+``-l <NUMBER>, --limit <NUMBER>``
+  Maximum number of meters to return. API server
+  limits result to <default_api_return_limit>
+  rows if no limit provided. Option is
+  configured in ceilometer.conf [api] group
+
+``--unique {True|False}``
+  Retrieves unique list of meters.
+
+.. _ceilometer_query-alarm-history:
+
+ceilometer query-alarm-history
+------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer query-alarm-history [-f <FILTER>] [-o <ORDERBY>]
+                                         [-l <LIMIT>]
+
+Query Alarm History.
+
+**Optional arguments:**
+
+``-f <FILTER>, --filter <FILTER>``
+  {complex_op: [{simple_op: {field_name:
+  value}}]} The complex_op is one of: ['and',
+  'or'], simple_op is one of: ['=', '!=', '<',
+  '<=', '>', '>='].
+
+``-o <ORDERBY>, --orderby <ORDERBY>``
+  [{field_name: direction}, {field_name:
+  direction}] The direction is one of: ['asc',
+  'desc'].
+
+``-l <LIMIT>, --limit <LIMIT>``
+  Maximum number of alarm history items to
+  return. API server limits result to
+  <default_api_return_limit> rows if no limit
+  provided. Option is configured in
+  ceilometer.conf [api] group
+
+.. _ceilometer_query-alarms:
+
+ceilometer query-alarms
+-----------------------
+
+.. code-block:: console
+
+   usage: ceilometer query-alarms [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
+
+Query Alarms.
+
+**Optional arguments:**
+
+``-f <FILTER>, --filter <FILTER>``
+  {complex_op: [{simple_op: {field_name:
+  value}}]} The complex_op is one of: ['and',
+  'or'], simple_op is one of: ['=', '!=', '<',
+  '<=', '>', '>='].
+
+``-o <ORDERBY>, --orderby <ORDERBY>``
+  [{field_name: direction}, {field_name:
+  direction}] The direction is one of: ['asc',
+  'desc'].
+
+``-l <LIMIT>, --limit <LIMIT>``
+  Maximum number of alarms to return. API server
+  limits result to <default_api_return_limit>
+  rows if no limit provided. Option is
+  configured in ceilometer.conf [api] group
+
+.. _ceilometer_query-samples:
+
+ceilometer query-samples
+------------------------
+
+.. code-block:: console
+
+   usage: ceilometer query-samples [-f <FILTER>] [-o <ORDERBY>] [-l <LIMIT>]
+
+Query samples.
+
+**Optional arguments:**
+
+``-f <FILTER>, --filter <FILTER>``
+  {complex_op: [{simple_op: {field_name:
+  value}}]} The complex_op is one of: ['and',
+  'or'], simple_op is one of: ['=', '!=', '<',
+  '<=', '>', '>='].
+
+``-o <ORDERBY>, --orderby <ORDERBY>``
+  [{field_name: direction}, {field_name:
+  direction}] The direction is one of: ['asc',
+  'desc'].
+
+``-l <LIMIT>, --limit <LIMIT>``
+  Maximum number of samples to return. API
+  server limits result to
+  <default_api_return_limit> rows if no limit
+  provided. Option is configured in
+  ceilometer.conf [api] group
+
+.. _ceilometer_resource-list:
+
+ceilometer resource-list
+------------------------
+
+.. code-block:: console
+
+   usage: ceilometer resource-list [-q <QUERY>] [-l <NUMBER>]
+
+List the resources.
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+``-l <NUMBER>, --limit <NUMBER>``
+  Maximum number of resources to return. API
+  server limits result to
+  <default_api_return_limit> rows if no limit
+  provided. Option is configured in
+  ceilometer.conf [api] group
+
+.. _ceilometer_resource-show:
+
+ceilometer resource-show
+------------------------
+
+.. code-block:: console
+
+   usage: ceilometer resource-show <RESOURCE_ID>
+
+Show the resource.
+
+**Positional arguments:**
+
+``<RESOURCE_ID>``
+  ID of the resource to show.
+
+.. _ceilometer_sample-create:
+
+ceilometer sample-create
+------------------------
+
+.. code-block:: console
+
+   usage: ceilometer sample-create [--project-id <SAMPLE_PROJECT_ID>]
+                                   [--user-id <SAMPLE_USER_ID>] -r <RESOURCE_ID>
+                                   -m <METER_NAME> --meter-type <METER_TYPE>
+                                   --meter-unit <METER_UNIT> --sample-volume
+                                   <SAMPLE_VOLUME>
+                                   [--resource-metadata <RESOURCE_METADATA>]
+                                   [--timestamp <TIMESTAMP>] [--direct <DIRECT>]
+
+Create a sample.
+
+**Optional arguments:**
+
+``--project-id <SAMPLE_PROJECT_ID>``
+  Tenant to associate with sample (configurable
+  by admin users only).
+
+``--user-id <SAMPLE_USER_ID>``
+  User to associate with sample (configurable by
+  admin users only).
+
+``-r <RESOURCE_ID>, --resource-id <RESOURCE_ID>``
+  ID of the resource. Required.
+
+``-m <METER_NAME>, --meter-name <METER_NAME>``
+  The meter name. Required.
+
+``--meter-type <METER_TYPE>``
+  The meter type. Required.
+
+``--meter-unit <METER_UNIT>``
+  The meter unit. Required.
+
+``--sample-volume <SAMPLE_VOLUME>``
+  The sample volume. Required.
+
+``--resource-metadata <RESOURCE_METADATA>``
+  Resource metadata. Provided value should be a
+  set of key-value pairs e.g. {"key":"value"}.
+
+``--timestamp <TIMESTAMP>``
+  The sample timestamp.
+
+``--direct <DIRECT>``
+  Post sample to storage directly. Defaults to
+  False.
+
+.. _ceilometer_sample-create-list:
+
+ceilometer sample-create-list
+-----------------------------
+
+.. code-block:: console
+
+   usage: ceilometer sample-create-list [--direct <DIRECT>] <SAMPLES_LIST>
+
+Create a sample list.
+
+**Positional arguments:**
+
+``<SAMPLES_LIST>``
+  Json array with samples to create.
+
+**Optional arguments:**
+
+``--direct <DIRECT>``
+  Post samples to storage directly. Defaults to False.
+
+.. _ceilometer_sample-list:
+
+ceilometer sample-list
+----------------------
+
+.. code-block:: console
+
+   usage: ceilometer sample-list [-q <QUERY>] [-m <NAME>] [-l <NUMBER>]
+
+List the samples (return OldSample objects if -m/--meter is set).
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+``-m <NAME>, --meter <NAME>``
+  Name of meter to show samples for.
+
+``-l <NUMBER>, --limit <NUMBER>``
+  Maximum number of samples to return. API
+  server limits result to
+  <default_api_return_limit> rows if no limit
+  provided. Option is configured in
+  ceilometer.conf [api] group
+
+.. _ceilometer_sample-show:
+
+ceilometer sample-show
+----------------------
+
+.. code-block:: console
+
+   usage: ceilometer sample-show <SAMPLE_ID>
+
+Show a sample.
+
+**Positional arguments:**
+
+``<SAMPLE_ID>``
+  ID (aka message ID) of the sample to show.
+
+.. _ceilometer_statistics:
+
+ceilometer statistics
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer statistics [-q <QUERY>] -m <NAME> [-p <PERIOD>] [-g <FIELD>]
+                                [-a <FUNC>[<-<PARAM>]]
+
+List the statistics for a meter.
+
+**Optional arguments:**
+
+``-q <QUERY>, --query <QUERY>``
+  key[op]data_type::value; list. data_type is
+  optional, but if supplied must be string,
+  integer, float, or boolean.
+
+``-m <NAME>, --meter <NAME>``
+  Name of meter to list statistics for.
+  Required.
+
+``-p <PERIOD>, --period <PERIOD>``
+  Period in seconds over which to group samples.
+
+``-g <FIELD>, --groupby <FIELD>``
+  Field for group by.
+
+``-a <FUNC>[<-<PARAM>], --aggregate <FUNC>[<-<PARAM>]``
+  Function for data aggregation. Available
+  aggregates are: count, cardinality, min, max,
+  sum, stddev, avg. Defaults to [].
+
+.. _ceilometer_trait-description-list:
+
+ceilometer trait-description-list
+---------------------------------
+
+.. code-block:: console
+
+   usage: ceilometer trait-description-list -e <EVENT_TYPE>
+
+List trait info for an event type.
+
+**Optional arguments:**
+
+``-e <EVENT_TYPE>, --event_type <EVENT_TYPE>``
+  Type of the event for which traits will be
+  shown. Required.
+
+.. _ceilometer_trait-list:
+
+ceilometer trait-list
+---------------------
+
+.. code-block:: console
+
+   usage: ceilometer trait-list -e <EVENT_TYPE> -t <TRAIT_NAME>
+
+List all traits with name <trait_name> for Event Type <event_type>.
+
+**Optional arguments:**
+
+``-e <EVENT_TYPE>, --event_type <EVENT_TYPE>``
+  Type of the event for which traits will
+  listed. Required.
+
+``-t <TRAIT_NAME>, --trait_name <TRAIT_NAME>``
+  The name of the trait to list. Required.
+
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 7fdbb121..82bd8f51 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -24,6 +24,17 @@ Contents:
    ref/index
    ref/v2/index
 
+The command-line client
+=======================
+
+The ceilometer client is the command-line interface (CLI) for
+the Telemetry Data Collection service (ceilometer) API
+and its extensions.
+
+.. toctree::
+
+   cli
+
 Contributing
 ============