第 19 章 TDBaaS (时间序列数据库即服务)命令行客户端


gnocchi 客户端是命令行界面(CLI),用于 A 时间序列存储和资源索引服务 API 及其扩展。本章记录了 gnocchi 版本 2.0.0。
有关特定 gnocchi 命令的帮助信息,请输入:
$ gnocchi help COMMAND

19.1. Gnocchi usage

usage: gnocchi [--version] [-v] [--log-file LOG_FILE] [-q] [-h] [--debug] [--os-region-name <auth-region-name>] [--os-interface <interface>] [--gnocchi-api-version GNOCCHI_API_VERSION] [--insecure] [--os-cacert <ca-certificate>] [--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>] [--os-auth-type <name>] [--os-auth-url OS_AUTH_URL] [--os-domain-id OS_DOMAIN_ID] [--os-domain-name OS_DOMAIN_NAME] [--os-project-id OS_PROJECT_ID] [--os-project-name OS_PROJECT_NAME] [--os-project-domain-id OS_PROJECT_DOMAIN_ID] [--os-project-domain-name OS_PROJECT_DOMAIN_NAME] [--os-trust-id OS_TRUST_ID] [--os-user-id OS_USER_ID] [--os-user-name OS_USERNAME] [--os-user-domain-id OS_USER_DOMAIN_ID] [--os-user-domain-name OS_USER_DOMAIN_NAME] [--os-password OS_PASSWORD] [--gnocchi-endpoint <endpoint>]

19.2. Gnocchi 可选参数

--version
显示程序的版本号并退出
-v, --verbose
提高输出的详细程度。可以重复。
--log-file LOG_FILE
指定要记录输出的文件。默认禁用此选项。
-q, --quiet
抑制输出,除了警告和错误外。
-h, --help
显示帮助消息并退出。
--debug
显示错误的回溯。
--os-region-name <auth-region-name>
身份验证区域名称(Env: OS_REGION_NAME)
--os-interface <interface>
选择接口类型。有效的接口类型: [admin, public, internal]。(env: OS_INTERFACE)
--gnocchi-api-version GNOCCHI_API_VERSION
默认为 env[GNOCCHI_API_VERSION] 或 1。
--insecure
明确允许客户端执行"不安全"TLS (https)请求。服务器的证书不会针对任何证书颁发机构进行验证。这个选项应谨慎使用。
--os-cacert <ca-certificate>
指定用于验证 TLS (https)服务器证书中使用的 CA 捆绑包文件。默认为 env[OS_CACERT]。
--os-cert <certificate>
默认为 env[OS_CERT]。
--os-key <key>
默认为 env[OS_KEY]。
--timeout <seconds>
设置请求超时(以秒为单位)。
--os-auth-type <name>, --os-auth-plugin <name>
要使用的身份验证类型
--gnocchi-endpoint <endpoint>
GNOCCHI_ENDPOINT 端点(Env: GNOCCHI_ENDPOINT)

19.3. gnocchi archive-policy create

usage: gnocchi archive-policy create [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [-b BACK_WINDOW] [-m AGGREGATION_METHODS] -d <DEFINITION> name
创建归档策略

positional 参数

名称
归档策略的名称

可选参数

-h, --help
显示帮助信息并退出
-b BACK_WINDOW, --back-window BACK_WINDOW
归档策略的后端窗口
-M AGGREGATION_METHODS, --aggregation-method AGGREGATION_METHODS
归档策略的聚合方法
-d <DEFINITION>, --definition <DEFINITION>
归档策略定义的两个属性(以 ',' 分隔),其名称和值用 ':' 分隔。

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.4. gnocchi archive-policy delete

usage: gnocchi archive-policy delete [-h] name
删除归档策略

positional 参数

名称
归档策略的名称

可选参数

-h, --help
显示帮助信息并退出

19.5. gnocchi archive-policy list

usage: gnocchi archive-policy list [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}]
列出归档策略

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.6. gnocchi archive-policy-rule create

usage: gnocchi archive-policy-rule create [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] -a ARCHIVE_POLICY_NAME -m METRIC_PATTERN name
创建归档策略规则

positional 参数

名称
运行名称

可选参数

-h, --help
显示帮助信息并退出
-a ARCHIVE_POLICY_NAME, --archive-policy-name ARCHIVE_POLICY_NAME
归档策略名称
-m METRIC_PATTERN, --metric-pattern METRIC_PATTERN
要匹配的指标名称的通配符

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.7. gnocchi archive-policy-rule delete

usage: gnocchi archive-policy-rule delete [-h] name
删除归档策略规则

positional 参数

名称
归档策略规则的名称

可选参数

-h, --help
显示帮助信息并退出

19.8. gnocchi archive-policy-rule list

usage: gnocchi archive-policy-rule list [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}]
列出归档策略规则

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.9. gnocchi archive-policy-rule 显示

usage: gnocchi archive-policy-rule show [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] name
显示归档策略规则

positional 参数

名称
归档策略规则的名称

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.10. gnocchi archive-policy show

usage: gnocchi archive-policy show [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] name
显示归档策略

positional 参数

名称
归档策略的名称

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.11. Gnocchi 基准措施添加

usage: gnocchi benchmark measures add [-h] [--resource-id RESOURCE_ID] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--workers WORKERS] --count COUNT [--batch BATCH] [--timestamp-start TIMESTAMP_START] [--timestamp-end TIMESTAMP_END] metric
对添加测量进行基准测试

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
--workers WORKERS, -w WORKERS
要使用的 worker 数量
--count COUNT, -n COUNT
要发送的总测量结果数
--batch BATCH, -b BATCH
每个批处理中要发送的测量结果数
--timestamp-start TIMESTAMP_START, -s TIMESTAMP_START
使用的第一个时间戳
--timestamp-end TIMESTAMP_END, -e TIMESTAMP_END
使用的最后一个时间戳

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.12. Gnocchi 基准措施显示

usage: gnocchi benchmark measures show [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--resource-id RESOURCE_ID] [--aggregation AGGREGATION] [--start START] [--stop STOP] [--workers WORKERS] --count COUNT metric
对测量进行基准测试显示

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
--aggregation AGGREGATION
用于检索的聚合
--start START
周期开始
--stop STOP
周期结束
--workers WORKERS, -w WORKERS
要使用的 worker 数量
--count COUNT, -n COUNT
要发送的总测量结果数

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.13. Gnocchi 基准指标创建

usage: gnocchi benchmark metric create [-h] [--resource-id RESOURCE_ID] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--archive-policy-name ARCHIVE_POLICY_NAME] [--workers WORKERS] --count COUNT [--keep]
对指标创建进行基准测试

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME
归档策略的名称
--workers WORKERS, -w WORKERS
要使用的 worker 数量
--count COUNT, -n COUNT
要创建的指标数
--keep, -k
保留创建的指标

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.14. Gnocchi 基准指标显示

usage: gnocchi benchmark metric show [-h] [--resource-id RESOURCE_ID] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--workers WORKERS] --count COUNT metric [metric ...]
指标数据的基准测试是否显示

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
--workers WORKERS, -w WORKERS
要使用的 worker 数量
--count COUNT, -n COUNT
获取的指标数

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.15. Gnocchi capabilities list

usage: gnocchi capabilities list [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX]
列出功能

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.16. Gnocchi measure add

usage: gnocchi measures add [-h] [--resource-id RESOURCE_ID] -m MEASURE metric
为指标添加测量

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
-m MEASURE, --measure MEASURE
使用 '@' 分隔的测量的时间戳和值

19.17. Gnocchi 测量聚合

usage: gnocchi measures aggregation [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}] -m METRIC [METRIC ...] [--aggregation AGGREGATION] [--start START] [--stop STOP] [--needed-overlap NEEDED_OVERLAP] [--query QUERY]
获取聚合指标的测量

可选参数

-h, --help
显示帮助信息并退出
-M METRIC [METRIC ...],--metric METRIC [METRIC [METRIC ...]
指标 ID 或指标名称
--aggregation AGGREGATION
用于检索的聚合
--start START
周期开始
--stop STOP
周期结束
--needed-overlap NEEDED_OVERLAP
每个指标中所需的数据点百分比
--query QUERY
查询

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.18. Gnocchi 测量显示

usage: gnocchi measures show [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}] [--resource-id RESOURCE_ID] [--aggregation AGGREGATION] [--start START] [--stop STOP] metric
获取指标的测量

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
--aggregation AGGREGATION
用于检索的聚合
--start START
周期开始
--stop STOP
周期结束

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.19. gnocchi 指标创建

usage: gnocchi metric create [-h] [--resource-id RESOURCE_ID] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--archive-policy-name ARCHIVE_POLICY_NAME] [METRIC_NAME]
创建指标

positional 参数

METRIC_NAME
指标的名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID
--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME
归档策略的名称

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.20. Gnocchi 指标删除

usage: gnocchi metric delete [-h] [--resource-id RESOURCE_ID] metric [metric ...]
删除指标

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID

19.21. Gnocchi 指标列表

usage: gnocchi metric list [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}]
列出指标

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.22. Gnocchi 指标显示

usage: gnocchi metric show [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--resource-id RESOURCE_ID] metric
显示指标

positional 参数

metric
指标的 ID 或名称

可选参数

-h, --help
显示帮助信息并退出
--resource-id RESOURCE_ID, -r RESOURCE_ID
资源的 ID

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.23. Gnocchi 资源创建

usage: gnocchi resource create [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--type RESOURCE_TYPE] [-a ATTRIBUTE] [-m ADD_METRIC] [-n CREATE_METRIC] [-d DELETE_METRIC] resource_id
创建资源

positional 参数

resource_id
资源的 ID

可选参数

-h, --help
显示帮助信息并退出
--type RESOURCE_TYPE, -t RESOURCE_TYPE
资源类型
-a ATTRIBUTE, --attribute ATTRIBUTE
使用 ':' 分隔的属性的名称和值
-m ADD_METRIC, --add-metric ADD_METRIC
要添加的指标的 name:id
-n CREATE_METRIC, --create-metric CREATE_METRIC
name:archive_policy_name of a metric created
-d DELETE_METRIC, --delete-metric DELETE_METRIC
要删除的指标的名称

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.24. Gnocchi 资源删除

usage: gnocchi resource delete [-h] resource_id
删除资源

positional 参数

resource_id
资源的 ID

可选参数

-h, --help
显示帮助信息并退出

19.25. Gnocchi 资源历史记录

usage: gnocchi resource history [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}] [--details] [--limit <LIMIT>] [--marker <MARKER>] [--sort <SORT>] [--type RESOURCE_TYPE] resource_id
显示资源的历史记录

positional 参数

resource_id
资源的 ID

可选参数

-h, --help
显示帮助信息并退出
--details
显示通用资源的所有属性
--limit <LIMIT>
要返回的资源数(默认为服务器默认)
--marker <MARKER>
上一个列表的最后一项。此值后返回下一个结果
--sort <SORT>
资源属性排序(示例:user_id:desc- nullslast
--type RESOURCE_TYPE, -t RESOURCE_TYPE
资源类型

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.26. Gnocchi 资源列表

usage: gnocchi resource list [-h] [-f {csv,html,json,json,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--quote {all,minimal,none,nonnumeric}] [--details] [--history] [--limit <LIMIT>] [--marker <MARKER>] [--sort <SORT>] [--type RESOURCE_TYPE]
列出资源

可选参数

-h, --help
显示帮助信息并退出
--details
显示通用资源的所有属性
--history
显示资源的历史记录
--limit <LIMIT>
要返回的资源数(默认为服务器默认)
--marker <MARKER>
上一个列表的最后一项。此值后返回下一个结果
--sort <SORT>
资源属性排序(示例:user_id:desc- nullslast
--type RESOURCE_TYPE, -t RESOURCE_TYPE
资源类型

输出格式

输出格式选项
-f {csv,html,json,json,table,value,yaml,yaml}, --format {csv,html,json,json,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

CSV 格式:

--quote {all,minimal,none,nonnumeric}
当包含引号时,则默认为非数字

19.28. Gnocchi 资源显示

usage: gnocchi resource show [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--type RESOURCE_TYPE] resource_id
显示资源

positional 参数

resource_id
资源的 ID

可选参数

-h, --help
显示帮助信息并退出
--type RESOURCE_TYPE, -t RESOURCE_TYPE
资源类型

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.29. Gnocchi 资源更新

usage: gnocchi resource update [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX] [--type RESOURCE_TYPE] [-a ATTRIBUTE] [-m ADD_METRIC] [-n CREATE_METRIC] [-d DELETE_METRIC] resource_id
更新资源

positional 参数

resource_id
资源的 ID

可选参数

-h, --help
显示帮助信息并退出
--type RESOURCE_TYPE, -t RESOURCE_TYPE
资源类型
-a ATTRIBUTE, --attribute ATTRIBUTE
使用 ':' 分隔的属性的名称和值
-m ADD_METRIC, --add-metric ADD_METRIC
要添加的指标的 name:id
-n CREATE_METRIC, --create-metric CREATE_METRIC
name:archive_policy_name of a metric created
-d DELETE_METRIC, --delete-metric DELETE_METRIC
要删除的指标的名称

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀

19.30. Gnocchi 状态

usage: gnocchi status [-h] [-f {html,json,json,shell,table,value,yaml,yaml}] [-c COLUMN] [--max-width <integer>] [--noindent] [--prefix PREFIX]
显示测量处理的状态

可选参数

-h, --help
显示帮助信息并退出

输出格式

输出格式选项
-f {html,json,json,shell,table,value,yaml,yaml}, --format {html,json,json,shell,table,value,yaml}
输出格式,默认为 table
-c COLUMN, --column COLUMN
可以重复指定要包含的列

表格式:

--max-width <integer>
最大显示宽度,0 代表禁用

JSON 格式:

--noindent
是否禁用缩进 JSON

shell 格式:

UNIX shell 可以解析的格式(variable="value")
--prefix PREFIX
在所有变量名称中添加前缀
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部