搜索

命令行界面参考

download PDF
Red Hat OpenStack Platform 16.2

Red Hat OpenStack Platform 的命令行客户端

OpenStack Documentation Team

摘要

对统一的 OpenStack 命令行客户端使用的命令的引用。

使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息

对红帽文档提供反馈

我们感谢您对文档提供反馈信息。与我们分享您的成功秘诀。

使用直接文档反馈(DDF)功能

使用 添加反馈 DDF 功能,用于特定句子、段落或代码块上的直接注释。

  1. Multi-page HTML 格式查看文档。
  2. 请确定您看到文档右上角的 反馈 按钮。
  3. 用鼠标指针高亮显示您想评论的文本部分。
  4. 添加反馈
  5. 添加反馈项中输入您的意见。
  6. 可选:添加您的电子邮件地址,以便文档团队可以联系您以讨论您的问题。
  7. Submit

第 1 章 OpenStack 客户端

openstack 客户端是一个通用的 OpenStack 命令行界面(CLI)。本章记录了 openstack 版本 4.0.2 的主要选项。

OpenStack API 的命令行界面

使用方法:

openstack [--version] [-v | -q] [--log-file LOG_FILE] [-h] [--debug]
                 [--os-cloud <cloud-config-name>]
                 [--os-region-name <auth-region-name>]
                 [--os-cacert <ca-bundle-file>] [--os-cert <certificate-file>]
                 [--os-key <key-file>] [--verify | --insecure]
                 [--os-default-domain <auth-domain>]
                 [--os-interface <interface>]
                 [--os-service-provider <service_provider>]
                 [--os-remote-project-name <remote_project_name> | --os-remote-project-id <remote_project_id>]
                 [--os-remote-project-domain-name <remote_project_domain_name> | --os-remote-project-domain-id <remote_project_domain_id>]
                 [--timing] [--os-beta-command] [--os-profile hmac-key]
                 [--os-compute-api-version <compute-api-version>]
                 [--os-identity-api-version <identity-api-version>]
                 [--os-image-api-version <image-api-version>]
                 [--os-network-api-version <network-api-version>]
                 [--os-object-api-version <object-api-version>]
                 [--os-volume-api-version <volume-api-version>]
                 [--os-queues-api-version <queues-api-version>]
                 [--os-database-api-version <database-api-version>]
                 [--os-tripleoclient-api-version <tripleoclient-api-version>]
                 [--os-data-processing-api-version <data-processing-api-version>]
                 [--os-data-processing-url OS_DATA_PROCESSING_URL]
                 [--os-loadbalancer-api-version <loadbalancer-api-version>]
                 [--os-workflow-api-version <workflow-api-version>]
                 [--os-container-infra-api-version <container-infra-api-version>]
                 [--os-baremetal-api-version <baremetal-api-version>]
                 [--inspector-api-version INSPECTOR_API_VERSION]
                 [--inspector-url INSPECTOR_URL]
                 [--os-orchestration-api-version <orchestration-api-version>]
                 [--os-dns-api-version <dns-api-version>]
                 [--os-key-manager-api-version <key-manager-api-version>]
                 [--os-metrics-api-version <metrics-api-version>]
                 [--os-alarming-api-version <alarming-api-version>]
                 [--os-auth-type <auth-type>] [--os-auth-url <auth-auth-url>]
                 [--os-trust-id <auth-trust-id>]
                 [--os-username <auth-username>] [--os-user-id <auth-user-id>]
                 [--os-password <auth-password>]
                 [--os-project-id <auth-project-id>] [--os-roles <auth-roles>]
                 [--os-aodh-endpoint <auth-aodh-endpoint>]
                 [--os-system-scope <auth-system-scope>]
                 [--os-domain-id <auth-domain-id>]
                 [--os-domain-name <auth-domain-name>]
                 [--os-project-name <auth-project-name>]
                 [--os-project-domain-id <auth-project-domain-id>]
                 [--os-project-domain-name <auth-project-domain-name>]
                 [--os-identity-provider <auth-identity-provider>]
                 [--os-protocol <auth-protocol>]
                 [--os-access-token <auth-access-token>]
                 [--os-default-domain-id <auth-default-domain-id>]
                 [--os-default-domain-name <auth-default-domain-name>]
                 [--os-token <auth-token>]
                 [--os-identity-provider-url <auth-identity-provider-url>]
                 [--os-service-provider-endpoint <auth-service-provider-endpoint>]
                 [--os-service-provider-entity-id <auth-service-provider-entity-id>]
                 [--os-user-domain-id <auth-user-domain-id>]
                 [--os-user-domain-name <auth-user-domain-name>]
                 [--os-application-credential-secret <auth-application-credential-secret>]
                 [--os-application-credential-id <auth-application-credential-id>]
                 [--os-application-credential-name <auth-application-credential-name>]
                 [--os-passcode <auth-passcode>]
                 [--os-client-id <auth-client-id>]
                 [--os-client-secret <auth-client-secret>]
                 [--os-openid-scope <auth-openid-scope>]
                 [--os-access-token-endpoint <auth-access-token-endpoint>]
                 [--os-discovery-endpoint <auth-discovery-endpoint>]
                 [--os-access-token-type <auth-access-token-type>]
                 [--os-redirect-uri <auth-redirect-uri>]
                 [--os-code <auth-code>] [--os-endpoint <auth-endpoint>]
                 [--os-auth-methods <auth-auth-methods>]
                 [--os-user <auth-user>]
                 [--os-consumer-key <auth-consumer-key>]
                 [--os-consumer-secret <auth-consumer-secret>]
                 [--os-access-key <auth-access-key>]
                 [--os-access-secret <auth-access-secret>]

表 1.1. 命令参数
概述

--version

显示程序的版本号并退出

-v,--verbose

增加输出的详细程度。可以重复。

-q, --quiet

禁止输出,除了警告和错误。

--log-file LOG_FILE

指定要记录输出的文件。默认禁用。

-h, --help

显示帮助消息并退出。

--debug

显示错误回溯。

--os-cloud <cloud-config-name>

clouds.yaml 中的云名称(env: os_cloud)

--os-region-name <auth-region-name>

身份验证区域名称(env: os_region_name)

--os-cacert <ca-bundle-file>

CA 证书捆绑包文件(env: os_cacert)

--os-cert <certificate-file>

客户端证书捆绑包文件(env: os_cert)

--os-key <key-file>

客户端证书密钥文件(env: os_key)

--verify

验证服务器证书(默认)

--insecure

禁用服务器证书验证

--os-default-domain <auth-domain>

默认域 ID, default=default. (env: OS_DEFAULT_DOMAIN)

--os-interface <interface>

选择一个接口 type. valid interface type: [admin, public, internal]. default=public,(Env: OS_INTERFACE)

--os-service-provider <service_provider>

使用 Keystone-to-keystone 联邦通过身份验证并在服务提供商上执行命令。还必须指定远程项目选项。

--os-remote-project-name <remote_project_name>

如果使用 Keystone-to-rhcs 联邦,在向服务提供商进行身份验证时的项目名称。

--os-remote-project-id <remote_project_id>

如果使用 Keystone-to-rhcs 联邦,在向服务提供商进行身份验证时项目 ID。

--os-remote-project-domain-name <remote_project_domain_name>

如果使用 Keystone-to-Keystone 联邦,则向服务提供商进行身份验证时项目的域名。

--os-remote-project-domain-id <remote_project_domain_id>

如果使用 Keystone-to-Keystone 联邦,在向服务提供商进行身份验证时,项目的域 ID。

--timing

打印 api 调用计时信息

--os-beta-command

启用可能会更改的 beta 命令

--os-profile hmac-key

用于加密性能分析上下文数据的 HMAC 密钥

--os-compute-api-version <compute-api-version>

Compute api version, default=2.1 (env: OS_COMPUTE_API_VERSION)

--os-identity-api-version <identity-api-version>

Identity api version, default=3 (env: OS_IDENTITY_API_VERSION)

--os-image-api-version <image-api-version>

Image api version, default=2 (env: OS_IMAGE_API_VERSION)

--os-network-api-version <network-api-version>

Network api version, default=2.0 (env: OS_NETWORK_API_VERSION)

--os-object-api-version <object-api-version>

对象 api 版本,default=1 (env: OS_OBJECT_API_VERSION)

--os-volume-api-version <volume-api-version>

卷 api 版本,default=3 (env: OS_VOLUME_API_VERSION)

--os-queues-api-version <queues-api-version>

queue api version, default=2 (env: OS_QUEUES_API_VERSION)

--os-database-api-version <database-api-version>

数据库 api 版本,default=1 (env: OS_DATABASE_API_VERSION)

--os-tripleoclient-api-version <tripleoclient-api-version>

tripleo client api version, default=1 (env: OS_TRIPLEOCLIENT_API_VERSION)

--os-data-processing-api-version <data-processing-api-version>

数据处理 api 版本,default=1.1 (env: OS_DATA_PROCESSING_API_VERSION)

--os-data-processing-url OS_DATA_PROCESSING_URL

数据处理 api url,(env: OS_DATA_PROCESSING_API_URL)

--os-loadbalancer-api-version <loadbalancer-api-version>

osc 插件 api 版本, default=2.0 (env: OS_LOADBALANCER_API_VERSION)

--os-workflow-api-version <workflow-api-version>

工作流 api 版本 default=2 (env: OS_WORKFLOW_API_VERSION)

--os-container-infra-api-version <container-infra-api-version>

container-infra api 版本,default=1 (env: OS_CONTAINER_INFRA_API_VERSION)

--os-baremetal-api-version <baremetal-api-version>

裸机 api 版本 default="latest" (客户端和服务器支持的最大版本)。(Env: OS_BAREMETAL_API_VERSION)

--inspector-api-version INSPECTOR_API_VERSION

检查器 api 版本现在只支持 1 (env: INSPECTOR_VERSION)。

--inspector-url INSPECTOR_URL

检查 url,默认为 localhost (env: INSPECTOR_URL)。

--os-orchestration-api-version <orchestration-api-version>

Orchestration api version, default=1 (env: OS_ORCHESTRATION_API_VERSION)

--os-dns-api-version <dns-api-version>

DNS api 版本,default=2 (env: os_dns_api_version)

--os-key-manager-api-version <key-manager-api-version>

barbican api 版本,default=1 (env: OS_KEY_MANAGER_API_VERSION)

--os-metrics-api-version <metrics-api-version>

Metrics api version, default=1 (env: OS_METRICS_API_VERSION)

--os-alarming-api-version <alarming-api-version>

queue api version, default=2 (env: OS_ALARMING_API_VERSION)

--os-auth-type <auth-type>

选择身份验证类型。可用类型: v2password, aodh-noauth, v3oidcaccesstoken, token, v3adfspassword, v3token, v3applicationcredential, v3totp, v3oidcauthcode, noauth, v3multifactor, password, v3password, v3oidcclientcredentials, gnocchi-noauth, v3oidcpassword, v2token, gnocchi- basic, v3tokenlessauth, v1password, v3samlpassword, none, v3oauth1, admin_token.默认:根据 --os-username/--os-token (Env: OS_AUTH_TYPE)选择

--os-auth-url <auth-auth-url>

使用 v2password: 使用 v3oidcaccesstoken 验证 url: 使用令牌进行身份验证 URL: 使用 v3adfspassword 进行身份验证 URL: 使用 v3token 进行身份验证 URL: 使用 v3applicationcredential 进行身份验证 URL: 使用 v3totp 进行身份验证 URL: 使用 v3oidcauthcode 进行身份验证 URL: 使用 v3multifactor 进行身份验证 URL: 使用密码进行身份验证 URL: 使用 v3password 进行身份验证 URL: 使用 v3oidcclientcredentials 进行身份验证 URL: 使用 v3oidcpassword 进行身份验证 URL: 使用 v2token 进行身份验证 URL: 使用 v3tokenlessauth 进行身份验证 URL: 使用 v1password 进行身份验证 URL: 使用 v3samlpassword 进行身份验证 URL: 使用 v3oauth1 进行身份验证 URL: 身份验证 URL (Env: OS_AUTH_URL)

--os-trust-id <auth-trust-id>

使用 v2password: trust id with v3oidcaccesstoken: 带有令牌的信任 ID: 带有 v3adfspassword 的信任 ID: 使用 v3token 的信任 ID: 带有 v3applicationcredential 的信任 ID: 带有 v3totp 的信任 ID: 带有 v3oidcauthcode 的信任 ID: 带有 v3multifactor 的信任 ID: 带有密码的信任 ID: 使用 v3password 的信任 ID: 带有 v3oidcclientcredentials 的信任 ID: 带有 v3oidcpassword 的信任 ID: 使用 v2token 的信任 ID: 带有 v3samlpassword 的信任 ID: 信任 ID (Env : os_TRUST_ID)

--os-username <auth-username>

使用 v2password: username 来使用 v3adfspassword: Username with v3applicationcredential: Username with v3totp: Username with password: Username with v3password: Username with v3oidcpassword: Username with v1password: Username to login with v3samlpassword: Username (Env: OS_USERNAME)

--os-user-id <auth-user-id>

使用 v2password: 用户 ID 来使用 aodh- noauth: User ID with v3applicationcredential: User ID with v3totp: User ID with noauth: User ID with password: User id with v3password: User ID with gnocchi-noauth: User ID (Env: OS_USER_ID)

--os-password <auth-password>

使用 v2password: 密码用于 v3adfspassword: Password with password: User's password with v3password: User's password with v3oidcpassword: Password With v1password: Password to use with v3samlpassword: Password (Env: OS_PASSWORD)

--os-project-id <auth-project-id>

使用 aodh-noauth: project id with v3oidcaccesstoken: 项目 ID 的范围为具有令牌: 项目 ID 的范围为 v3adfspassword: 项目 ID 的范围为 v3token: 项目 ID 的范围为 v3applicationcredential: 项目 ID 的范围为 v3totp: 项目 ID 的范围为 v3oidcauthcode: 项目 ID 的范围为没有身份验证: 带有 v3multifactor 的项目 ID: 项目 ID 的范围为使用密码: 项目 ID 的范围为 v3password: 项目 ID 的范围为 v3oidcclientcredentials: 项目 ID 的范围为使用 gnocchi-noauth : 带有 v3oidcpassword 的项目 ID: 项目 ID 的范围为 v3tokenlessauth: 项目 ID 的范围为 v3samlpassword: 范围的项目 ID (Env: os_PROJECT_ID)

--os-roles <auth-roles>

使用 aodh-noauth: 角色,带有 gnocchi-noauth: 角色(Env: OS_ROLES)

--os-aodh-endpoint <auth-aodh-endpoint>

使用 aodh-noauth: aodh 端点(env: OS_AODH_ENDPOINT)

--os-system-scope <auth-system-scope>

使用 v3oidcaccesstoken: 对使用令牌的系统操作的范围: 使用 v3adfspassword 的系统操作范围: 使用 v3token 的系统操作范围: 使用 v3applicationcredential 的系统操作范围: 使用 v3totp 的系统操作范围: 使用 v3oidcauthcode 的系统操作范围: 使用 v3multifactor 的系统操作范围: 使用密码的系统操作范围: 使用 v3password 的系统操作范围: 使用 v3oidcclientcredentials 的系统操作范围: 使用 v3oidcpassword 的系统操作范围: 使用 v3samlpassword 的系统操作范围: 系统操作范围(Env: os_SYSTEM_SCOPE)

--os-domain-id <auth-domain-id>

使用 v3oidcaccesstoken: domain id to scope to with token: 的范围为使用 v3adfspassword 的域 ID: 的范围为 v3token 的域 ID: 域 ID 的范围为 v3applicationcredential: 的范围为 v3 到tp 的域 ID: 的范围为 v3oidcauthcode 的范围 ID: 域 ID 的范围为使用 v3multifactor: 域 ID 的范围为使用密码: 的范围为 v3password 的域 ID: 域 ID 的范围为 v3oidcclientcredentials: 的范围为 v3oidcpassword 的域 ID: 的范围为使用 v3tokenlessauth 的域 ID: 的范围限制为使用 v3samlpassword 的域 ID: 范围到的域 ID (Env : os_DOMAIN_ID)

--os-domain-name <auth-domain-name>

使用 v3oidcaccesstoken:使用令牌范围到的域名: 范围为 v3adfspassword 的域名: 范围为 v3token 的域名: 范围为 v3applicationcredential 的域名: 范围为 v3totp 的域名: 范围为 v3oidcauthcode 的域名: 范围为使用 v3multifactor 的域名: 范围为使用密码的域名: 范围为使用 v3password 的域名: 范围为 v3oidcclientcredentials 的域名: 范围为 v3oidcpassword 的域名: 范围为 v3tokenlessauth 的域名: 范围为 v3samlpassword 的域名: 范围到的域名(Env : OS_DOMAIN_NAME)

--os-project-name <auth-project-name>

使用 v3oidcaccesstoken: 项目名称,范围为使用令牌: 的范围为 v3adfspassword 的项目名称: 的范围为 v3token 的项目名称: 的范围为 v3applicationcredential 的项目名称: 的范围为 v3totp 的项目名称: 的范围为 v3oidcauthcode 的项目名称: 的范围为使用 v3multifactor 的项目名称: 的范围为使用密码的项目名称: 的范围为 v3password 的项目名称: 的范围为 v3oidcclientcredentials 的项目名称: 的范围为 v3oidcpassword 的项目名称: 的范围为 v3tokenlessauth 的项目名称: 的范围为 v1password 的项目名称: 用于 v3samlpassword 的 Swift 帐户: 范围到的项目名称(Env: os_PROJECT_NAME)

--os-project-domain-id <auth-project-domain-id>

使用 v3oidcaccesstoken: 包含带有令牌的项目的域 ID: 包含使用 v3adfspassword 的项目的域 ID: 包含使用 v3token 的项目的域 ID: 包含带有 v3applicationcredential 的项目的域 ID: 包含带有 v3totp 的项目的域 ID: 包含带有 v3oidcauthcode 的项目的域 ID: 包含带有 v3multifactor 的项目的域 ID: 包含带有密码的项目的域 ID: 包含使用 v3password 的项目的域 ID: 包含带有 v3oidcclientcredentials 的项目的域 ID: 包含带有 v3oidcpassword 的项目的域 ID: 包含使用 v3tokenlessauth 的项目的域 ID: 包含使用 v3samlpassword 的项目的域 ID: 包含项目的域 ID (Env : os_PROJECT_DOMAIN_ID)

--os-project-domain-name <auth-project-domain-name>

使用 v3oidcaccesstoken:包含带有令牌的项目的域名: 包含带有 v3adfspassword 的项目的域名: 包含使用 v3token 的项目的域名: 包含带有 v3applicationcredential 的项目的域名: 包含带有 v3totp 的项目的域名: 包含带有 v3oidcauthcode 的项目的域名: 包含带有 v3multifactor 的项目的域名: 包含带有密码的项目的域名: 包含使用 v3password 的项目的域名: 包含使用 v3oidcclientcredentials 的项目的域名: 包含带有 v3oidcpassword 的项目的域名: 包含使用 v3tokenlessauth 的项目的域名: 包含使用 v3samlpassword 的项目的域名: 包含项目的域名(Env: os_PROJECT_DOMAIN_NAME)

--os-identity-provider <auth-identity-provider>

使用 v3oidcaccesstoken: 身份供应商的名称,其 v3adfspassword: Identity Provider's name with v3oidcauthcode: Identity Provider's name with v3oidcclientcredentials: Identity Provider's name with v3oidcpassword: Identity Provider's name with v3samlpassword: Identity Provider 的 name (Env: OS_IDENTITY_PROVIDER)

--os-protocol <auth-protocol>

使用 v3oidcaccesstoken: 协议带有 v3adfspassword: 协议 v3oidcauthcode: 协议带有 v3oidcclientcredentials: 协议带有 v3oidcpassword: 协议的联邦插件协议,使用 v3samlpassword: 协议联邦插件(Env: OS_PROTOCOL)

--os-access-token <auth-access-token>

使用 v3oidcaccesstoken: oauth 2.0 访问令牌(env: OS_ACCESS_TOKEN)

--os-default-domain-id <auth-default-domain-id>

使用 token:用于 v3 和 v2 参数的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。使用 password:用于 v3 和 v2 参数的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。(Env: OS_DEFAULT_DOMAIN_ID)

--os-default-domain-name <auth-default-domain-name>

使用 token:用于 v3 api 和 v2 参数的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。使用 password:用于 v3 API 和 v2 参数的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。(Env: OS_DEFAULT_DOMAIN_NAME)

--os-token <auth-token>

使用 token: token to authenticate with v3token: Token to with v2token: Token With admin_token: 令牌 With admin_token: the token that be used (Env: OS_TOKEN)

--os-identity-provider-url <auth-identity-provider-url>

使用 v3adfspassword :一个身份提供程序 url,将发送 SAML 身份验证请求。使用 v3samlpassword :一个身份提供程序 URL,其中将发送 SAML2 身份验证请求。(Env: OS_IDENTITY_PROVIDER_URL)

--os-service-provider-endpoint <auth-service-provider-endpoint>

使用 v3adfspassword: service provider's endpoint (env: OS_SERVICE_PROVIDER_ENDPOINT)

--os-service-provider-entity-id <auth-service-provider-entity-id>

使用 v3adfspassword: 服务供应商的 saml 实体 ID (Env: OS_SERVICE_PROVIDER_ENTITY_ID)

--os-user-domain-id <auth-user-domain-id>

使用 v3applicationcredential: 用户的域 ID 带有 v3totp :用户的域 ID,密码为 password: User's domain id with v3password: User's domain id (Env: OS_USER_DOMAIN_ID)

--os-user-domain-name <auth-user-domain-name>

使用 v3applicationcredential: 用户的域名带有 v3totp :用户的域名,密码:用户的域名,使用 v3password: User's domain name (Env: OS_USER_DOMAIN_NAME)

--os-application-credential-secret <auth-application-credential-secret>

使用 v3applicationcredential: 应用程序凭证身份验证 secret (Env: OS_APPLICATION_CREDENTIAL_SECRET)

--os-application-credential-id <auth-application-credential-id>

使用 v3applicationcredential: 应用程序凭证 ID (Env: OS_APPLICATION_CREDENTIAL_ID)

--os-application-credential-name <auth-application-credential-name>

使用 v3applicationcredential: 应用程序凭证名称(Env: OS_APPLICATION_CREDENTIAL_NAME)

--os-passcode <auth-passcode>

使用 v3totp:用户的 totp passcode (env: os_passcode)

--os-client-id <auth-client-id>

使用 v3oidcauthcode: oauth 2.0 client id with v3oidcclientcredentials: OAuth 2.0 Client ID with v3oidcpassword: OAuth 2.0 Client ID (Env: OS_CLIENT_ID)

--os-client-secret <auth-client-secret>

使用 v3oidcauthcode: oauth 2.0 client secret with v3oidcclientcredentials: OAuth 2.0 Client Secret with v3oidcpassword: OAuth 2.0 Client Secret (Env: OS_CLIENT_SECRET)

--os-openid-scope <auth-openid-scope>

使用 v3oidcauthcode: openid connect 范围,该范围从授权服务器请求。请注意,OpenID Connect 规格指出必须始终指定 "openid"。使用 v3oidcclientcredentials:从授权服务器请求的 OpenID Connect 范围。请注意,OpenID Connect 规格指出必须始终指定 "openid"。使用 v3oidcpassword:从授权服务器请求的 OpenID Connect 范围。请注意,OpenID Connect 规格指出必须始终指定 "openid"。(Env: OS_OPENID_SCOPE)

--os-access-token-endpoint <auth-access-token-endpoint>

使用 v3oidcauthcode: openid connect provider token Endpoint。请注意,如果通过此选项,则此选项将覆盖发现文档中服务器提供的端点。使用 v3oidcclientcredentials:OpenID Connect Provider Token Endpoint。请注意,如果通过此选项,则此选项将覆盖发现文档中服务器提供的端点。使用 v3oidcpassword: OpenID Connect Provider Token Endpoint。请注意,如果通过此选项,则此选项将覆盖发现文档中服务器提供的端点。(Env: OS_ACCESS_TOKEN_ENDPOINT)

--os-discovery-endpoint <auth-discovery-endpoint>

使用 v3oidcauthcode: openid connect discovery 文档 URL。发现文档将用于获取访问令牌端点和身份验证端点的值。这个 URL 应该类似带有 v3oidcclientcredentials 的 https://idp.example.org/.well-known/openid- 配置:OpenID Connect Discovery 文档 URL。发现文档将用于获取访问令牌端点和身份验证端点的值。这个 URL 应该类似于使用 v3oidcpassword: OpenID Connect Discovery Document URL 的 https://idp.example.org/.well- known/openid-configuration。发现文档将用于获取访问令牌端点和身份验证端点的值。此 URL 应该类似于 https://idp.example.org/.well- known/openid-configuration (Env: OS_DISCOVERY_ENDPOINT)

--os-access-token-type <auth-access-token-type>

使用 v3oidcauthcode: oauth 2.0 授权服务器内省令牌类型,它用于决定在处理令牌内省时将使用哪个令牌类型。有效值为:"access_token" 或 "id_token" with v3oidcclientcredentials: OAuth 2.0 Authorization Server Introspection 令牌类型,它用于决定在处理令牌内省时使用哪个类型的令牌。有效值为:"access_token" 或 "id_token" with v3oidcpassword: OAuth 2.0 Authorization Server Introspection 令牌类型,它用于决定处理令牌内省时将使用哪个类型的令牌。有效值为:"access_token" 或 "id_token" (Env: OS_ACCESS_TOKEN_TYPE)

--os-redirect-uri <auth-redirect-uri>

使用 v3oidcauthcode: openid connect redirect url (env: OS_REDIRECT_URI)

--os-code <auth-code>

使用 v3oidcauthcode: oauth 2.0 授权代码(Env: OS_CODE)

--os-endpoint <auth-endpoint>

使用 noauth: cinder 端点带有 gnocchi-noauth: Gnocchi 端点,带有 gnocchi-basic: Gnocchi 端点,其端点将始终与 admin_token 一起使用:将始终使用的端点(Env: OS_ENDPOINT)

--os-auth-methods <auth-auth-methods>

使用 v3multifactor:使用方法进行验证。(Env: OS_AUTH_METHODS)

--os-user <auth-user>

使用 gnocchi-basic: user (env: os_user)

--os-consumer-key <auth-consumer-key>

使用 v3oauth1: oauth consumer id/key (env: OS_CONSUMER_KEY)

--os-consumer-secret <auth-consumer-secret>

使用 v3oauth1: oauth consumer secret (env: OS_CONSUMER_SECRET)

--os-access-key <auth-access-key>

使用 v3oauth1: oauth 访问密钥(env: os_access_key)

--os-access-secret <auth-access-secret>

使用 v3oauth1:oauth 访问 secret (env: OS_ACCESS_SECRET)

第 2 章 access

本章描述了 access 命令下的命令。

2.1. 访问令牌创建

创建访问令牌

使用方法:

openstack access token create [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     --consumer-key <consumer-key>
                                     --consumer-secret <consumer-secret>
                                     --request-key <request-key>
                                     --request-secret <request-secret>
                                     --verifier <verifier>

表 2.1. 命令参数
概述

-h, --help

显示帮助信息并退出

--consumer-key <consumer-key>

consumer key (必需)

--consumer-secret <consumer-secret>

消费者 secret (必需)

--request-key <request-key>

请求令牌以交换访问令牌(必需)

--request-secret <request-secret>

与 <request-key> 关联的 secret (必需)

--verifier <verifier>

与 <request-key> 关联的验证器(必需)

表 2.2. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 2.3. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 2.4. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 2.5. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 3 章 acl

本章描述了 acl 命令下的命令。

3.1. ACL 删除

删除由 href 标识的 secret 或容器的 ACL。

使用方法:

openstack acl delete [-h] URI

表 3.1. positional 参数
概述

URI

secret 或容器的 uri 引用。

表 3.2. 命令参数
概述

-h, --help

显示帮助信息并退出

3.2. ACL 获取

通过提供其 href,检索 secret 或容器的 ACL。

使用方法:

openstack acl get [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                         [--quote {all,minimal,none,nonnumeric}] [--noindent]
                         [--max-width <integer>] [--fit-width] [--print-empty]
                         [--sort-column SORT_COLUMN]
                         URI

表 3.3. positional 参数
概述

URI

secret 或容器的 uri 引用。

表 3.4. 命令参数
概述

-h, --help

显示帮助信息并退出

表 3.5. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 3.6. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 3.7. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 3.8. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

3.3. ACL 提交

根据 href 标识,在 secret 或容器上提交 ACL。

使用方法:

openstack acl submit [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--noindent] [--max-width <integer>] [--fit-width]
                            [--print-empty] [--sort-column SORT_COLUMN]
                            [--user [USERS]]
                            [--project-access | --no-project-access]
                            [--operation-type {read}]
                            URI

表 3.9. positional 参数
概述

URI

secret 或容器的 uri 引用。

表 3.10. 命令参数
概述

-h, --help

显示帮助信息并退出

--user [USERS], -u [USERS]

acl 的 Keystone userid。

--project-access

用于启用项目访问行为的标志。

--no-project-access

用于禁用项目访问行为的标志。

--operation-type {read}, -o {read}

为 barbican 操作 acl 设置了 barbican 操作类型

表 3.11. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 3.12. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 3.13. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 3.14. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

3.4. ACL 用户添加

根据 href 标识,将 ACL 用户添加到 secret 或容器中。

使用方法:

openstack acl user add [-h] [-f {csv,json,table,value,yaml}]
                              [-c COLUMN]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--noindent] [--max-width <integer>]
                              [--fit-width] [--print-empty]
                              [--sort-column SORT_COLUMN] [--user [USERS]]
                              [--project-access | --no-project-access]
                              [--operation-type {read}]
                              URI

表 3.15. positional 参数
概述

URI

secret 或容器的 uri 引用。

表 3.16. 命令参数
概述

-h, --help

显示帮助信息并退出

--user [USERS], -u [USERS]

acl 的 Keystone userid。

--project-access

用于启用项目访问行为的标志。

--no-project-access

用于禁用项目访问行为的标志。

--operation-type {read}, -o {read}

为 barbican 操作 acl 设置了 barbican 操作类型

表 3.17. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 3.18. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 3.19. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 3.20. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

3.5. ACL 用户删除

根据 href 标识的 secret 或容器中删除 ACL 用户。

使用方法:

openstack acl user remove [-h] [-f {csv,json,table,value,yaml}]
                                 [-c COLUMN]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--noindent] [--max-width <integer>]
                                 [--fit-width] [--print-empty]
                                 [--sort-column SORT_COLUMN] [--user [USERS]]
                                 [--project-access | --no-project-access]
                                 [--operation-type {read}]
                                 URI

表 3.21. positional 参数
概述

URI

secret 或容器的 uri 引用。

表 3.22. 命令参数
概述

-h, --help

显示帮助信息并退出

--user [USERS], -u [USERS]

acl 的 Keystone userid。

--project-access

用于启用项目访问行为的标志。

--no-project-access

用于禁用项目访问行为的标志。

--operation-type {read}, -o {read}

为 barbican 操作 acl 设置了 barbican 操作类型

表 3.23. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 3.24. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 3.25. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 3.26. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 4 章 action

本章描述了 action 命令下的命令。

4.1. 操作定义 create

创建新操作。

使用方法:

openstack action definition create [-h]
                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--noindent] [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--sort-column SORT_COLUMN]
                                          [--marker [MARKER]]
                                          [--limit [LIMIT]]
                                          [--sort_keys [SORT_KEYS]]
                                          [--sort_dirs [SORT_DIRS]]
                                          [--filter FILTERS] [--public]
                                          definition

表 4.1. positional 参数
概述

定义

操作定义文件

表 4.2. 命令参数
概述

-h, --help

显示帮助信息并退出

--marker [MARKER]

上一页的最后执行 uuid 显示在"marker"后执行列表。

--limit [LIMIT]

在单个结果中返回的最大条目数。

--sort_keys [SORT_KEYS]

以逗号分隔的排序键列表,按以下方式对结果进行排序。默认: created_at。示例:mistral execution-list --sort_keys=id,description

--sort_dirs [SORT_DIRS]

以逗号分隔的排序方向列表。默认为 asc。示例:mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc

--filter FILTERS

filters. 可以重复。

--public

使用这个标志操作,将标记为"public"。

表 4.3. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 4.4. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 4.5. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.6. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.2. 操作定义显示

显示操作定义。

使用方法:

openstack action definition definition show [-h] name

表 4.7. positional 参数
概述

name

操作名称

表 4.8. 命令参数
概述

-h, --help

显示帮助信息并退出

4.3. 操作定义删除

删除操作。

使用方法:

openstack action definition delete [-h] action [action ...]

表 4.9. positional 参数
概述

action

操作的名称或 ID。

表 4.10. 命令参数
概述

-h, --help

显示帮助信息并退出

4.4. 操作定义列表

列出所有操作。

使用方法:

openstack action definition list [-h] [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--noindent] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--sort-column SORT_COLUMN]
                                        [--marker [MARKER]] [--limit [LIMIT]]
                                        [--sort_keys [SORT_KEYS]]
                                        [--sort_dirs [SORT_DIRS]]
                                        [--filter FILTERS]

表 4.11. 命令参数
概述

-h, --help

显示帮助信息并退出

--marker [MARKER]

上一页的最后执行 uuid 显示在"marker"后执行列表。

--limit [LIMIT]

在单个结果中返回的最大条目数。

--sort_keys [SORT_KEYS]

以逗号分隔的排序键列表,按以下方式对结果进行排序。默认: created_at。示例:mistral execution-list --sort_keys=id,description

--sort_dirs [SORT_DIRS]

以逗号分隔的排序方向列表。默认为 asc。示例:mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc

--filter FILTERS

filters. 可以重复。

表 4.12. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 4.13. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 4.14. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.15. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.5. 操作定义显示

显示特定的操作。

使用方法:

openstack action definition show [-h]
                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--noindent]
                                        [--prefix PREFIX]
                                        [--max-width <integer>] [--fit-width]
                                        [--print-empty]
                                        action

表 4.16. positional 参数
概述

action

操作(名称或 id)

表 4.17. 命令参数
概述

-h, --help

显示帮助信息并退出

表 4.18. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 4.19. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.20. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 4.21. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.6. 操作定义更新

更新操作。

使用方法:

openstack action definition update [-h]
                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--noindent] [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--sort-column SORT_COLUMN]
                                          [--marker [MARKER]]
                                          [--limit [LIMIT]]
                                          [--sort_keys [SORT_KEYS]]
                                          [--sort_dirs [SORT_DIRS]]
                                          [--filter FILTERS] [--id ID]
                                          [--public]
                                          definition

表 4.22. positional 参数
概述

定义

操作定义文件

表 4.23. 命令参数
概述

-h, --help

显示帮助信息并退出

--marker [MARKER]

上一页的最后执行 uuid 显示在"marker"后执行列表。

--limit [LIMIT]

在单个结果中返回的最大条目数。

--sort_keys [SORT_KEYS]

以逗号分隔的排序键列表,按以下方式对结果进行排序。默认: created_at。示例:mistral execution-list --sort_keys=id,description

--sort_dirs [SORT_DIRS]

以逗号分隔的排序方向列表。默认为 asc。示例:mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc

--filter FILTERS

filters. 可以重复。

--id ID

操作 ID。

--public

使用这个标志操作,将标记为"public"。

表 4.24. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 4.25. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 4.26. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.27. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.7. 操作执行删除

删除操作执行。

使用方法:

openstack action execution delete [-h]
                                         action_execution
                                         [action_execution ...]

表 4.28. positional 参数
概述

action_execution

操作执行标识符的 ID。

表 4.29. 命令参数
概述

-h, --help

显示帮助信息并退出

4.8. 操作执行输入显示

显示操作执行输入数据。

使用方法:

openstack action execution input show [-h] id

表 4.30. positional 参数
概述

id

操作执行 ID。

表 4.31. 命令参数
概述

-h, --help

显示帮助信息并退出

4.9. 操作执行列表

列出所有操作执行。

使用方法:

openstack action execution list [-h] [-f {csv,json,table,value,yaml}]
                                       [-c COLUMN]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--noindent] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--sort-column SORT_COLUMN]
                                       [--marker [MARKER]] [--limit [LIMIT]]
                                       [--sort_keys [SORT_KEYS]]
                                       [--sort_dirs [SORT_DIRS]]
                                       [--filter FILTERS] [--oldest]
                                       [task_execution_id]

表 4.32. positional 参数
概述

task_execution_id

任务执行 ID。

表 4.33. 命令参数
概述

-h, --help

显示帮助信息并退出

--marker [MARKER]

上一页的最后执行 uuid 显示在"marker"后执行列表。

--limit [LIMIT]

在单个结果中返回的最大条目数。

--sort_keys [SORT_KEYS]

以逗号分隔的排序键列表,按以下方式对结果进行排序。默认: created_at。示例:mistral execution-list --sort_keys=id,description

--sort_dirs [SORT_DIRS]

以逗号分隔的排序方向列表。默认为 asc。示例:mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc

--filter FILTERS

filters. 可以重复。

--oldest

显示从最旧的条目而不是最新的条目开始的执行

表 4.34. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 4.35. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 4.36. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.37. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.10. 操作执行输出显示

显示 Action 执行输出数据。

使用方法:

openstack action execution output show [-h] id

表 4.38. positional 参数
概述

id

操作执行 ID。

表 4.39. 命令参数
概述

-h, --help

显示帮助信息并退出

4.11. 操作执行运行

创建新的 Action 执行,或只运行特定的操作。

使用方法:

openstack action execution run [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--noindent]
                                      [--prefix PREFIX]
                                      [--max-width <integer>] [--fit-width]
                                      [--print-empty] [-s] [--run-sync]
                                      [-t TARGET]
                                      name [input]

表 4.40. positional 参数
概述

name

要执行的操作名称。

输入

操作输入。

表 4.41. 命令参数
概述

-h, --help

显示帮助信息并退出

-s, --save-result

将结果保存到 db 中。

--run-sync

同步运行该操作。

-t TARGET, --target TARGET

操作将在 <target> executor 上执行。

表 4.42. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 4.43. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.44. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 4.45. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.12. 操作执行显示

显示特定的 Action 执行。

使用方法:

openstack action execution show [-h] [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--noindent]
                                       [--prefix PREFIX]
                                       [--max-width <integer>] [--fit-width]
                                       [--print-empty]
                                       action_execution

表 4.46. positional 参数
概述

action_execution

操作执行 ID。

表 4.47. 命令参数
概述

-h, --help

显示帮助信息并退出

表 4.48. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 4.49. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.50. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 4.51. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

4.13. 操作执行更新

更新特定的 Action 执行。

使用方法:

openstack action execution update [-h]
                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--noindent]
                                         [--prefix PREFIX]
                                         [--max-width <integer>] [--fit-width]
                                         [--print-empty]
                                         [--state {PAUSED,RUNNING,SUCCESS,ERROR,CANCELLED}]
                                         [--output OUTPUT]
                                         id

表 4.52. positional 参数
概述

id

操作执行 ID。

表 4.53. 命令参数
概述

-h, --help

显示帮助信息并退出

--state {PAUSED,RUNNING,SUCCESS,ERROR,CANCELLED}

操作执行状态

--output OUTPUT

操作执行输出

表 4.54. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 4.55. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 4.56. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 4.57. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 5 章 address

本章描述了 address 命令下的命令。

5.1. 创建地址范围

创建新地址范围

使用方法:

openstack address scope create [-h] [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--noindent]
                                      [--prefix PREFIX]
                                      [--max-width <integer>] [--fit-width]
                                      [--print-empty] [--ip-version {4,6}]
                                      [--project <project>]
                                      [--project-domain <project-domain>]
                                      [--share | --no-share]
                                      <name>

表 5.1. positional 参数
概述

<name>

新地址范围名称

表 5.2. 命令参数
概述

-h, --help

显示帮助信息并退出

--ip-version {4,6}

IP 版本(默认为 4)

--project <project>

所有者的项目(名称或 id)

--project-domain <project-domain>

项目所属的域(名称或 id)。这可用于在项目名称之间存在冲突时使用。

--share

在项目间共享地址范围

--no-share

不要在项目间共享地址范围(默认)

表 5.3. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 5.4. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 5.5. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 5.6. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

5.2. 地址范围删除

删除地址范围

使用方法:

openstack address scope delete [-h]
                                      <address-scope> [<address-scope> ...]

表 5.7. positional 参数
概述

<address-scope>

要删除的地址范围(名称或 id)

表 5.8. 命令参数
概述

-h, --help

显示帮助信息并退出

5.3. 地址范围列表

列出地址范围

使用方法:

openstack address scope list [-h] [-f {csv,json,table,value,yaml}]
                                    [-c COLUMN]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--noindent] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--sort-column SORT_COLUMN]
                                    [--name <name>]
                                    [--ip-version <ip-version>]
                                    [--project <project>]
                                    [--project-domain <project-domain>]
                                    [--share | --no-share]

表 5.9. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <name>

在输出中只列出指定名称的地址范围

--ip-version <ip-version>

列出给定 ip 版本网络(4 或 6)的 地址范围

--project <project>

根据项目(名称或 ID)列出地址范围

--project-domain <project-domain>

项目所属的域(名称或 id)。这可用于在项目名称之间存在冲突时使用。

--share

列出项目间共享的地址范围

--no-share

列出项目之间没有共享的地址范围

表 5.10. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 5.11. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 5.12. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 5.13. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

5.4. 地址范围集

设置地址范围属性

使用方法:

openstack address scope set [-h] [--name <name>] [--share | --no-share]
                                   <address-scope>

表 5.14. positional 参数
概述

<address-scope>

要修改的地址范围(名称或 id)

表 5.15. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <name>

设置地址范围名称

--share

在项目间共享地址范围

--no-share

不要在项目间共享地址范围

5.5. 地址范围显示

显示地址范围详情

使用方法:

openstack address scope show [-h] [-f {json,shell,table,value,yaml}]
                                    [-c COLUMN] [--noindent] [--prefix PREFIX]
                                    [--max-width <integer>] [--fit-width]
                                    [--print-empty]
                                    <address-scope>

表 5.16. positional 参数
概述

<address-scope>

要显示的地址范围(名称或 id)

表 5.17. 命令参数
概述

-h, --help

显示帮助信息并退出

表 5.18. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 5.19. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 5.20. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 5.21. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 6 章 聚合

本章描述了 aggregate 命令下的命令。

6.1. 聚合添加主机

将主机添加到聚合

使用方法:

openstack aggregate add host [-h] [-f {json,shell,table,value,yaml}]
                                    [-c COLUMN] [--noindent] [--prefix PREFIX]
                                    [--max-width <integer>] [--fit-width]
                                    [--print-empty]
                                    <aggregate> <host>

表 6.1. positional 参数
概述

<aggregate>

聚合(名称或 id)

<host>

要添加到 <aggregate> 的主机

表 6.2. 命令参数
概述

-h, --help

显示帮助信息并退出

表 6.3. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 6.4. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 6.5. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 6.6. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

6.2. 聚合创建

创建新聚合

使用方法:

openstack aggregate create [-h] [-f {json,shell,table,value,yaml}]
                                  [-c COLUMN] [--noindent] [--prefix PREFIX]
                                  [--max-width <integer>] [--fit-width]
                                  [--print-empty] [--zone <availability-zone>]
                                  [--property <key=value>]
                                  <name>

表 6.7. positional 参数
概述

<name>

新聚合名称

表 6.8. 命令参数
概述

-h, --help

显示帮助信息并退出

--zone <availability-zone>

可用区名称

--property <key=value>

要添加到此聚合的属性(重复选项来设置多个属性)

表 6.9. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 6.10. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 6.11. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 6.12. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

6.3. 聚合删除

删除现有的聚合

使用方法:

openstack aggregate delete [-h] <aggregate> [<aggregate> ...]

表 6.13. positional 参数
概述

<aggregate>

要删除的聚合(名称或 id)

表 6.14. 命令参数
概述

-h, --help

显示帮助信息并退出

6.4. 聚合列表

列出所有聚合

使用方法:

openstack aggregate list [-h] [-f {csv,json,table,value,yaml}]
                                [-c COLUMN]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--noindent] [--max-width <integer>]
                                [--fit-width] [--print-empty]
                                [--sort-column SORT_COLUMN] [--long]

表 6.15. 命令参数
概述

-h, --help

显示帮助信息并退出

--long

列出输出中的其他字段

表 6.16. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 6.17. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 6.18. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 6.19. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

6.5. 聚合删除主机

从聚合中删除主机

使用方法:

openstack aggregate remove host [-h] [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--noindent]
                                       [--prefix PREFIX]
                                       [--max-width <integer>] [--fit-width]
                                       [--print-empty]
                                       <aggregate> <host>

表 6.20. positional 参数
概述

<aggregate>

聚合(名称或 id)

<host>

要从 <aggregate> 中删除的主机

表 6.21. 命令参数
概述

-h, --help

显示帮助信息并退出

表 6.22. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 6.23. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 6.24. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 6.25. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

6.6. 聚合集

设置聚合属性

使用方法:

openstack aggregate set [-h] [--name <name>]
                               [--zone <availability-zone>]
                               [--property <key=value>] [--no-property]
                               <aggregate>

表 6.26. positional 参数
概述

<aggregate>

要修改的聚合(名称或 id)

表 6.27. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <name>

设置聚合名称

--zone <availability-zone>

设置可用区名称

--property <key=value>

要在 <aggregate> 上设置的属性(用于设置多个属性)

--no-property

从 <aggregate> 中删除所有属性(指定 --property 和 --no-property 来覆盖当前属性)

6.7. 聚合显示

显示聚合详情

使用方法:

openstack aggregate show [-h] [-f {json,shell,table,value,yaml}]
                                [-c COLUMN] [--noindent] [--prefix PREFIX]
                                [--max-width <integer>] [--fit-width]
                                [--print-empty]
                                <aggregate>

表 6.28. positional 参数
概述

<aggregate>

要显示的聚合(名称或 id)

表 6.29. 命令参数
概述

-h, --help

显示帮助信息并退出

表 6.30. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 6.31. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 6.32. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 6.33. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

6.8. 聚合未设置

取消设置聚合属性

使用方法:

openstack aggregate unset [-h] [--property <key>] <aggregate>

表 6.34. positional 参数
概述

<aggregate>

要修改的聚合(名称或 id)

表 6.35. 命令参数
概述

-h, --help

显示帮助信息并退出

--property <key>

从聚合中删除的属性(重复选项来删除多个属性)

第 7 章 警报

本章描述了 警报 命令下的命令。

7.1. 警告创建

创建警报

使用方法:

openstack alarm create [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--noindent] [--prefix PREFIX]
                              [--max-width <integer>] [--fit-width]
                              [--print-empty] --name <NAME> -t <TYPE>
                              [--project-id <PROJECT_ID>]
                              [--user-id <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}]
                              [--query <QUERY>]
                              [--comparison-operator <OPERATOR>]
                              [--evaluation-periods <EVAL_PERIODS>]
                              [--threshold <THRESHOLD>]
                              [--event-type <EVENT_TYPE>]
                              [--granularity <GRANULARITY>]
                              [--aggregation-method <AGGR_METHOD>]
                              [--metric <METRIC>]
                              [--resource-type <RESOURCE_TYPE>]
                              [--resource-id <RESOURCE_ID>]
                              [--composite-rule <COMPOSITE_RULE>]

表 7.1. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

-t <TYPE>, --type <TYPE>

警报类型,应该是:event、comp、gnocchi_resources_threshold、gnocchi_aggregation_by_metrics_threshold、gnocchi_aggregation_by_resources_threshold 之一。

--project-id <PROJECT_ID>

与警报关联的项目(仅可由管理员用户配置)

--user-id <USER_ID>

用户与警报关联(仅可由管理员用户配置)

--description <DESCRIPTION>

警报的自由文本描述

--state <STATE>

警报的状态,其中一个: [ok, alert, data]

--severity <SEVERITY>

警报的严重性,其中之一为: [low,moderate,critical]

--enabled {True|False}

如果启用了警报评估,则为 true

--sqlserver-action <Webhook URL>

当状态转换为警报时调用的 URL。可能会多次使用

--OK-action <Webhook URL>

当状态转换为 ok 时调用的 URL。可能会多次使用

--insufficient-data-action <Webhook URL>

当状态转换为数据不足时调用的 URL。可以多次使用

--time-constraint <Time Constraint>

仅在评估时评估警报在此时间约束中。约束的起点使用 cron 表达式指定,其持续时间以秒为单位。对于多个时间约束,可以多次指定时间限制,格式为: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]]

--repeat-actions {True|False}

如果在警报处于目标状态时应重复通知,则为 true

表 7.2. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 7.3. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.4. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 7.5. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

表 7.6. 常见警报规则
概述

--query <QUERY>

对于类型 event: key[op]data_type::value 的警报;list.data_type 是可选的,但如果提供,必须是 string、整数、float 或 boolean。对于类型为 gnocchi_aggregation_by_resources_threshold 的警报:需要指定一个复杂的查询 json 字符串,例如: {"and": [{"=": {"ended_at": null}}, …​]}。

--comparison-operator <OPERATOR>

要比较的运算符,其中一个: [lt,le,eq,ne,ge,gt]

--evaluation-periods <EVAL_PERIODS>

要评估的周期数

--threshold <THRESHOLD>

要评估的阈值。

表 7.7. 事件警告
概述

--event-type <EVENT_TYPE>

要评估的事件类型

表 7.8. 常见 gnocchi 警报规则
概述

--granularity <GRANULARITY>

要查询的时间范围(以秒为单位)。

--aggregation-method <AGR_METHOD>

与阈值相比的 aggregate_method。

--metric <METRIC>, --metrics <METRIC>

指标 ID 或名称,具体取决于警报类型

表 7.9. gnocchi 资源阈值警报
概述

--resource-type <RESOURCE_TYPE>

资源类型。

--resource-id <RESOURCE_ID>

资源的 id。

表 7.10. 复合警报
概述

--composite-rule <COMPOSITE_RULE>

带有 json 格式的复合阈值规则,形式可以是嵌套的字典,它将 gnocchi 规则组合为 "and", "or"。例如,表单类似: {"or":[RULE1, RULE2, {"and": [RULE3, RULE4]}]}。

7.2. 警告删除

删除警报

使用方法:

openstack alarm delete [-h] [--name <NAME>] [<ALARM ID or NAME>]

表 7.11. positional 参数
概述

<ALARM ID 或 NAME>

警报的 ID 或名称。

表 7.12. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

7.4. alert-history show

显示警报的历史记录

使用方法:

openstack alarm-history show [-h] [-f {csv,json,table,value,yaml}]
                                    [-c COLUMN]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--noindent] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--sort-column SORT_COLUMN]
                                    [--limit <LIMIT>] [--marker <MARKER>]
                                    [--sort <SORT_KEY:SORT_DIR>]
                                    <alarm-id>

表 7.18. positional 参数
概述

<alarm-id>

警报 ID

表 7.19. 命令参数
概述

-h, --help

显示帮助信息并退出

--limit <LIMIT>

要返回的资源数量(默认为服务器默认)

--marker <MARKER>

上一个列表的最后一项。在此值后返回下一个结果,支持的标记是 event_id。

--sort <SORT_KEY:SORT_DIR>

资源属性的排序,如 timestamp:desc

表 7.20. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 7.21. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 7.22. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.23. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

7.5. 警报列表

列出警报

使用方法:

openstack alarm list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--noindent] [--max-width <integer>] [--fit-width]
                            [--print-empty] [--sort-column SORT_COLUMN]
                            [--query QUERY | --filter <KEY1=VALUE1;KEY2=VALUE2...>]
                            [--limit <LIMIT>] [--marker <MARKER>]
                            [--sort <SORT_KEY:SORT_DIR>]

表 7.24. 命令参数
概述

-h, --help

显示帮助信息并退出

--query QUERY

由 aodh 支持的丰富的查询,如 project_id!=my-id user_id=foo 或 user_id=bar

--filter <KEY1=VALUE1;KEY2=VALUE2…​>

过滤要在返回的警报上应用的参数。

--limit <LIMIT>

要返回的资源数量(默认为服务器默认)

--marker <MARKER>

上一次列表的最后一项。在此值后返回下一个结果,支持的标记是 alert_id。

--sort <SORT_KEY:SORT_DIR>

资源属性的排序,如 name:asc

表 7.25. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 7.26. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 7.27. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.28. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

7.6. 警报显示

显示警报

使用方法:

openstack alarm show [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--noindent] [--prefix PREFIX]
                            [--max-width <integer>] [--fit-width]
                            [--print-empty] [--name <NAME>]
                            [<ALARM ID or NAME>]

表 7.29. positional 参数
概述

<ALARM ID 或 NAME>

警报的 ID 或名称。

表 7.30. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

表 7.31. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 7.32. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.33. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 7.34. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

7.7. 警报状态 get

获取警报的状态

使用方法:

openstack alarm state get [-h] [-f {json,shell,table,value,yaml}]
                                 [-c COLUMN] [--noindent] [--prefix PREFIX]
                                 [--max-width <integer>] [--fit-width]
                                 [--print-empty] [--name <NAME>]
                                 [<ALARM ID or NAME>]

表 7.35. positional 参数
概述

<ALARM ID 或 NAME>

警报的 ID 或名称。

表 7.36. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

表 7.37. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 7.38. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.39. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 7.40. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

7.8. 警报状态集

设置警报的状态

使用方法:

openstack alarm state set [-h] [-f {json,shell,table,value,yaml}]
                                 [-c COLUMN] [--noindent] [--prefix PREFIX]
                                 [--max-width <integer>] [--fit-width]
                                 [--print-empty] [--name <NAME>] --state
                                 <STATE>
                                 [<ALARM ID or NAME>]

表 7.41. positional 参数
概述

<ALARM ID 或 NAME>

警报的 ID 或名称。

表 7.42. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

--state <STATE>

警报的状态,其中一个: [ok, alert, data]

表 7.43. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 7.44. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.45. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 7.46. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

7.9. 警告更新

更新警报

使用方法:

openstack alarm update [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--noindent] [--prefix PREFIX]
                              [--max-width <integer>] [--fit-width]
                              [--print-empty] [--name <NAME>] [-t <TYPE>]
                              [--project-id <PROJECT_ID>]
                              [--user-id <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}]
                              [--query <QUERY>]
                              [--comparison-operator <OPERATOR>]
                              [--evaluation-periods <EVAL_PERIODS>]
                              [--threshold <THRESHOLD>]
                              [--event-type <EVENT_TYPE>]
                              [--granularity <GRANULARITY>]
                              [--aggregation-method <AGGR_METHOD>]
                              [--metric <METRIC>]
                              [--resource-type <RESOURCE_TYPE>]
                              [--resource-id <RESOURCE_ID>]
                              [--composite-rule <COMPOSITE_RULE>]
                              [<ALARM ID or NAME>]

表 7.47. positional 参数
概述

<ALARM ID 或 NAME>

警报的 ID 或名称。

表 7.48. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <NAME>

警报的名称

-t <TYPE>, --type <TYPE>

警报类型,应该是:event、comp、gnocchi_resources_threshold、gnocchi_aggregation_by_metrics_threshold、gnocchi_aggregation_by_resources_threshold 之一。

--project-id <PROJECT_ID>

与警报关联的项目(仅可由管理员用户配置)

--user-id <USER_ID>

用户与警报关联(仅可由管理员用户配置)

--description <DESCRIPTION>

警报的自由文本描述

--state <STATE>

警报的状态,其中一个: [ok, alert, data]

--severity <SEVERITY>

警报的严重性,其中之一为: [low,moderate,critical]

--enabled {True|False}

如果启用了警报评估,则为 true

--sqlserver-action <Webhook URL>

当状态转换为警报时调用的 URL。可能会多次使用

--OK-action <Webhook URL>

当状态转换为 ok 时调用的 URL。可能会多次使用

--insufficient-data-action <Webhook URL>

当状态转换为数据不足时调用的 URL。可以多次使用

--time-constraint <Time Constraint>

仅在评估时评估警报在此时间约束中。约束的起点使用 cron 表达式指定,其持续时间以秒为单位。对于多个时间约束,可以多次指定时间限制,格式为: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]]

--repeat-actions {True|False}

如果在警报处于目标状态时应重复通知,则为 true

表 7.49. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 7.50. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 7.51. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 7.52. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

表 7.53. 常见警报规则
概述

--query <QUERY>

对于类型 event: key[op]data_type::value 的警报;list.data_type 是可选的,但如果提供,必须是 string、整数、float 或 boolean。对于类型为 gnocchi_aggregation_by_resources_threshold 的警报:需要指定一个复杂的查询 json 字符串,例如: {"and": [{"=": {"ended_at": null}}, …​]}。

--comparison-operator <OPERATOR>

要比较的运算符,其中一个: [lt,le,eq,ne,ge,gt]

--evaluation-periods <EVAL_PERIODS>

要评估的周期数

--threshold <THRESHOLD>

要评估的阈值。

表 7.54. 事件警告
概述

--event-type <EVENT_TYPE>

要评估的事件类型

表 7.55. 常见 gnocchi 警报规则
概述

--granularity <GRANULARITY>

要查询的时间范围(以秒为单位)。

--aggregation-method <AGR_METHOD>

与阈值相比的 aggregate_method。

--metric <METRIC>, --metrics <METRIC>

指标 ID 或名称,具体取决于警报类型

表 7.56. gnocchi 资源阈值警报
概述

--resource-type <RESOURCE_TYPE>

资源类型。

--resource-id <RESOURCE_ID>

资源的 id。

表 7.57. 复合警报
概述

--composite-rule <COMPOSITE_RULE>

带有 json 格式的复合阈值规则,形式可以是嵌套的字典,它将 gnocchi 规则组合为 "and", "or"。例如,表单类似: {"or":[RULE1, RULE2, {"and": [RULE3, RULE4]}]}。

第 8 章 警告

本章描述了警告命令下的 命令

8.1. 警告能力列表

列出警告服务的功能

使用方法:

openstack alarming capabilities list [-h]
                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN] [--noindent]
                                            [--prefix PREFIX]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]

表 8.1. 命令参数
概述

-h, --help

显示帮助信息并退出

表 8.2. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 8.3. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 8.4. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 8.5. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 9 章 application

本章描述了 应用程序 命令下的命令。

9.1. 应用程序凭证创建

创建新应用程序凭证

使用方法:

openstack application credential create [-h]
                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN] [--noindent]
                                               [--prefix PREFIX]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--secret <secret>]
                                               [--role <role>]
                                               [--expiration <expiration>]
                                               [--description <description>]
                                               [--unrestricted] [--restricted]
                                               <name>

表 9.1. positional 参数
概述

<name>

应用程序凭证的名称

表 9.2. 命令参数
概述

-h, --help

显示帮助信息并退出

--secret <secret>

用于身份验证的 secret (如果没有提供,将生成一个)

--role <role>

要授权(名称或 id)的角色(重复选项来设置多个值)

--expiration <expiration>

为应用程序凭证设置过期日期,格式为 YYYY-mm-ddTHH:MM:SS (如果不提供,应用程序凭证不会过期)

--description <description>

应用程序凭证描述

--unrestricted

启用应用程序凭证来创建和删除其他应用程序凭证和信任(这可能是危险的行为,默认是禁用的)

--restricted

禁止应用程序凭证创建和删除其他应用程序凭证和信任(这是默认行为)

表 9.3. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 9.4. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 9.5. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 9.6. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

9.2. 应用程序凭证删除

删除应用程序凭证

使用方法:

openstack application credential delete [-h]
                                               <application-credential>
                                               [<application-credential> ...]

表 9.7. positional 参数
概述

<application-credential>

要删除的应用程序凭证(名称或 id)

表 9.8. 命令参数
概述

-h, --help

显示帮助信息并退出

9.3. 应用程序凭证列表

列出应用程序凭证

使用方法:

openstack application credential list [-h]
                                             [-f {csv,json,table,value,yaml}]
                                             [-c COLUMN]
                                             [--quote {all,minimal,none,nonnumeric}]
                                             [--noindent]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--sort-column SORT_COLUMN]
                                             [--user <user>]
                                             [--user-domain <user-domain>]

表 9.9. 命令参数
概述

-h, --help

显示帮助信息并退出

--user <user>

要列出的应用程序凭证的用户(名称或 ID)

--user-domain <user-domain>

用户所属的域(名称或 id)。这可用于在用户名之间存在冲突时使用。

表 9.10. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 9.11. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 9.12. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 9.13. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

9.4. 应用程序凭证显示

显示应用程序凭证详情

使用方法:

openstack application credential show [-h]
                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN] [--noindent]
                                             [--prefix PREFIX]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             <application-credential>

表 9.14. positional 参数
概述

<application-credential>

要显示的应用程序凭证(名称或 id)

表 9.15. 命令参数
概述

-h, --help

显示帮助信息并退出

表 9.16. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 9.17. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 9.18. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 9.19. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 10 章 可用性

本章描述了 availability 命令下的命令。

10.1. 可用区列表

列出可用区及其状态

使用方法:

openstack availability zone list [-h] [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--noindent] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--sort-column SORT_COLUMN]
                                        [--compute] [--network] [--volume]
                                        [--long]

表 10.1. 命令参数
概述

-h, --help

显示帮助信息并退出

--compute

列出计算可用区

--network

列出网络可用区

--volume

列出卷可用区

--long

列出输出中的其他字段

表 10.2. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 10.3. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 10.4. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 10.5. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

第 11 章 baremetal

本章描述了 baremetal 命令下的命令。

11.1. 裸机分配创建

创建新的 baremetal 分配。

使用方法:

openstack baremetal allocation create [-h]
                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN] [--noindent]
                                             [--prefix PREFIX]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--resource-class RESOURCE_CLASS]
                                             [--trait TRAITS]
                                             [--candidate-node CANDIDATE_NODES]
                                             [--name NAME] [--uuid UUID]
                                             [--extra <key=value>]
                                             [--wait [<time-out>]]
                                             [--node NODE]

表 11.1. 命令参数
概述

-h, --help

显示帮助信息并退出

--resource-class RESOURCE_CLASS

要请求的资源类。

--trait TRAITS

用于请求的特征。可多次指定。

--candidate-node CANDIDATE_NODES

此分配的候选节点。可以多次指定。如果至少指定了一个,则只有提供的候选节点被视为分配。

--name NAME

分配的唯一名称。

--UUID UUID

分配的 UUID。

--extra <key=value>

记录任意键/值元数据。可以多次指定。

--wait [<time-out>]

等待新分配变为活动状态。如果分配失败并且使用了 --wait,则返回错误。(可选)使用超时值(以秒为单位)。默认值为 0,表示它将无限期等待。

--node NODE

从已部署的节点中回填此分配。绕过正常的分配过程。

表 11.2. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.3. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.4. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.5. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.2. 裸机分配删除

取消分配裸机。

使用方法:

openstack baremetal allocation delete [-h]
                                             <allocation> [<allocation> ...]

表 11.6. positional 参数
概述

<allocation>

要删除的分配(名称或 uuid)。

表 11.7. 命令参数
概述

-h, --help

显示帮助信息并退出

11.3. 裸机分配列表

列出裸机分配。

使用方法:

openstack baremetal allocation list [-h]
                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--noindent]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--sort-column SORT_COLUMN]
                                           [--limit <limit>]
                                           [--marker <allocation>]
                                           [--sort <key>[:<direction>]]
                                           [--node <node>]
                                           [--resource-class <resource_class>]
                                           [--state <state>]
                                           [--long | --fields <field> [<field> ...]]

表 11.8. 命令参数
概述

-h, --help

显示帮助信息并退出

--limit <limit>

每个请求返回的最大分配数,0 代表没有限制。默认是 Baremetal API Service 使用的最大数量。

--marker <allocation>

分配 uuid (例如,上一个请求列表中的最后一个分配)。在该 UUID 后返回分配列表。

--sort <key>[:<direction>]

根据指定的分配字段和方向(asc 或 desc)对输出进行排序(默认为 asc)。可以指定多个字段和方向,用逗号分开。

--node <node>

仅列出此节点的分配(name 或 uuid)。

--resource-class <resource_class>

仅列出此资源类型的分配。

--state <state>

仅列出处于此状态的分配。

--long

显示有关分配的详细信息。

--fields <field> [<field> …​]

一个或多个分配字段。只有这些字段将从服务器获取。指定 -- long 时无法使用。

表 11.9. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.10. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.11. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.12. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.4. 裸机分配集

设置裸机分配属性。

使用方法:

openstack baremetal allocation set [-h] [--name <name>]
                                          [--extra <key=value>]
                                          <allocation>

表 11.13. positional 参数
概述

<allocation>

分配的名称或 uuid

表 11.14. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <name>

设置分配的名称

--extra <key=value>

在此分配上设置的额外属性(重复选项来设置多个额外属性)

11.5. 裸机分配显示

显示裸机分配详情。

使用方法:

openstack baremetal allocation show [-h]
                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN] [--noindent]
                                           [--prefix PREFIX]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--fields <field> [<field> ...]]
                                           <id>

表 11.15. positional 参数
概述

<id>

分配的 UUID 或名称

表 11.16. 命令参数
概述

-h, --help

显示帮助信息并退出

--fields <field> [<field> …​]

一个或多个分配字段。只有这些字段将从服务器获取。

表 11.17. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.18. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.19. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.20. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.6. 裸机分配未设置

取消设置 baremetal 分配属性。

使用方法:

openstack baremetal allocation unset [-h] [--name] [--extra <key>]
                                            <allocation>

表 11.21. positional 参数
概述

<allocation>

分配的名称或 uuid

表 11.22. 命令参数
概述

-h, --help

显示帮助信息并退出

--name

取消设置分配名称

--extra <key>

在此裸机分配时取消设置的额外属性(需要取消设置多个额外属性)。

11.7. baremetal chassis create

创建新的机箱。

使用方法:

openstack baremetal chassis create [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--description <description>]
                                          [--extra <key=value>]
                                          [--uuid <uuid>]

表 11.23. 命令参数
概述

-h, --help

显示帮助信息并退出

--description <description>

机箱的描述

--extra <key=value>

记录任意键/值元数据。可以多次指定。

--uuid <uuid>

机箱的唯一 uuid

表 11.24. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.25. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.26. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.27. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.8. baremetal chassis delete

删除机箱。

使用方法:

openstack baremetal chassis delete [-h] <chassis> [<chassis> ...]

表 11.28. positional 参数
概述

<chassis>

要删除的 chassis 的 UUID

表 11.29. 命令参数
概述

-h, --help

显示帮助信息并退出

11.9. baremetal chassis list

列出机箱。

使用方法:

openstack baremetal chassis list [-h] [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--noindent] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--sort-column SORT_COLUMN]
                                        [--fields <field> [<field> ...]]
                                        [--limit <limit>] [--long]
                                        [--marker <chassis>]
                                        [--sort <key>[:<direction>]]

表 11.30. 命令参数
概述

-h, --help

显示帮助信息并退出

--fields <field> [<field> …​]

一个或多个 chassis 字段。只有这些字段将从服务器获取。指定 --long 时无法使用。

--limit <limit>

每个请求返回的最大机箱数,0 代表没有限制。默认是 Baremetal API Service 使用的最大数量。

--long

显示有关机箱的详细信息

--marker <chassis>

机箱 uuid (例如,上一个请求列表中的最后一个机箱)。在该 UUID 后返回机箱列表。

--sort <key>[:<direction>]

由指定的 chassis 字段和方向(asc 或 desc)排序输出(默认为 asc)。可以指定多个字段和方向,用逗号分开。

表 11.31. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.32. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.33. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.34. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.10. baremetal chassis set

设置机箱属性。

使用方法:

openstack baremetal chassis set [-h] [--description <description>]
                                       [--extra <key=value>]
                                       <chassis>

表 11.35. positional 参数
概述

<chassis>

机箱的 UUID

表 11.36. 命令参数
概述

-h, --help

显示帮助信息并退出

--description <description>

设置机箱的描述

--extra <key=value>

在这个机箱上设置额外的设置(需要设置多个额外选项)

11.11. 裸机机箱显示

显示机箱详情。

使用方法:

openstack baremetal chassis show [-h]
                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--noindent]
                                        [--prefix PREFIX]
                                        [--max-width <integer>] [--fit-width]
                                        [--print-empty]
                                        [--fields <field> [<field> ...]]
                                        <chassis>

表 11.37. positional 参数
概述

<chassis>

机箱的 UUID

表 11.38. 命令参数
概述

-h, --help

显示帮助信息并退出

--fields <field> [<field> …​]

一个或多个 chassis 字段。只有这些字段将从服务器获取。

表 11.39. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.40. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.41. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.42. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.12. baremetal chassis unset

取消设置机箱属性。

使用方法:

openstack baremetal chassis unset [-h] [--description] [--extra <key>]
                                         <chassis>

表 11.43. positional 参数
概述

<chassis>

机箱的 UUID

表 11.44. 命令参数
概述

-h, --help

显示帮助信息并退出

--description

清除 chassis 描述

--extra <key>

在这个机箱上取消设置的额外选项(用于取消设置多个额外的选项)

11.13. 裸机编排器列表

列出裸机编排器

使用方法:

openstack baremetal conductor list [-h]
                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--noindent] [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--sort-column SORT_COLUMN]
                                          [--limit <limit>]
                                          [--marker <conductor>]
                                          [--sort <key>[:<direction>]]
                                          [--long | --fields <field> [<field> ...]]

表 11.45. 命令参数
概述

-h, --help

显示帮助信息并退出

--limit <limit>

每个请求返回的最大编排器数,0 代表没有限制。默认是 Baremetal API Service 使用的最大数量。

--marker <conductor>

编排器的主机名(例如,上一请求列表中的最后一个编排器)。在此编排器后返回编排器列表。

--sort <key>[:<direction>]

由指定的编排器字段和方向(asc 或 desc)排序输出(默认为 asc)。可以指定多个字段和方向,用逗号分开。

--long

显示有关编排器的详细信息。

--fields <field> [<field> …​]

一个或多个编排器字段。只有这些字段将从服务器获取。指定 -- long 时无法使用。

表 11.46. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.47. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.48. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.49. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.14. 裸机编排器显示

显示裸机编排器详情

使用方法:

openstack baremetal conductor show [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--fields <field> [<field> ...]]
                                          <conductor>

表 11.50. positional 参数
概述

<conductor>

编排器的主机名

表 11.51. 命令参数
概述

-h, --help

显示帮助信息并退出

--fields <field> [<field> …​]

一个或多个编排器字段。只有这些字段将从服务器获取。

表 11.52. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.53. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.54. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.55. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.15. baremetal create

从文件创建资源

使用方法:

openstack baremetal create [-h] <file> [<file> ...]

表 11.56. positional 参数
概述

<file>

包含要创建的资源描述的文件(.yaml 或 .json)。可多次指定。

表 11.57. 命令参数
概述

-h, --help

显示帮助信息并退出

11.16. 裸机部署模板创建

创建新部署模板

使用方法:

openstack baremetal deploy template create [-h]
                                                  [-f {json,shell,table,value,yaml}]
                                                  [-c COLUMN] [--noindent]
                                                  [--prefix PREFIX]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]
                                                  [--uuid <uuid>]
                                                  [--extra <key=value>]
                                                  --steps <steps>
                                                  <name>

表 11.58. positional 参数
概述

<name>

此部署模板的唯一名称。必须是有效的特征名称

表 11.59. 命令参数
概述

-h, --help

显示帮助信息并退出

--uuid <uuid>

部署模板的 UUID。

--extra <key=value>

记录任意键/值元数据。可以多次指定。

--steps <steps>

部署步骤可以是 json 格式的部署步骤。可以是包含部署步骤的文件的路径; OR -,带有从标准输入读取的部署步骤 ; 或字符串。该值应该是部署步骤字典的列表;每个字典都应该具有键 接口步骤 argspriority

表 11.60. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.61. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.62. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.63. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.17. 裸机部署模板删除

删除部署模板。

使用方法:

openstack baremetal deploy template delete [-h]
                                                  <template> [<template> ...]

表 11.64. positional 参数
概述

<template>

要删除的部署模板的名称或 uuid。

表 11.65. 命令参数
概述

-h, --help

显示帮助信息并退出

11.18. 裸机部署模板列表

列出裸机部署模板。

使用方法:

openstack baremetal deploy template list [-h]
                                                [-f {csv,json,table,value,yaml}]
                                                [-c COLUMN]
                                                [--quote {all,minimal,none,nonnumeric}]
                                                [--noindent]
                                                [--max-width <integer>]
                                                [--fit-width] [--print-empty]
                                                [--sort-column SORT_COLUMN]
                                                [--limit <limit>]
                                                [--marker <template>]
                                                [--sort <key>[:<direction>]]
                                                [--long | --fields <field> [<field> ...]]

表 11.66. 命令参数
概述

-h, --help

显示帮助信息并退出

--limit <limit>

每个请求返回的最大部署模板数,0 代表没有限制。默认是 Baremetal API Service 使用的最大数量。

--marker <template>

DeployTemplate uuid (例如,上一请求列表中的最后一个部署模板)。在此 UUID 后返回部署模板列表。

--sort <key>[:<direction>]

通过指定的部署模板字段和指示(asc 或 desc)对输出进行排序(默认为 asc)。可以指定多个字段和方向,用逗号分开。

--long

显示有关部署模板的详细信息。

--fields <field> [<field> …​]

一个或多个部署模板字段。只有这些字段将从服务器获取。指定 --long 时无法使用。

表 11.67. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.68. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.69. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.70. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.19. 裸机部署模板集

设置 baremetal 部署模板属性。

使用方法:

openstack baremetal deploy template set [-h] [--name <name>]
                                               [--steps <steps>]
                                               [--extra <key=value>]
                                               <template>

表 11.71. positional 参数
概述

<template>

部署模板的名称或 uuid

表 11.72. 命令参数
概述

-h, --help

显示帮助信息并退出

--name <name>

设置部署模板的唯一名称。必须是有效的特征名称。

--steps <steps>

部署步骤可以是 json 格式的部署步骤。可以是包含部署步骤的文件的路径; OR -,带有从标准输入读取的部署步骤 ; 或字符串。该值应该是部署步骤字典的列表;每个字典都应该具有键 接口步骤 argspriority

--extra <key=value>

在这个 baremetal 部署模板上设置额外的设置(需要设置多个额外选项)。

11.20. 裸机部署模板显示

显示裸机部署模板详情。

使用方法:

openstack baremetal deploy template show [-h]
                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN] [--noindent]
                                                [--prefix PREFIX]
                                                [--max-width <integer>]
                                                [--fit-width] [--print-empty]
                                                [--fields <field> [<field> ...]]
                                                <template>

表 11.73. positional 参数
概述

<template>

部署模板的名称或 uuid。

表 11.74. 命令参数
概述

-h, --help

显示帮助信息并退出

--fields <field> [<field> …​]

一个或多个部署模板字段。只有这些字段将从服务器获取。

表 11.75. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.76. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.77. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.78. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.21. 裸机部署模板未设置

取消设置 baremetal 部署模板属性。

使用方法:

openstack baremetal deploy template unset [-h] [--extra <key>]
                                                 <template>

表 11.79. positional 参数
概述

<template>

部署模板的名称或 uuid

表 11.80. 命令参数
概述

-h, --help

显示帮助信息并退出

--extra <key>

在这个 baremetal 部署模板上取消设置的额外设置(需要为取消设置多个额外选项)。

11.22. 裸机驱动程序列表

列出启用的驱动程序。

使用方法:

openstack baremetal driver list [-h] [-f {csv,json,table,value,yaml}]
                                       [-c COLUMN]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--noindent] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--sort-column SORT_COLUMN]
                                       [--type <type>] [--long]

表 11.81. 命令参数
概述

-h, --help

显示帮助信息并退出

--type <type>

驱动程序类型("classic"或"dynamic")。默认是列出所有驱动程序。

--long

显示有关驱动程序的详细信息。

表 11.82. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.83. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.84. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.85. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.23. baremetal 驱动程序传递调用

调用某个驱动程序的供应商传递方法。

使用方法:

openstack baremetal driver passthru call [-h]
                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN] [--noindent]
                                                [--prefix PREFIX]
                                                [--max-width <integer>]
                                                [--fit-width] [--print-empty]
                                                [--arg <key=value>]
                                                [--http-method <http-method>]
                                                <driver> <method>

表 11.86. positional 参数
概述

<driver>

驱动程序的名称。

<method>

要调用厂商传递方法。

表 11.87. 命令参数
概述

-h, --help

显示帮助信息并退出

--arg <key=value>

传递给 passthru 方法的参数(重复选项以指定多个参数)。

--http-method <http-method>

在 passthru 请求中使用的 http 方法。一个 DELETE、GET、PATCH、POST、PUT。默认为 POST

表 11.88. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.89. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.90. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.91. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.24. baremetal 驱动程序传递列表

列出驱动程序的可用厂商传递方法。

使用方法:

openstack baremetal driver passthru list [-h]
                                                [-f {csv,json,table,value,yaml}]
                                                [-c COLUMN]
                                                [--quote {all,minimal,none,nonnumeric}]
                                                [--noindent]
                                                [--max-width <integer>]
                                                [--fit-width] [--print-empty]
                                                [--sort-column SORT_COLUMN]
                                                <driver>

表 11.92. positional 参数
概述

<driver>

驱动程序的名称。

表 11.93. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.94. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.95. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.96. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.97. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.25. 裸机驱动程序属性列表

列出驱动程序属性。

使用方法:

openstack baremetal driver property list [-h]
                                                [-f {csv,json,table,value,yaml}]
                                                [-c COLUMN]
                                                [--quote {all,minimal,none,nonnumeric}]
                                                [--noindent]
                                                [--max-width <integer>]
                                                [--fit-width] [--print-empty]
                                                [--sort-column SORT_COLUMN]
                                                <driver>

表 11.98. positional 参数
概述

<driver>

驱动程序的名称。

表 11.99. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.100. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.101. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.102. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.103. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.26. baremetal 驱动程序 raid 属性列表

列出驱动程序的 RAID 逻辑磁盘属性。

使用方法:

openstack baremetal driver raid property list [-h]
                                                     [-f {csv,json,table,value,yaml}]
                                                     [-c COLUMN]
                                                     [--quote {all,minimal,none,nonnumeric}]
                                                     [--noindent]
                                                     [--max-width <integer>]
                                                     [--fit-width]
                                                     [--print-empty]
                                                     [--sort-column SORT_COLUMN]
                                                     <driver>

表 11.104. positional 参数
概述

<driver>

驱动程序的名称。

表 11.105. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.106. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.107. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.108. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.109. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.27. 裸机驱动程序显示

显示有关驱动程序的信息。

使用方法:

openstack baremetal driver show [-h] [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--noindent]
                                       [--prefix PREFIX]
                                       [--max-width <integer>] [--fit-width]
                                       [--print-empty]
                                       <driver>

表 11.110. positional 参数
概述

<driver>

驱动程序的名称。

表 11.111. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.112. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.113. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.114. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.115. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.28. 裸机内省中止

中止为节点运行内省。

使用方法:

openstack baremetal introspection abort [-h] node

表 11.116. positional 参数
概述

node

baremetal node uuid 或 name

表 11.117. 命令参数
概述

-h, --help

显示帮助信息并退出

11.29. 保存裸机内省数据

保存或显示原始内省数据。

使用方法:

openstack baremetal introspection data save [-h] [--file <filename>]
                                                   node

表 11.118. positional 参数
概述

node

baremetal node uuid 或 name

表 11.119. 命令参数
概述

-h, --help

显示帮助信息并退出

--file <filename>

下载内省数据文件名(默认:stdout)

11.30. 裸机内省接口列表

列出包括附加交换机端口信息的接口数据。

使用方法:

openstack baremetal introspection interface list [-h]
                                                        [-f {csv,json,table,value,yaml}]
                                                        [-c COLUMN]
                                                        [--quote {all,minimal,none,nonnumeric}]
                                                        [--noindent]
                                                        [--max-width <integer>]
                                                        [--fit-width]
                                                        [--print-empty]
                                                        [--sort-column SORT_COLUMN]
                                                        [--vlan VLAN]
                                                        [--long | --fields <field> [<field> ...]]
                                                        node_ident

表 11.120. positional 参数
概述

node_ident

baremetal node uuid 或 name

表 11.121. 命令参数
概述

-h, --help

显示帮助信息并退出

--vlan VLAN

仅列出为此 vlan id 配置的接口,才能重复

--long

显示接口的详细信息。

--fields <field> [<field> …​]

显示一个或多个字段。指定 -- long 时无法使用

表 11.122. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.123. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.124. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.125. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.31. 裸机内省接口显示

显示包括附加交换机端口信息的接口数据。

使用方法:

openstack baremetal introspection interface show [-h]
                                                        [-f {json,shell,table,value,yaml}]
                                                        [-c COLUMN]
                                                        [--noindent]
                                                        [--prefix PREFIX]
                                                        [--max-width <integer>]
                                                        [--fit-width]
                                                        [--print-empty]
                                                        [--fields <field> [<field> ...]]
                                                        node_ident interface

表 11.126. positional 参数
概述

node_ident

baremetal node uuid 或 name

interface

接口名称

表 11.127. 命令参数
概述

-h, --help

显示帮助信息并退出

--fields <field> [<field> …​]

显示一个或多个字段。

表 11.128. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.129. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.130. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.131. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.32. 裸机内省列表

列出内省状态

使用方法:

openstack baremetal introspection list [-h]
                                              [-f {csv,json,table,value,yaml}]
                                              [-c COLUMN]
                                              [--quote {all,minimal,none,nonnumeric}]
                                              [--noindent]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--sort-column SORT_COLUMN]
                                              [--marker MARKER]
                                              [--limit LIMIT]

表 11.132. 命令参数
概述

-h, --help

显示帮助信息并退出

--marker047ER

上一页上最后一个项目的 UUID

--limit LIMIT

要返回的项目数量

表 11.133. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.134. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.135. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.136. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.33. 裸机内省重新处理

重新处理存储内省数据

使用方法:

openstack baremetal introspection reprocess [-h] node

表 11.137. positional 参数
概述

node

baremetal node uuid 或 name

表 11.138. 命令参数
概述

-h, --help

显示帮助信息并退出

11.34. 裸机内省规则删除

删除内省规则。

使用方法:

openstack baremetal introspection rule delete [-h] uuid

表 11.139. positional 参数
概述

uuid

规则 uuid

表 11.140. 命令参数
概述

-h, --help

显示帮助信息并退出

11.35. 裸机内省规则导入

从 JSON/YAML 文件中导入一个或多个内省规则。

使用方法:

openstack baremetal introspection rule import [-h]
                                                     [-f {csv,json,table,value,yaml}]
                                                     [-c COLUMN]
                                                     [--quote {all,minimal,none,nonnumeric}]
                                                     [--noindent]
                                                     [--max-width <integer>]
                                                     [--fit-width]
                                                     [--print-empty]
                                                     [--sort-column SORT_COLUMN]
                                                     file

表 11.141. positional 参数
概述

file

要导入的 JSON 或 yaml 文件,可能包含一个或多个规则

表 11.142. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.143. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.144. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.145. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.146. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.36. 裸机内省规则列表

列出所有内省规则。

使用方法:

openstack baremetal introspection rule list [-h]
                                                   [-f {csv,json,table,value,yaml}]
                                                   [-c COLUMN]
                                                   [--quote {all,minimal,none,nonnumeric}]
                                                   [--noindent]
                                                   [--max-width <integer>]
                                                   [--fit-width]
                                                   [--print-empty]
                                                   [--sort-column SORT_COLUMN]

表 11.147. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.148. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.149. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.150. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.151. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.37. 裸机内省规则清除

丢弃所有内省规则。

使用方法:

openstack baremetal introspection rule purge [-h]

表 11.152. 命令参数
概述

-h, --help

显示帮助信息并退出

11.38. 裸机内省规则显示

显示内省规则。

使用方法:

openstack baremetal introspection rule show [-h]
                                                   [-f {json,shell,table,value,yaml}]
                                                   [-c COLUMN] [--noindent]
                                                   [--prefix PREFIX]
                                                   [--max-width <integer>]
                                                   [--fit-width]
                                                   [--print-empty]
                                                   uuid

表 11.153. positional 参数
概述

uuid

规则 uuid

表 11.154. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.155. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.156. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.157. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.158. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.39. 裸机内省开始

启动内省。

使用方法:

openstack baremetal introspection start [-h]
                                               [-f {csv,json,table,value,yaml}]
                                               [-c COLUMN]
                                               [--quote {all,minimal,none,nonnumeric}]
                                               [--noindent]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--sort-column SORT_COLUMN]
                                               [--wait] [--check-errors]
                                               node [node ...]

表 11.159. positional 参数
概述

node

裸机节点 uuid 或名称

表 11.160. 命令参数
概述

-h, --help

显示帮助信息并退出

--wait

等待内省完成;结果将显示在结尾

--check-errors

检查内省过程中是否发生错误;如果只显示任何错误,则只能用于 --wait

表 11.161. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.162. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.163. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.164. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.40. 裸机内省状态

获取内省状态。

使用方法:

openstack baremetal introspection status [-h]
                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN] [--noindent]
                                                [--prefix PREFIX]
                                                [--max-width <integer>]
                                                [--fit-width] [--print-empty]
                                                node

表 11.165. positional 参数
概述

node

baremetal node uuid 或 name

表 11.166. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.167. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.168. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.169. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.170. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.41. 裸机节点中止

将 baremetal 节点的置备状态设置为 abort

使用方法:

openstack baremetal node abort [-h] <node>

表 11.171. positional 参数
概述

<node>

节点的名称或 uuid。

表 11.172. 命令参数
概述

-h, --help

显示帮助信息并退出

11.42. baremetal 节点添加特征

为节点添加特征。

使用方法:

openstack baremetal node add trait [-h] <node> <trait> [<trait> ...]

表 11.173. positional 参数
概述

<node>

节点的名称或 uuid

<trait>

要添加的特征

表 11.174. 命令参数
概述

-h, --help

显示帮助信息并退出

11.43. 裸机节点采用

设置要采用的 baremetal 节点的置备状态

使用方法:

openstack baremetal node adopt [-h] [--wait [<time-out>]] <node>

表 11.175. positional 参数
概述

<node>

节点的名称或 uuid。

表 11.176. 命令参数
概述

-h, --help

显示帮助信息并退出

--wait [<time-out>]

等待节点达到所需状态 active。(可选)使用超时值(以秒为单位)。默认值为 0,表示它将无限期等待。

11.44. 裸机节点 bios 设置列表

列出节点的 BIOS 设置。

使用方法:

openstack baremetal node bios setting list [-h]
                                                  [-f {csv,json,table,value,yaml}]
                                                  [-c COLUMN]
                                                  [--quote {all,minimal,none,nonnumeric}]
                                                  [--noindent]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]
                                                  [--sort-column SORT_COLUMN]
                                                  <node>

表 11.177. positional 参数
概述

<node>

节点的名称或 uuid

表 11.178. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.179. 输出格式选项
概述

-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

--sort-column SORT_COLUMN

指定对数据进行排序的列(第一个指定的列具有优先级,不存在的列将被忽略)

表 11.180. CSV 格式化器选项
概述

--quote {all,minimal,none,nonnumeric}

当包含引号时,默认为非数字

表 11.181. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.182. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.45. 裸机节点 bios 设置显示

显示节点的特定 BIOS 设置。

使用方法:

openstack baremetal node bios setting show [-h]
                                                  [-f {json,shell,table,value,yaml}]
                                                  [-c COLUMN] [--noindent]
                                                  [--prefix PREFIX]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]
                                                  <node> <setting name>

表 11.183. positional 参数
概述

<node>

节点的名称或 uuid

<setting name>

设置显示的名称

表 11.184. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.185. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.186. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.187. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.188. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.46. 裸机节点引导设备集

为节点设置引导设备

使用方法:

openstack baremetal node boot device set [-h] [--persistent]
                                                <node> <device>

表 11.189. positional 参数
概述

<node>

节点的名称或 uuid

<device>

bios、cdrom、disk、pxe、safe、wanboot 之一

表 11.190. 命令参数
概述

-h, --help

显示帮助信息并退出

--persistent

使所有以后引导的更改都会永久保留

11.47. 裸机节点引导设备显示

显示节点的引导设备信息

使用方法:

openstack baremetal node boot device show [-h]
                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN] [--noindent]
                                                 [--prefix PREFIX]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 [--supported]
                                                 <node>

表 11.191. positional 参数
概述

<node>

节点的名称或 uuid

表 11.192. 命令参数
概述

-h, --help

显示帮助信息并退出

--supported

显示支持的引导设备

表 11.193. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.194. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.195. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.196. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.48. 裸机节点清理

将 baremetal 节点的置备状态设置为 clean

使用方法:

openstack baremetal node clean [-h] [--wait [<time-out>]] --clean-steps
                                      <clean-steps>
                                      <node>

表 11.197. positional 参数
概述

<node>

节点的名称或 uuid。

表 11.198. 命令参数
概述

-h, --help

显示帮助信息并退出

--wait [<time-out>]

等待节点进入所需的状态,可以管理。(可选)使用超时值(以秒为单位)。默认值为 0,表示它将无限期等待。

--clean-steps <clean-steps>

json 格式的清理步骤可以是包含清理步骤的文件的路径; OR -,以及从标准输入中读取的清理步骤 ; 或字符串。该值应该是干净步骤字典的列表;每个字典都应该具有键 接口和 步骤,以及可选的键 args

11.49. 裸机节点控制台禁用

禁用节点的控制台访问

使用方法:

openstack baremetal node console disable [-h] <node>

表 11.199. positional 参数
概述

<node>

节点的名称或 uuid

表 11.200. 命令参数
概述

-h, --help

显示帮助信息并退出

11.50. 裸机节点控制台启用

为节点启用控制台访问

使用方法:

openstack baremetal node console enable [-h] <node>

表 11.201. positional 参数
概述

<node>

节点的名称或 uuid

表 11.202. 命令参数
概述

-h, --help

显示帮助信息并退出

11.51. 裸机节点控制台显示

显示节点的控制台信息

使用方法:

openstack baremetal node console show [-h]
                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN] [--noindent]
                                             [--prefix PREFIX]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             <node>

表 11.203. positional 参数
概述

<node>

节点的名称或 uuid

表 11.204. 命令参数
概述

-h, --help

显示帮助信息并退出

表 11.205. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.206. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.207. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.208. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.52. 裸机节点创建

使用 baremetal 服务注册新节点

使用方法:

openstack baremetal node create [-h] [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--noindent]
                                       [--prefix PREFIX]
                                       [--max-width <integer>] [--fit-width]
                                       [--print-empty]
                                       [--chassis-uuid <chassis>] --driver
                                       <driver> [--driver-info <key=value>]
                                       [--property <key=value>]
                                       [--extra <key=value>] [--uuid <uuid>]
                                       [--name <name>]
                                       [--bios-interface <bios_interface>]
                                       [--boot-interface <boot_interface>]
                                       [--console-interface <console_interface>]
                                       [--deploy-interface <deploy_interface>]
                                       [--inspect-interface <inspect_interface>]
                                       [--management-interface <management_interface>]
                                       [--network-interface <network_interface>]
                                       [--power-interface <power_interface>]
                                       [--raid-interface <raid_interface>]
                                       [--rescue-interface <rescue_interface>]
                                       [--storage-interface <storage_interface>]
                                       [--vendor-interface <vendor_interface>]
                                       [--resource-class <resource_class>]
                                       [--conductor-group <conductor_group>]
                                       [--automated-clean] [--owner <owner>]
                                       [--description <description>]

表 11.209. 命令参数
概述

-h, --help

显示帮助信息并退出

--chassis-uuid <chassis>

此节点所属的机箱的 UUID。

--driver <driver>

用于控制节点 [必需] 的驱动。

--driver-info <key=value>

驱动程序使用的键/值对,如带外管理凭据。可多次指定。

--property <key=value>

描述节点的物理特征的键/值对。这会导出到 Nova,并由调度程序使用。可多次指定。

--extra <key=value>

记录任意键/值元数据。可以多次指定。

--uuid <uuid>

节点的唯一 uuid。

--name <name>

节点的唯一名称。

--bios-interface <bios_interface>

节点驱动程序使用的 BIOS 接口。这只在指定的 --driver 是硬件类型时才适用。

--boot-interface <boot_interface>

节点驱动程序使用的引导接口。这只在指定的 --driver 是硬件类型时才适用。

--console-interface <console_interface>

节点驱动程序使用的控制台界面。这只在指定的 --driver 是硬件类型时才适用。

--deploy-interface <deploy_interface>

部署节点驱动程序使用的接口。这只在指定的 --driver 是硬件类型时才适用。

--inspect-interface <inspect_interface>

检查节点驱动程序使用的接口。这只在指定的 --driver 是硬件类型时才适用。

--management-interface <management_interface>

节点驱动程序使用的管理界面。这只在指定的 --driver 是硬件类型时才适用。

--network-interface <network_interface>

用于切换节点以清理/置备网络的网络接口。

--power-interface <power_interface>

节点驱动程序使用的电源接口。这只在指定的 --driver 是硬件类型时才适用。

--raid-interface <raid_interface>

节点驱动程序使用的 RAID 接口。这只在指定的 --driver 是硬件类型时才适用。

--rescue-interface <rescue_interface>

节点驱动程序使用的救援接口。这只在指定的 --driver 是硬件类型时才适用。

--storage-interface <storage_interface>

节点驱动程序使用的存储接口。

--vendor-interface <vendor_interface>

节点驱动程序使用的厂商接口。这只在指定的 --driver 是硬件类型时才适用。

--resource-class <resource_class>

用于将节点映射到 nova 类型的资源类

--conductor-group <conductor_group>

节点所属的编排器组

--automated-clean

为节点启用自动清理

--owner <owner>

节点的所有者。

--description <description>

节点的描述。

表 11.210. 输出格式选项
概述

-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

输出格式,默认为 table

-c COLUMN, --column COLUMN

指定要包含的列,可以重复使用

表 11.211. JSON 格式化器选项
概述

--noindent

是否禁用缩进 json

表 11.212. shell 格式化器选项
概述

--prefix PREFIX

在所有变量名称中添加前缀

表 11.213. 表格式选项
概述

--max-width <integer>

最大显示宽度,<1 禁用。您也可以使用 CLIFF_MAX_TERM_WIDTH 环境变量,但参数具有优先权。

--fit-width

将表适合显示宽度。表示,如果 --max- width 大于 0。将环境变量 CLIFF_FIT_WIDTH=1 设置为始终启用

--print-empty

如果没有要显示的数据,请打印空表。

11.53. 裸机节点删除

取消注册裸机节点

使用方法:

openstack baremetal node delete [-h] <node> [<node> ...]

表 11.214. positional 参数
概述

<node>

要删除的节点(名称或 uuid)

表 11.215. 命令参数
概述

-h, --help

显示帮助信息并退出

11.54. 裸机节点部署

设置 要部署的裸机节点的置备状态

使用方法:

openstack baremetal node deploy [-h] [--wait [<time-out>]]
                                       [--config-drive <config-drive>]
                                       <node>

表 11.216. positional 参数
概述

<node>

节点的名称或 uuid。

表 11.217. 命令参数
概述

-h, --help

显示帮助信息并退出

--wait [<time-out>]

等待节点达到所需状态 active。(可选)使用超时值(以秒为单位)。默认值为 0,表示它将无限期等待。

--config-drive <config-drive>

gzipped, base64 编码的配置驱动器字符串,或者配置驱动器文件的路径,或者包含配置驱动器文件的目录的路径,或从中构建配置驱动器的 JSON 对象。如果是目录,则从中生成一个配置驱动器。如果是带有可选键 meta_datauser_data