Merge "Update CLI reference for various python client"
This commit is contained in:
Jenkins
Gerrit Code Review
commit
fa97587754
1002
doc/cli-ref-rst/source/designate.rst
Normal file
1002
doc/cli-ref-rst/source/designate.rst
Normal file
File diff suppressed because it is too large
Load Diff
@ -29,9 +29,13 @@ Contents
|
|||||||
magnum
|
magnum
|
||||||
trove
|
trove
|
||||||
trove-misc
|
trove-misc
|
||||||
|
sahara
|
||||||
|
designate
|
||||||
|
monasca
|
||||||
neutron-misc
|
neutron-misc
|
||||||
heat
|
heat
|
||||||
cloudkitty
|
cloudkitty
|
||||||
|
manila
|
||||||
ceilometer
|
ceilometer
|
||||||
gnocchi
|
gnocchi
|
||||||
mistral
|
mistral
|
||||||
|
|||||||
2632
doc/cli-ref-rst/source/manila.rst
Normal file
2632
doc/cli-ref-rst/source/manila.rst
Normal file
File diff suppressed because it is too large
Load Diff
952
doc/cli-ref-rst/source/monasca.rst
Normal file
952
doc/cli-ref-rst/source/monasca.rst
Normal file
@ -0,0 +1,952 @@
|
|||||||
|
.. ## WARNING ######################################
|
||||||
|
.. This file is automatically generated, do not edit
|
||||||
|
.. #################################################
|
||||||
|
|
||||||
|
==============================
|
||||||
|
Monitoring command-line client
|
||||||
|
==============================
|
||||||
|
|
||||||
|
The monasca client is the command-line interface (CLI) for
|
||||||
|
the Monitoring API and its extensions.
|
||||||
|
|
||||||
|
This chapter documents :command:`monasca` version ``1.0.27``.
|
||||||
|
|
||||||
|
For help on a specific :command:`monasca` command, enter:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
$ monasca help COMMAND
|
||||||
|
|
||||||
|
.. _monasca_command_usage:
|
||||||
|
|
||||||
|
monasca usage
|
||||||
|
~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca [-j] [--version] [-d] [-v] [-k] [--cert-file CERT_FILE]
|
||||||
|
[--key-file KEY_FILE] [--os-cacert OS_CACERT]
|
||||||
|
[--keystone_timeout KEYSTONE_TIMEOUT]
|
||||||
|
[--os-username OS_USERNAME] [--os-password OS_PASSWORD]
|
||||||
|
[--os-user-domain-id OS_USER_DOMAIN_ID]
|
||||||
|
[--os-user-domain-name OS_USER_DOMAIN_NAME]
|
||||||
|
[--os-project-id OS_PROJECT_ID]
|
||||||
|
[--os-project-name OS_PROJECT_NAME]
|
||||||
|
[--os-domain-id OS_DOMAIN_ID] [--os-domain-name OS_DOMAIN_NAME]
|
||||||
|
[--os-auth-url OS_AUTH_URL] [--os-region-name OS_REGION_NAME]
|
||||||
|
[--os-auth-token OS_AUTH_TOKEN] [--os-no-client-auth]
|
||||||
|
[--monasca-api-url MONASCA_API_URL]
|
||||||
|
[--monasca-api-version MONASCA_API_VERSION]
|
||||||
|
[--os-service-type OS_SERVICE_TYPE]
|
||||||
|
[--os-endpoint-type OS_ENDPOINT_TYPE]
|
||||||
|
<subcommand> ...
|
||||||
|
<subcommand>
|
||||||
|
alarm-definition-create Create an alarm definition.
|
||||||
|
alarm-definition-delete Delete the alarm definition.
|
||||||
|
alarm-definition-list List alarm definitions for this tenant.
|
||||||
|
alarm-definition-patch Patch the alarm definition.
|
||||||
|
alarm-definition-show Describe the alarm definition.
|
||||||
|
alarm-definition-update Update the alarm definition.
|
||||||
|
alarm-delete Delete the alarm.
|
||||||
|
alarm-history Alarm state transition history.
|
||||||
|
alarm-history-list List alarms state history.
|
||||||
|
alarm-list List alarms for this tenant.
|
||||||
|
alarm-patch Patch the alarm state.
|
||||||
|
alarm-show Describe the alarm.
|
||||||
|
alarm-update Update the alarm state.
|
||||||
|
measurement-list List measurements for the specified metric.
|
||||||
|
metric-create Create metric.
|
||||||
|
metric-create-raw Create metric from raw json body.
|
||||||
|
metric-list List metrics for this tenant.
|
||||||
|
metric-statistics List measurement statistics for the specified
|
||||||
|
metric.
|
||||||
|
notification-create Create notification.
|
||||||
|
notification-delete Delete notification.
|
||||||
|
notification-list List notifications for this tenant.
|
||||||
|
notification-show Describe the notification.
|
||||||
|
notification-update Update notification.
|
||||||
|
bash-completion Prints all of the commands and options to stdout.
|
||||||
|
help Display help about this program or one of its
|
||||||
|
subcommands.
|
||||||
|
|
||||||
|
.. _monasca_command_options:
|
||||||
|
|
||||||
|
monasca optional arguments
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
``-j, --json``
|
||||||
|
output raw json response
|
||||||
|
|
||||||
|
``--version``
|
||||||
|
Shows the client version and exits.
|
||||||
|
|
||||||
|
``-d, --debug``
|
||||||
|
Defaults to ``env[MONASCA_DEBUG]``.
|
||||||
|
|
||||||
|
``-v, --verbose``
|
||||||
|
Print more verbose output.
|
||||||
|
|
||||||
|
``-k, --insecure``
|
||||||
|
Explicitly allow the client to perform "insecure"
|
||||||
|
SSL (https) requests. The server's certificate
|
||||||
|
will not be verified against any certificate
|
||||||
|
authorities. This option should be used with
|
||||||
|
caution.
|
||||||
|
|
||||||
|
``--cert-file CERT_FILE``
|
||||||
|
Path of certificate file to use in SSL
|
||||||
|
connection. This file can optionally be prepended
|
||||||
|
with the private key.
|
||||||
|
|
||||||
|
``--key-file KEY_FILE``
|
||||||
|
Path of client key to use in SSL connection. This
|
||||||
|
option is not necessary if your key is prepended
|
||||||
|
to your cert file.
|
||||||
|
|
||||||
|
``--os-cacert OS_CACERT``
|
||||||
|
Specify a CA bundle file to use in verifying a
|
||||||
|
TLS (https) server certificate. Defaults to
|
||||||
|
``env[OS_CACERT]``. Without either of these, the
|
||||||
|
client looks for the default system CA
|
||||||
|
certificates.
|
||||||
|
|
||||||
|
``--keystone_timeout KEYSTONE_TIMEOUT``
|
||||||
|
Number of seconds to wait for a response from
|
||||||
|
keystone.
|
||||||
|
|
||||||
|
``--os-username OS_USERNAME``
|
||||||
|
Defaults to ``env[OS_USERNAME]``.
|
||||||
|
|
||||||
|
``--os-password OS_PASSWORD``
|
||||||
|
Defaults to ``env[OS_PASSWORD]``.
|
||||||
|
|
||||||
|
``--os-user-domain-id OS_USER_DOMAIN_ID``
|
||||||
|
Defaults to ``env[OS_USER_DOMAIN_ID]``.
|
||||||
|
|
||||||
|
``--os-user-domain-name OS_USER_DOMAIN_NAME``
|
||||||
|
Defaults to ``env[OS_USER_DOMAIN_NAME]``.
|
||||||
|
|
||||||
|
``--os-project-id OS_PROJECT_ID``
|
||||||
|
Defaults to ``env[OS_PROJECT_ID]``.
|
||||||
|
|
||||||
|
``--os-project-name OS_PROJECT_NAME``
|
||||||
|
Defaults to ``env[OS_PROJECT_NAME]``.
|
||||||
|
|
||||||
|
``--os-domain-id OS_DOMAIN_ID``
|
||||||
|
Defaults to ``env[OS_DOMAIN_ID]``.
|
||||||
|
|
||||||
|
``--os-domain-name OS_DOMAIN_NAME``
|
||||||
|
Defaults to ``env[OS_DOMAIN_NAME]``.
|
||||||
|
|
||||||
|
``--os-auth-url OS_AUTH_URL``
|
||||||
|
Defaults to ``env[OS_AUTH_URL]``.
|
||||||
|
|
||||||
|
``--os-region-name OS_REGION_NAME``
|
||||||
|
Defaults to ``env[OS_REGION_NAME]``.
|
||||||
|
|
||||||
|
``--os-auth-token OS_AUTH_TOKEN``
|
||||||
|
Defaults to ``env[OS_AUTH_TOKEN]``.
|
||||||
|
|
||||||
|
``--os-no-client-auth``
|
||||||
|
Do not contact keystone for a token. Defaults to
|
||||||
|
``env[OS_NO_CLIENT_AUTH]``.
|
||||||
|
|
||||||
|
``--monasca-api-url MONASCA_API_URL``
|
||||||
|
Defaults to ``env[MONASCA_API_URL]``.
|
||||||
|
|
||||||
|
``--monasca-api-version MONASCA_API_VERSION``
|
||||||
|
Defaults to ``env[MONASCA_API_VERSION]`` or 2_0
|
||||||
|
|
||||||
|
``--os-service-type OS_SERVICE_TYPE``
|
||||||
|
Defaults to ``env[OS_SERVICE_TYPE]``.
|
||||||
|
|
||||||
|
``--os-endpoint-type OS_ENDPOINT_TYPE``
|
||||||
|
Defaults to ``env[OS_ENDPOINT_TYPE]``.
|
||||||
|
|
||||||
|
.. _monasca_alarm-definition-create:
|
||||||
|
|
||||||
|
monasca alarm-definition-create
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-definition-create [--description <DESCRIPTION>]
|
||||||
|
[--severity <SEVERITY>]
|
||||||
|
[--match-by <DIMENSION_KEY1,DIMENSION_KEY2,...>]
|
||||||
|
[--alarm-actions <NOTIFICATION-ID>]
|
||||||
|
[--ok-actions <NOTIFICATION-ID>]
|
||||||
|
[--undetermined-actions <NOTIFICATION-ID>]
|
||||||
|
<ALARM_DEFINITION_NAME> <EXPRESSION>
|
||||||
|
|
||||||
|
Create an alarm definition.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_DEFINITION_NAME>``
|
||||||
|
Name of the alarm definition to create.
|
||||||
|
|
||||||
|
``<EXPRESSION>``
|
||||||
|
The alarm expression to evaluate. Quoted.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--description <DESCRIPTION>``
|
||||||
|
Description of the alarm.
|
||||||
|
|
||||||
|
``--severity <SEVERITY>``
|
||||||
|
Severity is one of [LOW, MEDIUM, HIGH, CRITICAL].
|
||||||
|
|
||||||
|
``--match-by <DIMENSION_KEY1,DIMENSION_KEY2,...>``
|
||||||
|
The metric dimensions to match to the alarm
|
||||||
|
dimensions. One or more dimension key names separated
|
||||||
|
by a comma. Key names need quoting when they contain
|
||||||
|
special chars [&,(,),{,},>,<] that confuse the CLI
|
||||||
|
parser.
|
||||||
|
|
||||||
|
``--alarm-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
ALARM. This param may be specified multiple times.
|
||||||
|
|
||||||
|
``--ok-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
OK. This param may be specified multiple times.
|
||||||
|
|
||||||
|
``--undetermined-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
UNDETERMINED. This param may be specified multiple
|
||||||
|
times.
|
||||||
|
|
||||||
|
.. _monasca_alarm-definition-delete:
|
||||||
|
|
||||||
|
monasca alarm-definition-delete
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-definition-delete <ALARM_DEFINITION_ID>
|
||||||
|
|
||||||
|
Delete the alarm definition.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_DEFINITION_ID>``
|
||||||
|
The ID of the alarm definition.
|
||||||
|
|
||||||
|
.. _monasca_alarm-definition-list:
|
||||||
|
|
||||||
|
monasca alarm-definition-list
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-definition-list [--name <ALARM_DEFINITION_NAME>]
|
||||||
|
[--dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>]
|
||||||
|
|
||||||
|
List alarm definitions for this tenant.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--name <ALARM_DEFINITION_NAME>``
|
||||||
|
Name of the alarm definition.
|
||||||
|
|
||||||
|
``--dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to specify a metric dimension.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
.. _monasca_alarm-definition-patch:
|
||||||
|
|
||||||
|
monasca alarm-definition-patch
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-definition-patch [--name <ALARM_DEFINITION_NAME>]
|
||||||
|
[--description <DESCRIPTION>]
|
||||||
|
[--expression <EXPRESSION>]
|
||||||
|
[--alarm-actions <NOTIFICATION-ID>]
|
||||||
|
[--ok-actions <NOTIFICATION-ID>]
|
||||||
|
[--undetermined-actions <NOTIFICATION-ID>]
|
||||||
|
[--actions-enabled <ACTIONS-ENABLED>]
|
||||||
|
[--severity <SEVERITY>]
|
||||||
|
<ALARM_DEFINITION_ID>
|
||||||
|
|
||||||
|
Patch the alarm definition.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_DEFINITION_ID>``
|
||||||
|
The ID of the alarm definition.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--name <ALARM_DEFINITION_NAME>``
|
||||||
|
Name of the alarm definition.
|
||||||
|
|
||||||
|
``--description <DESCRIPTION>``
|
||||||
|
Description of the alarm.
|
||||||
|
|
||||||
|
``--expression <EXPRESSION>``
|
||||||
|
The alarm expression to evaluate. Quoted.
|
||||||
|
|
||||||
|
``--alarm-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
ALARM. This param may be specified multiple times.
|
||||||
|
|
||||||
|
``--ok-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
OK. This param may be specified multiple times.
|
||||||
|
|
||||||
|
``--undetermined-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
UNDETERMINED. This param may be specified multiple
|
||||||
|
times.
|
||||||
|
|
||||||
|
``--actions-enabled <ACTIONS-ENABLED>``
|
||||||
|
The actions-enabled boolean is one of [true,false]
|
||||||
|
|
||||||
|
``--severity <SEVERITY>``
|
||||||
|
Severity is one of [LOW, MEDIUM, HIGH, CRITICAL].
|
||||||
|
|
||||||
|
.. _monasca_alarm-definition-show:
|
||||||
|
|
||||||
|
monasca alarm-definition-show
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-definition-show <ALARM_DEFINITION_ID>
|
||||||
|
|
||||||
|
Describe the alarm definition.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_DEFINITION_ID>``
|
||||||
|
The ID of the alarm definition.
|
||||||
|
|
||||||
|
.. _monasca_alarm-definition-update:
|
||||||
|
|
||||||
|
monasca alarm-definition-update
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-definition-update [--description <DESCRIPTION>]
|
||||||
|
[--alarm-actions <NOTIFICATION-ID>]
|
||||||
|
[--ok-actions <NOTIFICATION-ID>]
|
||||||
|
[--undetermined-actions <NOTIFICATION-ID>]
|
||||||
|
[--match-by <DIMENSION_KEY1,DIMENSION_KEY2,...>]
|
||||||
|
[--severity <SEVERITY>]
|
||||||
|
<ALARM_DEFINITION_ID>
|
||||||
|
<ALARM_DEFINITION_NAME> <EXPRESSION>
|
||||||
|
<ACTIONS-ENABLED>
|
||||||
|
|
||||||
|
Update the alarm definition.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_DEFINITION_ID>``
|
||||||
|
The ID of the alarm definition.
|
||||||
|
|
||||||
|
``<ALARM_DEFINITION_NAME>``
|
||||||
|
Name of the alarm definition.
|
||||||
|
|
||||||
|
``<EXPRESSION>``
|
||||||
|
The alarm expression to evaluate. Quoted.
|
||||||
|
|
||||||
|
``<ACTIONS-ENABLED>``
|
||||||
|
The actions-enabled boolean is one of [true,false]
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--description <DESCRIPTION>``
|
||||||
|
Description of the alarm.
|
||||||
|
|
||||||
|
``--alarm-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
ALARM. This param may be specified multiple times.
|
||||||
|
|
||||||
|
``--ok-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
OK. This param may be specified multiple times.
|
||||||
|
|
||||||
|
``--undetermined-actions <NOTIFICATION-ID>``
|
||||||
|
The notification method to use when an alarm state is
|
||||||
|
UNDETERMINED. This param may be specified multiple
|
||||||
|
times.
|
||||||
|
|
||||||
|
``--match-by <DIMENSION_KEY1,DIMENSION_KEY2,...>``
|
||||||
|
The metric dimensions to match to the alarm
|
||||||
|
dimensions. One or more dimension key names separated
|
||||||
|
by a comma. Key names need quoting when they contain
|
||||||
|
special chars [&,(,),{,},>,<] that confuse the CLI
|
||||||
|
parser.
|
||||||
|
|
||||||
|
``--severity <SEVERITY>``
|
||||||
|
Severity is one of [LOW, MEDIUM, HIGH, CRITICAL].
|
||||||
|
|
||||||
|
.. _monasca_alarm-delete:
|
||||||
|
|
||||||
|
monasca alarm-delete
|
||||||
|
~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-delete <ALARM_ID>
|
||||||
|
|
||||||
|
Delete the alarm.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_ID>``
|
||||||
|
The ID of the alarm.
|
||||||
|
|
||||||
|
.. _monasca_alarm-history:
|
||||||
|
|
||||||
|
monasca alarm-history
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-history [--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>]
|
||||||
|
<ALARM_ID>
|
||||||
|
|
||||||
|
Alarm state transition history.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_ID>``
|
||||||
|
The ID of the alarm.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
.. _monasca_alarm-history-list:
|
||||||
|
|
||||||
|
monasca alarm-history-list
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-history-list [--dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--starttime <UTC_START_TIME>]
|
||||||
|
[--endtime <UTC_END_TIME>]
|
||||||
|
[--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>]
|
||||||
|
|
||||||
|
List alarms state history.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to specify a metric dimension.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--starttime <UTC_START_TIME>``
|
||||||
|
measurements >= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z. OR format: -120 (for previous 2
|
||||||
|
hours)
|
||||||
|
|
||||||
|
``--endtime <UTC_END_TIME>``
|
||||||
|
measurements <= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z.
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
.. _monasca_alarm-list:
|
||||||
|
|
||||||
|
monasca alarm-list
|
||||||
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-list [--alarm-definition-id <ALARM_DEFINITION_ID>]
|
||||||
|
[--metric-name <METRIC_NAME>]
|
||||||
|
[--metric-dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--state <ALARM_STATE>]
|
||||||
|
[--state-updated-start-time <UTC_STATE_UPDATED_START>]
|
||||||
|
[--lifecycle-state <LIFECYCLE_STATE>]
|
||||||
|
[--link <LINK>] [--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>]
|
||||||
|
|
||||||
|
List alarms for this tenant.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--alarm-definition-id <ALARM_DEFINITION_ID>``
|
||||||
|
The ID of the alarm definition.
|
||||||
|
|
||||||
|
``--metric-name <METRIC_NAME>``
|
||||||
|
Name of the metric.
|
||||||
|
|
||||||
|
``--metric-dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to specify a metric dimension.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--state <ALARM_STATE>``
|
||||||
|
ALARM_STATE is one of [UNDETERMINED, OK, ALARM].
|
||||||
|
|
||||||
|
``--state-updated-start-time <UTC_STATE_UPDATED_START>``
|
||||||
|
Return all alarms whose state was updated on or after
|
||||||
|
the time specified
|
||||||
|
|
||||||
|
``--lifecycle-state <LIFECYCLE_STATE>``
|
||||||
|
The lifecycle state of the alarm
|
||||||
|
|
||||||
|
``--link <LINK>``
|
||||||
|
The link to external data associated with the alarm
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
.. _monasca_alarm-patch:
|
||||||
|
|
||||||
|
monasca alarm-patch
|
||||||
|
~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-patch [--state <ALARM_STATE>]
|
||||||
|
[--lifecycle-state <LIFECYCLE_STATE>]
|
||||||
|
[--link <LINK>]
|
||||||
|
<ALARM_ID>
|
||||||
|
|
||||||
|
Patch the alarm state.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_ID>``
|
||||||
|
The ID of the alarm.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--state <ALARM_STATE>``
|
||||||
|
ALARM_STATE is one of [UNDETERMINED, OK, ALARM].
|
||||||
|
|
||||||
|
``--lifecycle-state <LIFECYCLE_STATE>``
|
||||||
|
The lifecycle state of the alarm
|
||||||
|
|
||||||
|
``--link <LINK>``
|
||||||
|
A link to an external resource with information about
|
||||||
|
the alarm
|
||||||
|
|
||||||
|
.. _monasca_alarm-show:
|
||||||
|
|
||||||
|
monasca alarm-show
|
||||||
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-show <ALARM_ID>
|
||||||
|
|
||||||
|
Describe the alarm.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_ID>``
|
||||||
|
The ID of the alarm.
|
||||||
|
|
||||||
|
.. _monasca_alarm-update:
|
||||||
|
|
||||||
|
monasca alarm-update
|
||||||
|
~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca alarm-update <ALARM_ID> <ALARM_STATE> <LIFECYCLE_STATE> <LINK>
|
||||||
|
|
||||||
|
Update the alarm state.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<ALARM_ID>``
|
||||||
|
The ID of the alarm.
|
||||||
|
|
||||||
|
``<ALARM_STATE>``
|
||||||
|
ALARM_STATE is one of [UNDETERMINED, OK, ALARM].
|
||||||
|
|
||||||
|
``<LIFECYCLE_STATE>``
|
||||||
|
The lifecycle state of the alarm
|
||||||
|
|
||||||
|
``<LINK>``
|
||||||
|
A link to an external resource with information about the
|
||||||
|
alarm
|
||||||
|
|
||||||
|
.. _monasca_measurement-list:
|
||||||
|
|
||||||
|
monasca measurement-list
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca measurement-list [--dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--endtime <UTC_END_TIME>]
|
||||||
|
[--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>] [--merge_metrics]
|
||||||
|
<METRIC_NAME> <UTC_START_TIME>
|
||||||
|
|
||||||
|
List measurements for the specified metric.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<METRIC_NAME>``
|
||||||
|
Name of the metric to list measurements.
|
||||||
|
|
||||||
|
``<UTC_START_TIME>``
|
||||||
|
measurements >= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z. OR Format: -120 (previous 120
|
||||||
|
minutes
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to specify a metric dimension.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--endtime <UTC_END_TIME>``
|
||||||
|
measurements <= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z.
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
``--merge_metrics``
|
||||||
|
Merge multiple metrics into a single result.
|
||||||
|
|
||||||
|
.. _monasca_metric-create:
|
||||||
|
|
||||||
|
monasca metric-create
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca metric-create [--dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--value-meta <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--time <UNIX_TIMESTAMP>]
|
||||||
|
[--project-id <CROSS_PROJECT_ID>]
|
||||||
|
<METRIC_NAME> <METRIC_VALUE>
|
||||||
|
|
||||||
|
Create metric.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<METRIC_NAME>``
|
||||||
|
Name of the metric to create.
|
||||||
|
|
||||||
|
``<METRIC_VALUE>``
|
||||||
|
Metric value.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to create a metric dimension. This
|
||||||
|
can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--value-meta <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair for extra information about a value.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. value_meta need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--time <UNIX_TIMESTAMP>``
|
||||||
|
Metric timestamp in milliseconds. Default: current
|
||||||
|
timestamp.
|
||||||
|
|
||||||
|
``--project-id <CROSS_PROJECT_ID>``
|
||||||
|
The Project ID to create metric on behalf of. Requires
|
||||||
|
monitoring-delegate role in keystone.
|
||||||
|
|
||||||
|
.. _monasca_metric-create-raw:
|
||||||
|
|
||||||
|
monasca metric-create-raw
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca metric-create-raw <JSON_BODY>
|
||||||
|
|
||||||
|
Create metric from raw json body.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<JSON_BODY>``
|
||||||
|
The raw JSON body in single quotes. See api doc.
|
||||||
|
|
||||||
|
.. _monasca_metric-list:
|
||||||
|
|
||||||
|
monasca metric-list
|
||||||
|
~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca metric-list [--name <METRIC_NAME>]
|
||||||
|
[--dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--starttime <UTC_START_TIME>]
|
||||||
|
[--endtime <UTC_END_TIME>]
|
||||||
|
[--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>]
|
||||||
|
|
||||||
|
List metrics for this tenant.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--name <METRIC_NAME>``
|
||||||
|
Name of the metric to list.
|
||||||
|
|
||||||
|
``--dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to specify a metric dimension.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--starttime <UTC_START_TIME>``
|
||||||
|
measurements >= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z. OR Format: -120 (previous 120
|
||||||
|
minutes
|
||||||
|
|
||||||
|
``--endtime <UTC_END_TIME>``
|
||||||
|
measurements <= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z.
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
.. _monasca_metric-statistics:
|
||||||
|
|
||||||
|
monasca metric-statistics
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca metric-statistics [--dimensions <KEY1=VALUE1,KEY2=VALUE2...>]
|
||||||
|
[--endtime <UTC_END_TIME>]
|
||||||
|
[--period <PERIOD>]
|
||||||
|
[--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>] [--merge_metrics]
|
||||||
|
<METRIC_NAME> <STATISTICS> <UTC_START_TIME>
|
||||||
|
|
||||||
|
List measurement statistics for the specified metric.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<METRIC_NAME>``
|
||||||
|
Name of the metric to report measurement statistics.
|
||||||
|
|
||||||
|
``<STATISTICS>``
|
||||||
|
Statistics is one or more (separated by commas) of
|
||||||
|
[AVG, MIN, MAX, COUNT, SUM].
|
||||||
|
|
||||||
|
``<UTC_START_TIME>``
|
||||||
|
measurements >= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z. OR Format: -120 (previous 120
|
||||||
|
minutes
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--dimensions <KEY1=VALUE1,KEY2=VALUE2...>``
|
||||||
|
key value pair used to specify a metric dimension.
|
||||||
|
This can be specified multiple times, or once with
|
||||||
|
parameters separated by a comma. Dimensions need
|
||||||
|
quoting when they contain special chars
|
||||||
|
[&,(,),{,},>,<] that confuse the CLI parser.
|
||||||
|
|
||||||
|
``--endtime <UTC_END_TIME>``
|
||||||
|
measurements <= UTC time. format:
|
||||||
|
2014-01-01T00:00:00Z.
|
||||||
|
|
||||||
|
``--period <PERIOD>``
|
||||||
|
number of seconds per interval (default is 300)
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
``--merge_metrics``
|
||||||
|
Merge multiple metrics into a single result.
|
||||||
|
|
||||||
|
.. _monasca_notification-create:
|
||||||
|
|
||||||
|
monasca notification-create
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca notification-create <NOTIFICATION_NAME> <TYPE> <ADDRESS>
|
||||||
|
|
||||||
|
Create notification.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<NOTIFICATION_NAME>``
|
||||||
|
Name of the notification to create.
|
||||||
|
|
||||||
|
``<TYPE>``
|
||||||
|
The notification type. Type must be EMAIL, WEBHOOK, or
|
||||||
|
PAGERDUTY.
|
||||||
|
|
||||||
|
``<ADDRESS>``
|
||||||
|
A valid EMAIL Address, URL, or SERVICE KEY
|
||||||
|
|
||||||
|
.. _monasca_notification-delete:
|
||||||
|
|
||||||
|
monasca notification-delete
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca notification-delete <NOTIFICATION_ID>
|
||||||
|
|
||||||
|
Delete notification.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<NOTIFICATION_ID>``
|
||||||
|
The ID of the notification.
|
||||||
|
|
||||||
|
.. _monasca_notification-list:
|
||||||
|
|
||||||
|
monasca notification-list
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca notification-list [--offset <OFFSET LOCATION>]
|
||||||
|
[--limit <RETURN LIMIT>]
|
||||||
|
|
||||||
|
List notifications for this tenant.
|
||||||
|
|
||||||
|
Optional arguments
|
||||||
|
------------------
|
||||||
|
|
||||||
|
``--offset <OFFSET LOCATION>``
|
||||||
|
The offset used to paginate the return data.
|
||||||
|
|
||||||
|
``--limit <RETURN LIMIT>``
|
||||||
|
The amount of data to be returned up to the API
|
||||||
|
maximum limit.
|
||||||
|
|
||||||
|
.. _monasca_notification-show:
|
||||||
|
|
||||||
|
monasca notification-show
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca notification-show <NOTIFICATION_ID>
|
||||||
|
|
||||||
|
Describe the notification.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<NOTIFICATION_ID>``
|
||||||
|
The ID of the notification. If not specified returns all.
|
||||||
|
|
||||||
|
.. _monasca_notification-update:
|
||||||
|
|
||||||
|
monasca notification-update
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
usage: monasca notification-update <NOTIFICATION_ID> <NOTIFICATION_NAME>
|
||||||
|
<TYPE> <ADDRESS>
|
||||||
|
|
||||||
|
Update notification.
|
||||||
|
|
||||||
|
Positional arguments
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
``<NOTIFICATION_ID>``
|
||||||
|
The ID of the notification.
|
||||||
|
|
||||||
|
``<NOTIFICATION_NAME>``
|
||||||
|
Name of the notification.
|
||||||
|
|
||||||
|
``<TYPE>``
|
||||||
|
The notification type. Type must be either EMAIL,
|
||||||
|
WEBHOOK, or PAGERDUTY.
|
||||||
|
|
||||||
|
``<ADDRESS>``
|
||||||
|
A valid EMAIL Address, URL, or SERVICE KEY
|
||||||
|
|
||||||
1202
doc/cli-ref-rst/source/sahara.rst
Normal file
1202
doc/cli-ref-rst/source/sahara.rst
Normal file
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user