此内容没有您所选择的语言版本。
Command Line Interface Reference
Command-line clients for Red Hat OpenStack Platform
Abstract
Preface
A reference to the commands available for the unified OpenStack command-line client.
Chapter 1. The OpenStack Client
The openstack
client is a common OpenStack command-line interface (CLI). This chapter documents the main options for openstack
version 3.18.1 . :leveloffset: +1
Command-line interface to the OpenStack APIs
Usage:
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-system-scope <auth-system-scope>] [--os-domain-id <auth-domain-id>] [--os-domain-name <auth-domain-name>] [--os-project-id <auth-project-id>] [--os-project-name <auth-project-name>] [--os-project-domain-id <auth-project-domain-id>] [--os-project-domain-name <auth-project-domain-name>] [--os-trust-id <auth-trust-id>] [--os-identity-provider <auth-identity-provider>] [--os-protocol <auth-protocol>] [--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-username <auth-username>] [--os-password <auth-password>] [--os-endpoint <auth-endpoint>] [--os-token <auth-token>] [--os-default-domain-id <auth-default-domain-id>] [--os-default-domain-name <auth-default-domain-name>] [--os-user-id <auth-user-id>] [--os-user-domain-id <auth-user-domain-id>] [--os-user-domain-name <auth-user-domain-name>] [--os-passcode <auth-passcode>] [--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>] [--os-roles <auth-roles>] [--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-aodh-endpoint <auth-aodh-endpoint>] [--os-redirect-uri <auth-redirect-uri>] [--os-code <auth-code>] [--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-url <auth-url>] [--os-access-token <auth-access-token>]
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-system-scope <auth-system-scope>]
[--os-domain-id <auth-domain-id>]
[--os-domain-name <auth-domain-name>]
[--os-project-id <auth-project-id>]
[--os-project-name <auth-project-name>]
[--os-project-domain-id <auth-project-domain-id>]
[--os-project-domain-name <auth-project-domain-name>]
[--os-trust-id <auth-trust-id>]
[--os-identity-provider <auth-identity-provider>]
[--os-protocol <auth-protocol>]
[--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-username <auth-username>]
[--os-password <auth-password>]
[--os-endpoint <auth-endpoint>] [--os-token <auth-token>]
[--os-default-domain-id <auth-default-domain-id>]
[--os-default-domain-name <auth-default-domain-name>]
[--os-user-id <auth-user-id>]
[--os-user-domain-id <auth-user-domain-id>]
[--os-user-domain-name <auth-user-domain-name>]
[--os-passcode <auth-passcode>] [--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>]
[--os-roles <auth-roles>]
[--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-aodh-endpoint <auth-aodh-endpoint>]
[--os-redirect-uri <auth-redirect-uri>]
[--os-code <auth-code>]
[--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-url <auth-url>] [--os-access-token <auth-access-token>]
Value | Summary |
---|---|
--version | Show program’s version number and exit |
-v, --verbose | Increase verbosity of output. can be repeated. |
-q, --quiet | Suppress output except warnings and errors. |
--log-file LOG_FILE | Specify a file to log output. disabled by default. |
-h, --help | Show help message and exit. |
--debug | Show tracebacks on errors. |
--os-cloud <cloud-config-name> | Cloud name in clouds.yaml (env: os_cloud) |
--os-region-name <auth-region-name> | Authentication region name (env: os_region_name) |
--os-cacert <ca-bundle-file> | Ca certificate bundle file (env: os_cacert) |
--os-cert <certificate-file> | Client certificate bundle file (env: os_cert) |
--os-key <key-file> | Client certificate key file (env: os_key) |
--verify | Verify server certificate (default) |
--insecure | Disable server certificate verification |
--os-default-domain <auth-domain> | Default domain id, default=default. (env: OS_DEFAULT_DOMAIN) |
--os-interface <interface> | Select an interface type. valid interface types: [admin, public, internal]. default=public, (Env: OS_INTERFACE) |
--os-service-provider <service_provider> | Authenticate with and perform the command on a service provider using Keystone-to-keystone federation. Must also specify the remote project option. |
--os-remote-project-name <remote_project_name> | Project name when authenticating to a service provider if using Keystone-to-Keystone federation. |
--os-remote-project-id <remote_project_id> | Project id when authenticating to a service provider if using Keystone-to-Keystone federation. |
--os-remote-project-domain-name <remote_project_domain_name> | Domain name of the project when authenticating to a service provider if using Keystone-to-Keystone federation. |
--os-remote-project-domain-id <remote_project_domain_id> | Domain id of the project when authenticating to a service provider if using Keystone-to-Keystone federation. |
--timing | Print api call timing info |
--os-beta-command | Enable beta commands which are subject to change |
--os-profile hmac-key | Hmac key for encrypting profiling context data |
--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> | Object api version, default=1 (env: OS_OBJECT_API_VERSION) |
--os-volume-api-version <volume-api-version> | Volume api version, default=2 (env: OS_VOLUME_API_VERSION) |
--os-queues-api-version <queues-api-version> | Queues api version, default=2 (env: OS_QUEUES_API_VERSION) |
--os-database-api-version <database-api-version> | Database api version, 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> | Data processing api version, default=1.1 (env: OS_DATA_PROCESSING_API_VERSION) |
--os-data-processing-url OS_DATA_PROCESSING_URL | Data processing api url, (env: OS_DATA_PROCESSING_API_URL) |
--os-loadbalancer-api-version <loadbalancer-api-version> | Osc plugin api version, default=2.0 (env: OS_LOADBALANCER_API_VERSION) |
--os-workflow-api-version <workflow-api-version> | Workflow api version, default=2 (env: OS_WORKFLOW_API_VERSION) |
--os-container-infra-api-version <container-infra-api-version> | Container-infra api version, default=1 (env: OS_CONTAINER_INFRA_API_VERSION) |
--os-baremetal-api-version <baremetal-api-version> | Bare metal api version, default="latest" (the maximum version supported by both the client and the server). (Env: OS_BAREMETAL_API_VERSION) |
--inspector-api-version INSPECTOR_API_VERSION | Inspector api version, only 1 is supported now (env: INSPECTOR_VERSION). |
--inspector-url INSPECTOR_URL | Inspector url, defaults to 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 version, default=2 (env: os_dns_api_version) |
--os-key-manager-api-version <key-manager-api-version> | Barbican api version, 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> | Queues api version, default=2 (env: OS_ALARMING_API_VERSION) |
--os-auth-type <auth-type> | Select an authentication type. available types: v3oidcpassword, admin_token, password, v3totp, noauth, none, v3oidcclientcredentials, gnocchi-basic, v3oauth1, v3tokenlessauth, v3token, gnocchi-noauth, v3applicationcredential, aodh-noauth, v2password, v3password, v2token, v3oidcauthcode, v3adfspassword, v3samlpassword, token_endpoint, v1password, token, v3oidcaccesstoken. Default: selected based on --os- username/--os-token (Env: OS_AUTH_TYPE) |
--os-auth-url <auth-auth-url> | With v3oidcpassword: authentication url with password: Authentication URL With v3totp: Authentication URL With v3oidcclientcredentials: Authentication URL With v3oauth1: Authentication URL With v3tokenlessauth: Authentication URL With v3token: Authentication URL With v3applicationcredential: Authentication URL With v2password: Authentication URL With v3password: Authentication URL With v2token: Authentication URL With v3oidcauthcode: Authentication URL With v3adfspassword: Authentication URL With v3samlpassword: Authentication URL With v1password: Authentication URL With token: Authentication URL With v3oidcaccesstoken: Authentication URL (Env: OS_AUTH_URL) |
--os-system-scope <auth-system-scope> | With v3oidcpassword: scope for system operations with password: Scope for system operations With v3totp: Scope for system operations With v3oidcclientcredentials: Scope for system operations With v3token: Scope for system operations With v3applicationcredential: Scope for system operations With v3password: Scope for system operations With v3oidcauthcode: Scope for system operations With v3adfspassword: Scope for system operations With v3samlpassword: Scope for system operations With token: Scope for system operations With v3oidcaccesstoken: Scope for system operations (Env: OS_SYSTEM_SCOPE) |
--os-domain-id <auth-domain-id> | With v3oidcpassword: domain id to scope to with password: Domain ID to scope to With v3totp: Domain ID to scope to With v3oidcclientcredentials: Domain ID to scope to With v3tokenlessauth: Domain ID to scope to With v3token: Domain ID to scope to With v3applicationcredential: Domain ID to scope to With v3password: Domain ID to scope to With v3oidcauthcode: Domain ID to scope to With v3adfspassword: Domain ID to scope to With v3samlpassword: Domain ID to scope to With token: Domain ID to scope to With v3oidcaccesstoken: Domain ID to scope to (Env: OS_DOMAIN_ID) |
--os-domain-name <auth-domain-name> | With v3oidcpassword: domain name to scope to with password: Domain name to scope to With v3totp: Domain name to scope to With v3oidcclientcredentials: Domain name to scope to With v3tokenlessauth: Domain name to scope to With v3token: Domain name to scope to With v3applicationcredential: Domain name to scope to With v3password: Domain name to scope to With v3oidcauthcode: Domain name to scope to With v3adfspassword: Domain name to scope to With v3samlpassword: Domain name to scope to With token: Domain name to scope to With v3oidcaccesstoken: Domain name to scope to (Env: OS_DOMAIN_NAME) |
--os-project-id <auth-project-id> | With v3oidcpassword: project id to scope to with password: Project ID to scope to With v3totp: Project ID to scope to With noauth: Project ID With v3oidcclientcredentials: Project ID to scope to With v3tokenlessauth: Project ID to scope to With v3token: Project ID to scope to With gnocchi-noauth: Project ID With v3applicationcredential: Project ID to scope to With aodh-noauth: Project ID With v3password: Project ID to scope to With v3oidcauthcode: Project ID to scope to With v3adfspassword: Project ID to scope to With v3samlpassword: Project ID to scope to With token: Project ID to scope to With v3oidcaccesstoken: Project ID to scope to (Env: OS_PROJECT_ID) |
--os-project-name <auth-project-name> | With v3oidcpassword: project name to scope to with password: Project name to scope to With v3totp: Project name to scope to With v3oidcclientcredentials: Project name to scope to With v3tokenlessauth: Project name to scope to With v3token: Project name to scope to With v3applicationcredential: Project name to scope to With v3password: Project name to scope to With v3oidcauthcode: Project name to scope to With v3adfspassword: Project name to scope to With v3samlpassword: Project name to scope to With v1password: Swift account to use With token: Project name to scope to With v3oidcaccesstoken: Project name to scope to (Env: OS_PROJECT_NAME) |
--os-project-domain-id <auth-project-domain-id> | With v3oidcpassword: domain id containing project with password: Domain ID containing project With v3totp: Domain ID containing project With v3oidcclientcredentials: Domain ID containing project With v3tokenlessauth: Domain ID containing project With v3token: Domain ID containing project With v3applicationcredential: Domain ID containing project With v3password: Domain ID containing project With v3oidcauthcode: Domain ID containing project With v3adfspassword: Domain ID containing project With v3samlpassword: Domain ID containing project With token: Domain ID containing project With v3oidcaccesstoken: Domain ID containing project (Env: OS_PROJECT_DOMAIN_ID) |
--os-project-domain-name <auth-project-domain-name> | With v3oidcpassword: domain name containing project With password: Domain name containing project With v3totp: Domain name containing project With v3oidcclientcredentials: Domain name containing project With v3tokenlessauth: Domain name containing project With v3token: Domain name containing project With v3applicationcredential: Domain name containing project With v3password: Domain name containing project With v3oidcauthcode: Domain name containing project With v3adfspassword: Domain name containing project With v3samlpassword: Domain name containing project With token: Domain name containing project With v3oidcaccesstoken: Domain name containing project (Env: OS_PROJECT_DOMAIN_NAME) |
--os-trust-id <auth-trust-id> | With v3oidcpassword: trust id with password: trust id With v3totp: Trust ID With v3oidcclientcredentials: Trust ID With v3token: Trust ID With v3applicationcredential: Trust ID With v2password: Trust ID With v3password: Trust ID With v2token: Trust ID With v3oidcauthcode: Trust ID With v3adfspassword: Trust ID With v3samlpassword: Trust ID With token: Trust ID With v3oidcaccesstoken: Trust ID (Env: OS_TRUST_ID) |
--os-identity-provider <auth-identity-provider> | With v3oidcpassword: identity provider’s name with v3oidcclientcredentials: Identity Provider’s name With v3oidcauthcode: Identity Provider’s name With v3adfspassword: Identity Provider’s name With v3samlpassword: Identity Provider’s name With v3oidcaccesstoken: Identity Provider’s name (Env: OS_IDENTITY_PROVIDER) |
--os-protocol <auth-protocol> | With v3oidcpassword: protocol for federated plugin With v3oidcclientcredentials: Protocol for federated plugin With v3oidcauthcode: Protocol for federated plugin With v3adfspassword: Protocol for federated plugin With v3samlpassword: Protocol for federated plugin With v3oidcaccesstoken: Protocol for federated plugin (Env: OS_PROTOCOL) |
--os-client-id <auth-client-id> | With v3oidcpassword: oauth 2.0 client id with v3oidcclientcredentials: OAuth 2.0 Client ID With v3oidcauthcode: OAuth 2.0 Client ID (Env: OS_CLIENT_ID) |
--os-client-secret <auth-client-secret> | With v3oidcpassword: oauth 2.0 client secret with v3oidcclientcredentials: OAuth 2.0 Client Secret With v3oidcauthcode: OAuth 2.0 Client Secret (Env: OS_CLIENT_SECRET) |
--os-openid-scope <auth-openid-scope> | With v3oidcpassword: openid connect scope that is requested from authorization server. Note that the OpenID Connect specification states that "openid" must be always specified. With v3oidcclientcredentials: OpenID Connect scope that is requested from authorization server. Note that the OpenID Connect specification states that "openid" must be always specified. With v3oidcauthcode: OpenID Connect scope that is requested from authorization server. Note that the OpenID Connect specification states that "openid" must be always specified. (Env: OS_OPENID_SCOPE) |
--os-access-token-endpoint <auth-access-token-endpoint> | With v3oidcpassword: openid connect provider token Endpoint. Note that if a discovery document is being passed this option will override the endpoint provided by the server in the discovery document. With v3oidcclientcredentials: OpenID Connect Provider Token Endpoint. Note that if a discovery document is being passed this option will override the endpoint provided by the server in the discovery document. With v3oidcauthcode: OpenID Connect Provider Token Endpoint. Note that if a discovery document is being passed this option will override the endpoint provided by the server in the discovery document. (Env: OS_ACCESS_TOKEN_ENDPOINT) |
--os-discovery-endpoint <auth-discovery-endpoint> | With v3oidcpassword: openid connect discovery document URL. The discovery document will be used to obtain the values of the access token endpoint and the authentication endpoint. This URL should look like https://idp.example.org/.well-known/openid- configuration With v3oidcclientcredentials: OpenID Connect Discovery Document URL. The discovery document will be used to obtain the values of the access token endpoint and the authentication endpoint. This URL should look like https://idp.example.org/.well- known/openid-configuration With v3oidcauthcode: OpenID Connect Discovery Document URL. The discovery document will be used to obtain the values of the access token endpoint and the authentication endpoint. This URL should look like https://idp.example.org/.well- known/openid-configuration (Env: OS_DISCOVERY_ENDPOINT) |
--os-access-token-type <auth-access-token-type> | With v3oidcpassword: oauth 2.0 authorization server Introspection token type, it is used to decide which type of token will be used when processing token introspection. Valid values are: "access_token" or "id_token" With v3oidcclientcredentials: OAuth 2.0 Authorization Server Introspection token type, it is used to decide which type of token will be used when processing token introspection. Valid values are: "access_token" or "id_token" With v3oidcauthcode: OAuth 2.0 Authorization Server Introspection token type, it is used to decide which type of token will be used when processing token introspection. Valid values are: "access_token" or "id_token" (Env: OS_ACCESS_TOKEN_TYPE) |
--os-username <auth-username> | With v3oidcpassword: username with password: username With v3totp: Username With v3applicationcredential: Username With v2password: Username to login with With v3password: Username With v3adfspassword: Username With v3samlpassword: Username With v1password: Username to login with (Env: OS_USERNAME) |
--os-password <auth-password> | With v3oidcpassword: password with password: user’s password With v2password: Password to use With v3password: User’s password With v3adfspassword: Password With v3samlpassword: Password With v1password: Password to use (Env: OS_PASSWORD) |
--os-endpoint <auth-endpoint> | With admin_token: the endpoint that will always be used With noauth: Cinder endpoint With none: The endpoint that will always be used With gnocchi-basic: Gnocchi endpoint With gnocchi-noauth: Gnocchi endpoint (Env: OS_ENDPOINT) |
--os-token <auth-token> | With admin_token: the token that will always be used With v3token: Token to authenticate with With v2token: Token With token_endpoint: Authentication token to use With token: Token to authenticate with (Env: OS_TOKEN) |
--os-default-domain-id <auth-default-domain-id> | With password: optional domain id to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication. With token: Optional domain ID to use with v3 and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication. (Env: OS_DEFAULT_DOMAIN_ID) |
--os-default-domain-name <auth-default-domain-name> | With password: optional domain name to use with v3 api and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication. With token: Optional domain name to use with v3 API and v2 parameters. It will be used for both the user and project domain in v3 and ignored in v2 authentication. (Env: OS_DEFAULT_DOMAIN_NAME) |
--os-user-id <auth-user-id> | With password: user id with v3totp: user id with noauth: User ID With gnocchi-noauth: User ID With v3applicationcredential: User ID With aodh-noauth: User ID With v2password: User ID to login with With v3password: User ID (Env: OS_USER_ID) |
--os-user-domain-id <auth-user-domain-id> | With password: user’s domain id with v3totp: user’s domain id With v3applicationcredential: User’s domain id With v3password: User’s domain id (Env: OS_USER_DOMAIN_ID) |
--os-user-domain-name <auth-user-domain-name> | With password: user’s domain name with v3totp: user’s domain name With v3applicationcredential: User’s domain name With v3password: User’s domain name (Env: OS_USER_DOMAIN_NAME) |
--os-passcode <auth-passcode> | With v3totp: user’s totp passcode (env: os_passcode) |
--os-user <auth-user> | With gnocchi-basic: user (env: os_user) |
--os-consumer-key <auth-consumer-key> | With v3oauth1: oauth consumer id/key (env: OS_CONSUMER_KEY) |
--os-consumer-secret <auth-consumer-secret> | With v3oauth1: oauth consumer secret (env: OS_CONSUMER_SECRET) |
--os-access-key <auth-access-key> | With v3oauth1: oauth access key (env: os_access_key) |
--os-access-secret <auth-access-secret> | With v3oauth1: oauth access secret (env: OS_ACCESS_SECRET) |
--os-roles <auth-roles> | With gnocchi-noauth: roles with aodh-noauth: roles (Env: OS_ROLES) |
--os-application-credential-secret <auth-application-credential-secret> | With v3applicationcredential: application credential auth secret (Env: OS_APPLICATION_CREDENTIAL_SECRET) |
--os-application-credential-id <auth-application-credential-id> | With v3applicationcredential: application credential ID (Env: OS_APPLICATION_CREDENTIAL_ID) |
--os-application-credential-name <auth-application-credential-name> | With v3applicationcredential: application credential name (Env: OS_APPLICATION_CREDENTIAL_NAME) |
--os-aodh-endpoint <auth-aodh-endpoint> | With aodh-noauth: aodh endpoint (env: OS_AODH_ENDPOINT) |
--os-redirect-uri <auth-redirect-uri> | With v3oidcauthcode: openid connect redirect url (env: OS_REDIRECT_URI) |
--os-code <auth-code> | With v3oidcauthcode: oauth 2.0 authorization code (Env: OS_CODE) |
--os-identity-provider-url <auth-identity-provider-url> | With v3adfspassword: an identity provider url, where the SAML authentication request will be sent. With v3samlpassword: An Identity Provider URL, where the SAML2 authentication request will be sent. (Env: OS_IDENTITY_PROVIDER_URL) |
--os-service-provider-endpoint <auth-service-provider-endpoint> | With v3adfspassword: service provider’s endpoint (env: OS_SERVICE_PROVIDER_ENDPOINT) |
--os-service-provider-entity-id <auth-service-provider-entity-id> | With v3adfspassword: service provider’s saml entity id (Env: OS_SERVICE_PROVIDER_ENTITY_ID) |
--os-url <auth-url> | With token_endpoint: specific service endpoint to use (Env: OS_URL) |
--os-access-token <auth-access-token> | With v3oidcaccesstoken: oauth 2.0 access token (env: OS_ACCESS_TOKEN) |
Chapter 2. access
This chapter describes the commands under the access
command.
2.1. access token create
Create an access token
Usage:
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>
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>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--consumer-key <consumer-key> | Consumer key (required) |
--consumer-secret <consumer-secret> | Consumer secret (required) |
--request-key <request-key> | Request token to exchange for access token (required) |
--request-secret <request-secret> | Secret associated with <request-key> (required) |
--verifier <verifier> | Verifier associated with <request-key> (required) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 3. acl
This chapter describes the commands under the acl
command.
3.1. acl delete
Delete ACLs for a secret or container as identified by its href.
Usage:
openstack acl delete [-h] URI
openstack acl delete [-h] URI
Value | Summary |
---|---|
URI | The uri reference for the secret or container. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
3.2. acl get
Retrieve ACLs for a secret or container by providing its href.
Usage:
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
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
Value | Summary |
---|---|
URI | The uri reference for the secret or container. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
3.3. acl submit
Submit ACL on a secret or container as identified by its href.
Usage:
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
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
Value | Summary |
---|---|
URI | The uri reference for the secret or container. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user [USERS], -u [USERS] | Keystone userid(s) for acl. |
--project-access | Flag to enable project access behavior. |
--no-project-access | Flag to disable project access behavior. |
--operation-type {read}, -o {read} | Type of barbican operation acl is set for |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
3.4. acl user add
Add ACL users to a secret or container as identified by its href.
Usage:
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
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
Value | Summary |
---|---|
URI | The uri reference for the secret or container. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user [USERS], -u [USERS] | Keystone userid(s) for acl. |
--project-access | Flag to enable project access behavior. |
--no-project-access | Flag to disable project access behavior. |
--operation-type {read}, -o {read} | Type of barbican operation acl is set for |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
3.5. acl user remove
Remove ACL users from a secret or container as identified by its href.
Usage:
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
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
Value | Summary |
---|---|
URI | The uri reference for the secret or container. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user [USERS], -u [USERS] | Keystone userid(s) for acl. |
--project-access | Flag to enable project access behavior. |
--no-project-access | Flag to disable project access behavior. |
--operation-type {read}, -o {read} | Type of barbican operation acl is set for |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 4. action
This chapter describes the commands under the action
command.
4.1. action definition create
Create new action.
Usage:
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
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
Value | Summary |
---|---|
definition | Action definition file |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
--public | With this flag action will be marked as "public". |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.2. action definition definition show
Show action definition.
Usage:
openstack action definition definition show [-h] name
openstack action definition definition show [-h] name
Value | Summary |
---|---|
name | Action name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
4.3. action definition delete
Delete action.
Usage:
openstack action definition delete [-h] action [action ...]
openstack action definition delete [-h] action [action ...]
Value | Summary |
---|---|
action | Name or id of action(s). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
4.4. action definition list
List all actions.
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.5. action definition show
Show specific action.
Usage:
openstack action definition show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] action
openstack action definition show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
action
Value | Summary |
---|---|
action | Action (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.6. action definition update
Update action.
Usage:
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
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
Value | Summary |
---|---|
definition | Action definition file |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
--id ID | Action id. |
--public | With this flag action will be marked as "public". |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.7. action execution delete
Delete action execution.
Usage:
openstack action execution delete [-h] action_execution [action_execution ...]
openstack action execution delete [-h]
action_execution
[action_execution ...]
Value | Summary |
---|---|
action_execution | Id of action execution identifier(s). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
4.8. action execution input show
Show Action execution input data.
Usage:
openstack action execution input show [-h] id
openstack action execution input show [-h] id
Value | Summary |
---|---|
id | Action execution id. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
4.9. action execution list
List all Action executions.
Usage:
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]
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]
Value | Summary |
---|---|
task_execution_id | Task execution id. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
--oldest | Display the executions starting from the oldest entries instead of the newest |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.10. action execution output show
Show Action execution output data.
Usage:
openstack action execution output show [-h] id
openstack action execution output show [-h] id
Value | Summary |
---|---|
id | Action execution id. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
4.11. action execution run
Create new Action execution or just run specific action.
Usage:
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]
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]
Value | Summary |
---|---|
name | Action name to execute. |
input | Action input. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-s, --save-result | Save the result into db. |
--run-sync | Run the action synchronously. |
-t TARGET, --target TARGET | Action will be executed on <target> executor. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.12. action execution show
Show specific Action execution.
Usage:
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
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
Value | Summary |
---|---|
action_execution | Action execution id. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
4.13. action execution update
Update specific Action execution.
Usage:
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
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
Value | Summary |
---|---|
id | Action execution id. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--state {PAUSED,RUNNING,SUCCESS,ERROR,CANCELLED} | Action execution state |
--output OUTPUT | Action execution output |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 5. address
This chapter describes the commands under the address
command.
5.1. address scope create
Create a new Address Scope
Usage:
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>
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>
Value | Summary |
---|---|
<name> | New address scope name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--ip-version {4,6} | Ip version (default is 4) |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--share | Share the address scope between projects |
--no-share | Do not share the address scope between projects (default) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
5.2. address scope delete
Delete address scope(s)
Usage:
openstack address scope delete [-h] <address-scope> [<address-scope> ...]
openstack address scope delete [-h]
<address-scope> [<address-scope> ...]
Value | Summary |
---|---|
<address-scope> | Address scope(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
5.3. address scope list
List address scopes
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | List only address scopes of given name in output |
--ip-version <ip-version> | List address scopes of given ip version networks (4 or 6) |
--project <project> | List address scopes according to their project (name or ID) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--share | List address scopes shared between projects |
--no-share | List address scopes not shared between projects |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
5.4. address scope set
Set address scope properties
Usage:
openstack address scope set [-h] [--name <name>] [--share | --no-share] <address-scope>
openstack address scope set [-h] [--name <name>] [--share | --no-share]
<address-scope>
Value | Summary |
---|---|
<address-scope> | Address scope to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set address scope name |
--share | Share the address scope between projects |
--no-share | Do not share the address scope between projects |
5.5. address scope show
Display address scope details
Usage:
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>
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>
Value | Summary |
---|---|
<address-scope> | Address scope to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 6. aggregate
This chapter describes the commands under the aggregate
command.
6.1. aggregate add host
Add host to aggregate
Usage:
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>
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>
Value | Summary |
---|---|
<aggregate> | Aggregate (name or id) |
<host> | Host to add to <aggregate> |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
6.2. aggregate create
Create a new aggregate
Usage:
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>
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>
Value | Summary |
---|---|
<name> | New aggregate name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--zone <availability-zone> | Availability zone name |
--property <key=value> | Property to add to this aggregate (repeat option to set multiple properties) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
6.3. aggregate delete
Delete existing aggregate(s)
Usage:
openstack aggregate delete [-h] <aggregate> [<aggregate> ...]
openstack aggregate delete [-h] <aggregate> [<aggregate> ...]
Value | Summary |
---|---|
<aggregate> | Aggregate(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
6.4. aggregate list
List all aggregates
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
6.5. aggregate remove host
Remove host from aggregate
Usage:
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>
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>
Value | Summary |
---|---|
<aggregate> | Aggregate (name or id) |
<host> | Host to remove from <aggregate> |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
6.6. aggregate set
Set aggregate properties
Usage:
openstack aggregate set [-h] [--name <name>] [--zone <availability-zone>] [--property <key=value>] [--no-property] <aggregate>
openstack aggregate set [-h] [--name <name>]
[--zone <availability-zone>]
[--property <key=value>] [--no-property]
<aggregate>
Value | Summary |
---|---|
<aggregate> | Aggregate to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set aggregate name |
--zone <availability-zone> | Set availability zone name |
--property <key=value> | Property to set on <aggregate> (repeat option to set multiple properties) |
--no-property | Remove all properties from <aggregate> (specify both --property and --no-property to overwrite the current properties) |
6.7. aggregate show
Display aggregate details
Usage:
openstack aggregate show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <aggregate>
openstack aggregate show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<aggregate>
Value | Summary |
---|---|
<aggregate> | Aggregate to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
6.8. aggregate unset
Unset aggregate properties
Usage:
openstack aggregate unset [-h] [--property <key>] <aggregate>
openstack aggregate unset [-h] [--property <key>] <aggregate>
Value | Summary |
---|---|
<aggregate> | Aggregate to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key> | Property to remove from aggregate (repeat option to remove multiple properties) |
Chapter 7. alarm
This chapter describes the commands under the alarm
command.
7.1. alarm create
Create an alarm
Usage:
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>]
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>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <NAME> | Name of the alarm |
-t <TYPE>, --type <TYPE> | Type of alarm, should be one of: event, composite, gnocchi_resources_threshold, gnocchi_aggregation_by_metrics_threshold, gnocchi_aggregation_by_resources_threshold. |
--project-id <PROJECT_ID> | Project to associate with alarm (configurable by admin users only) |
--user-id <USER_ID> | User to associate with alarm (configurable by admin users only) |
--description <DESCRIPTION> | Free text description of the alarm |
--state <STATE> | State of the alarm, one of: [ok, alarm, insufficient data] |
--severity <SEVERITY> | Severity of the alarm, one of: [low, moderate, critical] |
--enabled {True | False} |
True if alarm evaluation is enabled | --alarm-action <Webhook URL> |
Url to invoke when state transitions to alarm. may be used multiple times | --ok-action <Webhook URL> |
Url to invoke when state transitions to ok. may be used multiple times | --insufficient-data-action <Webhook URL> |
Url to invoke when state transitions to insufficient data. May be used multiple times | --time-constraint <Time Constraint> |
Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression, whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] | --repeat-actions {True |
False} | True if actions should be repeatedly notified while alarm remains in target state |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Value | Summary |
---|---|
--query <QUERY> | For alarms of type event: key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean. For alarms of type gnocchi_aggregation_by_resources_threshold: need to specify a complex query json string, like: {"and": [{"=": {"ended_at": null}}, …]}. |
--comparison-operator <OPERATOR> | Operator to compare with, one of: [lt, le, eq, ne, ge, gt] |
--evaluation-periods <EVAL_PERIODS> | Number of periods to evaluate over |
--threshold <THRESHOLD> | Threshold to evaluate against. |
Value | Summary |
---|---|
--event-type <EVENT_TYPE> | Event type to evaluate against |
Value | Summary |
---|---|
--granularity <GRANULARITY> | The time range in seconds over which to query. |
--aggregation-method <AGGR_METHOD> | The aggregation_method to compare to the threshold. |
--metric <METRIC>, --metrics <METRIC> | The metric id or name depending of the alarm type |
Value | Summary |
---|---|
--resource-type <RESOURCE_TYPE> | The type of resource. |
--resource-id <RESOURCE_ID> | The id of a resource. |
Value | Summary |
---|---|
--composite-rule <COMPOSITE_RULE> | Composite threshold rule with json format, the form can be a nested dict which combine gnocchi rules by "and", "or". For example, the form is like: {"or":[RULE1, RULE2, {"and": [RULE3, RULE4]}]}. |
7.2. alarm delete
Delete an alarm
Usage:
openstack alarm delete [-h] [--name <NAME>] [<ALARM ID or NAME>]
openstack alarm delete [-h] [--name <NAME>] [<ALARM ID or NAME>]
Value | Summary |
---|---|
<ALARM ID or NAME> | Id or name of an alarm. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <NAME> | Name of the alarm |
7.3. alarm-history search
Show history for all alarms based on query
Usage:
openstack alarm-history search [-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]
openstack alarm-history search [-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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--query QUERY | Rich query supported by aodh, e.g. project_id!=my-id user_id=foo or user_id=bar |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
7.4. alarm-history show
Show history for an alarm
Usage:
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>
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>
Value | Summary |
---|---|
<alarm-id> | Id of an alarm |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <LIMIT> | Number of resources to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value,the supported marker is event_id. |
--sort <SORT_KEY:SORT_DIR> | Sort of resource attribute. e.g. timestamp:desc |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
7.5. alarm list
List alarms
Usage:
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>]
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>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--query QUERY | Rich query supported by aodh, e.g. project_id!=my-id user_id=foo or user_id=bar |
--filter <KEY1=VALUE1;KEY2=VALUE2…> | Filter parameters to apply on returned alarms. |
--limit <LIMIT> | Number of resources to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value,the supported marker is alarm_id. |
--sort <SORT_KEY:SORT_DIR> | Sort of resource attribute, e.g. name:asc |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
7.6. alarm show
Show an alarm
Usage:
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>]
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>]
Value | Summary |
---|---|
<ALARM ID or NAME> | Id or name of an alarm. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <NAME> | Name of the alarm |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
7.7. alarm state get
Get state of an alarm
Usage:
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>]
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>]
Value | Summary |
---|---|
<ALARM ID or NAME> | Id or name of an alarm. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <NAME> | Name of the alarm |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
7.8. alarm state set
Set state of an alarm
Usage:
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>]
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>]
Value | Summary |
---|---|
<ALARM ID or NAME> | Id or name of an alarm. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <NAME> | Name of the alarm |
--state <STATE> | State of the alarm, one of: [ok, alarm, insufficient data] |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
7.9. alarm update
Update an alarm
Usage:
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>]
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>]
Value | Summary |
---|---|
<ALARM ID or NAME> | Id or name of an alarm. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <NAME> | Name of the alarm |
-t <TYPE>, --type <TYPE> | Type of alarm, should be one of: event, composite, gnocchi_resources_threshold, gnocchi_aggregation_by_metrics_threshold, gnocchi_aggregation_by_resources_threshold. |
--project-id <PROJECT_ID> | Project to associate with alarm (configurable by admin users only) |
--user-id <USER_ID> | User to associate with alarm (configurable by admin users only) |
--description <DESCRIPTION> | Free text description of the alarm |
--state <STATE> | State of the alarm, one of: [ok, alarm, insufficient data] |
--severity <SEVERITY> | Severity of the alarm, one of: [low, moderate, critical] |
--enabled {True | False} |
True if alarm evaluation is enabled | --alarm-action <Webhook URL> |
Url to invoke when state transitions to alarm. may be used multiple times | --ok-action <Webhook URL> |
Url to invoke when state transitions to ok. may be used multiple times | --insufficient-data-action <Webhook URL> |
Url to invoke when state transitions to insufficient data. May be used multiple times | --time-constraint <Time Constraint> |
Only evaluate the alarm if the time at evaluation is within this time constraint. Start point(s) of the constraint are specified with a cron expression, whereas its duration is given in seconds. Can be specified multiple times for multiple time constraints, format is: name=<CONSTRAINT_NAME>;start=< CRON>;duration=<SECONDS>;[description=<DESCRIPTION>;[t imezone=<IANA Timezone>]] | --repeat-actions {True |
False} | True if actions should be repeatedly notified while alarm remains in target state |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Value | Summary |
---|---|
--query <QUERY> | For alarms of type event: key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean. For alarms of type gnocchi_aggregation_by_resources_threshold: need to specify a complex query json string, like: {"and": [{"=": {"ended_at": null}}, …]}. |
--comparison-operator <OPERATOR> | Operator to compare with, one of: [lt, le, eq, ne, ge, gt] |
--evaluation-periods <EVAL_PERIODS> | Number of periods to evaluate over |
--threshold <THRESHOLD> | Threshold to evaluate against. |
Value | Summary |
---|---|
--event-type <EVENT_TYPE> | Event type to evaluate against |
Value | Summary |
---|---|
--granularity <GRANULARITY> | The time range in seconds over which to query. |
--aggregation-method <AGGR_METHOD> | The aggregation_method to compare to the threshold. |
--metric <METRIC>, --metrics <METRIC> | The metric id or name depending of the alarm type |
Value | Summary |
---|---|
--resource-type <RESOURCE_TYPE> | The type of resource. |
--resource-id <RESOURCE_ID> | The id of a resource. |
Value | Summary |
---|---|
--composite-rule <COMPOSITE_RULE> | Composite threshold rule with json format, the form can be a nested dict which combine gnocchi rules by "and", "or". For example, the form is like: {"or":[RULE1, RULE2, {"and": [RULE3, RULE4]}]}. |
Chapter 8. alarming
This chapter describes the commands under the alarming
command.
8.1. alarming capabilities list
List capabilities of alarming service
Usage:
openstack alarming capabilities list [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack alarming capabilities list [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 9. application
This chapter describes the commands under the application
command.
9.1. application credential create
Create new application credential
Usage:
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>
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>
Value | Summary |
---|---|
<name> | Name of the application credential |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--secret <secret> | Secret to use for authentication (if not provided, one will be generated) |
--role <role> | Roles to authorize (name or id) (repeat option to set multiple values) |
--expiration <expiration> | Sets an expiration date for the application credential, format of YYYY-mm-ddTHH:MM:SS (if not provided, the application credential will not expire) |
--description <description> | Application credential description |
--unrestricted | Enable application credential to create and delete other application credentials and trusts (this is potentially dangerous behavior and is disabled by default) |
--restricted | Prohibit application credential from creating and deleting other application credentials and trusts (this is the default behavior) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
9.2. application credential delete
Delete application credentials(s)
Usage:
openstack application credential delete [-h] <application-credential> [<application-credential> ...]
openstack application credential delete [-h]
<application-credential>
[<application-credential> ...]
Value | Summary |
---|---|
<application-credential> | Application credentials(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
9.3. application credential list
List application credentials
Usage:
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>]
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>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user <user> | User whose application credentials to list (name or ID) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
9.4. application credential show
Display application credential details
Usage:
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>
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>
Value | Summary |
---|---|
<application-credential> | Application credential to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 10. availability
This chapter describes the commands under the availability
command.
10.1. availability zone list
List availability zones and their status
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--compute | List compute availability zones |
--network | List network availability zones |
--volume | List volume availability zones |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 11. baremetal
This chapter describes the commands under the baremetal
command.
11.1. baremetal allocation create
Create a new baremetal allocation.
Usage:
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>]]
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>]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-class RESOURCE_CLASS | Resource class to request. |
--trait TRAITS | A trait to request. can be specified multiple times. |
--candidate-node CANDIDATE_NODES | A candidate node for this allocation. can be specified multiple times. If at least one is specified, only the provided candidate nodes are considered for the allocation. |
--name NAME | Unique name of the allocation. |
--uuid UUID | Uuid of the allocation. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
--wait [<time-out>] | Wait for the new allocation to become active. an error is returned if allocation fails and --wait is used. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.2. baremetal allocation delete
Unregister baremetal allocation(s).
Usage:
openstack baremetal allocation delete [-h] <allocation> [<allocation> ...]
openstack baremetal allocation delete [-h]
<allocation> [<allocation> ...]
Value | Summary |
---|---|
<allocation> | Allocations(s) to delete (name or uuid). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.3. baremetal allocation list
List baremetal allocations.
Usage:
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> ...]]
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> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of allocations to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <allocation> | Allocation uuid (for example, of the last allocation in the list from a previous request). Returns the list of allocations after this UUID. |
--sort <key>[:<direction>] | Sort output by specified allocation fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
--node <node> | Only list allocations of this node (name or uuid). |
--resource-class <resource_class> | Only list allocations with this resource class. |
--state <state> | Only list allocations in this state. |
--long | Show detailed information about the allocations. |
--fields <field> [<field> …] | One or more allocation fields. only these fields will be fetched from the server. Can not be used when -- long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.4. baremetal allocation show
Show baremetal allocation details.
Usage:
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>
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>
Value | Summary |
---|---|
<id> | Uuid or name of the allocation |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more allocation fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.5. baremetal chassis create
Create a new chassis.
Usage:
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>]
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>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description for the chassis |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
--uuid <uuid> | Unique uuid of the chassis |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.6. baremetal chassis delete
Delete a chassis.
Usage:
openstack baremetal chassis delete [-h] <chassis> [<chassis> ...]
openstack baremetal chassis delete [-h] <chassis> [<chassis> ...]
Value | Summary |
---|---|
<chassis> | Uuids of chassis to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.7. baremetal chassis list
List the chassis.
Usage:
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>]]
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>]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more chassis fields. only these fields will be fetched from the server. Cannot be used when --long is specified. |
--limit <limit> | Maximum number of chassis to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--long | Show detailed information about the chassis |
--marker <chassis> | Chassis uuid (for example, of the last chassis in the list from a previous request). Returns the list of chassis after this UUID. |
--sort <key>[:<direction>] | Sort output by specified chassis fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.8. baremetal chassis set
Set chassis properties.
Usage:
openstack baremetal chassis set [-h] [--description <description>] [--extra <key=value>] <chassis>
openstack baremetal chassis set [-h] [--description <description>]
[--extra <key=value>]
<chassis>
Value | Summary |
---|---|
<chassis> | Uuid of the chassis |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Set the description of the chassis |
--extra <key=value> | Extra to set on this chassis (repeat option to set multiple extras) |
11.9. baremetal chassis show
Show chassis details.
Usage:
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>
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>
Value | Summary |
---|---|
<chassis> | Uuid of the chassis |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more chassis fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.10. baremetal chassis unset
Unset chassis properties.
Usage:
openstack baremetal chassis unset [-h] [--description] [--extra <key>] <chassis>
openstack baremetal chassis unset [-h] [--description] [--extra <key>]
<chassis>
Value | Summary |
---|---|
<chassis> | Uuid of the chassis |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description | Clear the chassis description |
--extra <key> | Extra to unset on this chassis (repeat option to unset multiple extras) |
11.11. baremetal conductor list
List baremetal conductors
Usage:
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> ...]]
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> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of conductors to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <conductor> | Hostname of the conductor (for example, of the last conductor in the list from a previous request). Returns the list of conductors after this conductor. |
--sort <key>[:<direction>] | Sort output by specified conductor fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
--long | Show detailed information about the conductors. |
--fields <field> [<field> …] | One or more conductor fields. only these fields will be fetched from the server. Can not be used when -- long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.12. baremetal conductor show
Show baremetal conductor details
Usage:
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>
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>
Value | Summary |
---|---|
<conductor> | Hostname of the conductor |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more conductor fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.13. baremetal create
Create resources from files
Usage:
openstack baremetal create [-h] <file> [<file> ...]
openstack baremetal create [-h] <file> [<file> ...]
Value | Summary |
---|---|
<file> | File (.yaml or .json) containing descriptions of the resources to create. Can be specified multiple times. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.14. baremetal deploy template create
Create a new deploy template
Usage:
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>
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>
Value | Summary |
---|---|
<name> | Unique name for this deploy template. must be a valid trait name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--uuid <uuid> | Uuid of the deploy template. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
--steps <steps> | The deploy steps in json format. may be the path to a file containing the deploy steps; OR -, with the deploy steps being read from standard input; OR a string. The value should be a list of deploy-step dictionaries; each dictionary should have keys interface, step, args and priority. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.15. baremetal deploy template delete
Delete deploy template(s).
Usage:
openstack baremetal deploy template delete [-h] <template> [<template> ...]
openstack baremetal deploy template delete [-h]
<template> [<template> ...]
Value | Summary |
---|---|
<template> | Name(s) or uuid(s) of the deploy template(s) to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.16. baremetal deploy template list
List baremetal deploy templates.
Usage:
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> ...]]
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> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of deploy templates to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <template> | Deploytemplate uuid (for example, of the last deploy template in the list from a previous request). Returns the list of deploy templates after this UUID. |
--sort <key>[:<direction>] | Sort output by specified deploy template fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
--long | Show detailed information about deploy templates. |
--fields <field> [<field> …] | One or more deploy template fields. only these fields will be fetched from the server. Can not be used when --long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.17. baremetal deploy template set
Set baremetal deploy template properties.
Usage:
openstack baremetal deploy template set [-h] [--name <name>] [--steps <steps>] [--extra <key=value>] <template>
openstack baremetal deploy template set [-h] [--name <name>]
[--steps <steps>]
[--extra <key=value>]
<template>
Value | Summary |
---|---|
<template> | Name or uuid of the deploy template |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set unique name of the deploy template. must be a valid trait name. |
--steps <steps> | The deploy steps in json format. may be the path to a file containing the deploy steps; OR -, with the deploy steps being read from standard input; OR a string. The value should be a list of deploy-step dictionaries; each dictionary should have keys interface, step, args and priority. |
--extra <key=value> | Extra to set on this baremetal deploy template (repeat option to set multiple extras). |
11.18. baremetal deploy template show
Show baremetal deploy template details.
Usage:
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>
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>
Value | Summary |
---|---|
<template> | Name or uuid of the deploy template. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more deploy template fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.19. baremetal deploy template unset
Unset baremetal deploy template properties.
Usage:
openstack baremetal deploy template unset [-h] [--extra <key>] <template>
openstack baremetal deploy template unset [-h] [--extra <key>]
<template>
Value | Summary |
---|---|
<template> | Name or uuid of the deploy template |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--extra <key> | Extra to unset on this baremetal deploy template (repeat option to unset multiple extras). |
11.20. baremetal driver list
List the enabled drivers.
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | Type of driver ("classic" or "dynamic"). the default is to list all of them. |
--long | Show detailed information about the drivers. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.21. baremetal driver passthru call
Call a vendor passthru method for a driver.
Usage:
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>
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>
Value | Summary |
---|---|
<driver> | Name of the driver. |
<method> | Vendor passthru method to be called. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--arg <key=value> | Argument to pass to the passthru method (repeat option to specify multiple arguments). |
--http-method <http-method> | The http method to use in the passthru request. one of DELETE, GET, PATCH, POST, PUT. Defaults to POST. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.22. baremetal driver passthru list
List available vendor passthru methods for a driver.
Usage:
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>
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>
Value | Summary |
---|---|
<driver> | Name of the driver. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.23. baremetal driver property list
List the driver properties.
Usage:
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>
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>
Value | Summary |
---|---|
<driver> | Name of the driver. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.24. baremetal driver raid property list
List a driver’s RAID logical disk properties.
Usage:
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>
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>
Value | Summary |
---|---|
<driver> | Name of the driver. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.25. baremetal driver show
Show information about a driver.
Usage:
openstack baremetal driver show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <driver>
openstack baremetal driver show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<driver>
Value | Summary |
---|---|
<driver> | Name of the driver. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.26. baremetal introspection abort
Abort running introspection for node.
Usage:
openstack baremetal introspection abort [-h] node
openstack baremetal introspection abort [-h] node
Value | Summary |
---|---|
node | Baremetal node uuid or name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.27. baremetal introspection data save
Save or display raw introspection data.
Usage:
openstack baremetal introspection data save [-h] [--file <filename>] node
openstack baremetal introspection data save [-h] [--file <filename>]
node
Value | Summary |
---|---|
node | Baremetal node uuid or name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--file <filename> | Downloaded introspection data filename (default: stdout) |
11.28. baremetal introspection interface list
List interface data including attached switch port information.
Usage:
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
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
Value | Summary |
---|---|
node_ident | Baremetal node uuid or name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--vlan VLAN | List only interfaces configured for this vlan id, can be repeated |
--long | Show detailed information about interfaces. |
--fields <field> [<field> …] | Display one or more fields. can not be used when -- long is specified |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.29. baremetal introspection interface show
Show interface data including attached switch port information.
Usage:
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
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
Value | Summary |
---|---|
node_ident | Baremetal node uuid or name |
interface | Interface name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | Display one or more fields. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.30. baremetal introspection list
List introspection statuses
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker MARKER | Uuid of the last item on the previous page |
--limit LIMIT | The amount of items to return |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.31. baremetal introspection reprocess
Reprocess stored introspection data
Usage:
openstack baremetal introspection reprocess [-h] node
openstack baremetal introspection reprocess [-h] node
Value | Summary |
---|---|
node | Baremetal node uuid or name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.32. baremetal introspection rule delete
Delete an introspection rule.
Usage:
openstack baremetal introspection rule delete [-h] uuid
openstack baremetal introspection rule delete [-h] uuid
Value | Summary |
---|---|
uuid | Rule uuid |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.33. baremetal introspection rule import
Import one or several introspection rules from a JSON/YAML file.
Usage:
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
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
Value | Summary |
---|---|
file | Json or yaml file to import, may contain one or several rules |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.34. baremetal introspection rule list
List all introspection rules.
Usage:
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]
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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.35. baremetal introspection rule purge
Drop all introspection rules.
Usage:
openstack baremetal introspection rule purge [-h]
openstack baremetal introspection rule purge [-h]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.36. baremetal introspection rule show
Show an introspection rule.
Usage:
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
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
Value | Summary |
---|---|
uuid | Rule uuid |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.37. baremetal introspection start
Start the introspection.
Usage:
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 ...]
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 ...]
Value | Summary |
---|---|
node | Baremetal node uuid(s) or name(s) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait | Wait for introspection to finish; the result will be displayed in the end |
--check-errors | Check if errors occurred during the introspection; if any error occurs only the errors are displayed; can only be used with --wait |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.38. baremetal introspection status
Get introspection status.
Usage:
openstack baremetal introspection status [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] node
openstack baremetal introspection status [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
node
Value | Summary |
---|---|
node | Baremetal node uuid or name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.39. baremetal node abort
Set provision state of baremetal node to abort
Usage:
openstack baremetal node abort [-h] <node>
openstack baremetal node abort [-h] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.40. baremetal node add trait
Add traits to a node.
Usage:
openstack baremetal node add trait [-h] <node> <trait> [<trait> ...]
openstack baremetal node add trait [-h] <node> <trait> [<trait> ...]
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<trait> | Trait(s) to add |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.41. baremetal node adopt
Set provision state of baremetal node to adopt
Usage:
openstack baremetal node adopt [-h] [--wait [<time-out>]] <node>
openstack baremetal node adopt [-h] [--wait [<time-out>]] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
11.42. baremetal node bios setting list
List a node’s BIOS settings.
Usage:
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>
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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.43. baremetal node bios setting show
Show a specific BIOS setting for a node.
Usage:
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>
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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<setting name> | Setting name to show |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.44. baremetal node boot device set
Set the boot device for a node
Usage:
openstack baremetal node boot device set [-h] [--persistent] <node> <device>
openstack baremetal node boot device set [-h] [--persistent]
<node> <device>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<device> | One of bios, cdrom, disk, pxe, safe, wanboot |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--persistent | Make changes persistent for all future boots |
11.45. baremetal node boot device show
Show the boot device information for a node
Usage:
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>
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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--supported | Show the supported boot devices |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.46. baremetal node clean
Set provision state of baremetal node to clean
Usage:
openstack baremetal node clean [-h] [--wait [<time-out>]] --clean-steps <clean-steps> <node>
openstack baremetal node clean [-h] [--wait [<time-out>]] --clean-steps
<clean-steps>
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, manageable. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
--clean-steps <clean-steps> | The clean steps in json format. may be the path to a file containing the clean steps; OR -, with the clean steps being read from standard input; OR a string. The value should be a list of clean-step dictionaries; each dictionary should have keys interface and step, and optional key args. |
11.47. baremetal node console disable
Disable console access for a node
Usage:
openstack baremetal node console disable [-h] <node>
openstack baremetal node console disable [-h] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.48. baremetal node console enable
Enable console access for a node
Usage:
openstack baremetal node console enable [-h] <node>
openstack baremetal node console enable [-h] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.49. baremetal node console show
Show console information for a node
Usage:
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>
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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.50. baremetal node create
Register a new node with the baremetal service
Usage:
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>]
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>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--chassis-uuid <chassis> | Uuid of the chassis that this node belongs to. |
--driver <driver> | Driver used to control the node [required]. |
--driver-info <key=value> | Key/value pair used by the driver, such as out-of-band management credentials. Can be specified multiple times. |
--property <key=value> | Key/value pair describing the physical characteristics of the node. This is exported to Nova and used by the scheduler. Can be specified multiple times. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
--uuid <uuid> | Unique uuid for the node. |
--name <name> | Unique name for the node. |
--bios-interface <bios_interface> | Bios interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--boot-interface <boot_interface> | Boot interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--console-interface <console_interface> | Console interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--deploy-interface <deploy_interface> | Deploy interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--inspect-interface <inspect_interface> | Inspect interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--management-interface <management_interface> | Management interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--network-interface <network_interface> | Network interface used for switching node to cleaning/provisioning networks. |
--power-interface <power_interface> | Power interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--raid-interface <raid_interface> | Raid interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--rescue-interface <rescue_interface> | Rescue interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--storage-interface <storage_interface> | Storage interface used by the node’s driver. |
--vendor-interface <vendor_interface> | Vendor interface used by the node’s driver. this is only applicable when the specified --driver is a hardware type. |
--resource-class <resource_class> | Resource class for mapping nodes to nova flavors |
--conductor-group <conductor_group> | Conductor group the node will belong to |
--automated-clean | Enable automated cleaning for the node |
--owner <owner> | Owner of the node. |
--description <description> | Description for the node. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.51. baremetal node delete
Unregister baremetal node(s)
Usage:
openstack baremetal node delete [-h] <node> [<node> ...]
openstack baremetal node delete [-h] <node> [<node> ...]
Value | Summary |
---|---|
<node> | Node(s) to delete (name or uuid) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.52. baremetal node deploy
Set provision state of baremetal node to deploy
Usage:
openstack baremetal node deploy [-h] [--wait [<time-out>]] [--config-drive <config-drive>] <node>
openstack baremetal node deploy [-h] [--wait [<time-out>]]
[--config-drive <config-drive>]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
--config-drive <config-drive> |
A gzipped, base64-encoded configuration drive string OR the path to the configuration drive file OR the path to a directory containing the config drive files OR a JSON object to build config drive from. In case it’s a directory, a config drive will be generated from it. In case it’s a JSON object with optional keys |
11.53. baremetal node inject nmi
Inject NMI to baremetal node
Usage:
openstack baremetal node inject nmi [-h] <node>
openstack baremetal node inject nmi [-h] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.54. baremetal node inspect
Set provision state of baremetal node to inspect
Usage:
openstack baremetal node inspect [-h] [--wait [<time-out>]] <node>
openstack baremetal node inspect [-h] [--wait [<time-out>]] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, manageable. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
11.55. baremetal node list
List baremetal nodes
Usage:
openstack baremetal node 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 <node>] [--sort <key>[:<direction>]] [--maintenance | --no-maintenance] [--fault <fault>] [--associated | --unassociated] [--provision-state <provision state>] [--driver <driver>] [--resource-class <resource class>] [--conductor-group <conductor_group>] [--conductor <conductor>] [--chassis <chassis UUID>] [--owner <owner>] [--description-contains <description_contains>] [--long | --fields <field> [<field> ...]]
openstack baremetal node 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 <node>]
[--sort <key>[:<direction>]]
[--maintenance | --no-maintenance]
[--fault <fault>]
[--associated | --unassociated]
[--provision-state <provision state>]
[--driver <driver>]
[--resource-class <resource class>]
[--conductor-group <conductor_group>]
[--conductor <conductor>]
[--chassis <chassis UUID>]
[--owner <owner>]
[--description-contains <description_contains>]
[--long | --fields <field> [<field> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of nodes to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <node> | Node uuid (for example, of the last node in the list from a previous request). Returns the list of nodes after this UUID. |
--sort <key>[:<direction>] | Sort output by specified node fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
--maintenance | Limit list to nodes in maintenance mode |
--no-maintenance | Limit list to nodes not in maintenance mode |
--fault <fault> | List nodes in specified fault. |
--associated | List only nodes associated with an instance. |
--unassociated | List only nodes not associated with an instance. |
--provision-state <provision state> | List nodes in specified provision state. |
--driver <driver> | Limit list to nodes with driver <driver> |
--resource-class <resource class> | Limit list to nodes with resource class <resource class> |
--conductor-group <conductor_group> | Limit list to nodes with conductor group <conductor group> |
--conductor <conductor> | Limit list to nodes with conductor <conductor> |
--chassis <chassis UUID> | Limit list to nodes of this chassis |
--owner <owner> | Limit list to nodes with owner <owner> |
--description-contains <description_contains> | Limit list to nodes with description contains <description_contains> |
--long | Show detailed information about the nodes. |
--fields <field> [<field> …] | One or more node fields. only these fields will be fetched from the server. Can not be used when --long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.56. baremetal node maintenance set
Set baremetal node to maintenance mode
Usage:
openstack baremetal node maintenance set [-h] [--reason <reason>] <node>
openstack baremetal node maintenance set [-h] [--reason <reason>]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--reason <reason> | Reason for setting maintenance mode. |
11.57. baremetal node maintenance unset
Unset baremetal node from maintenance mode
Usage:
openstack baremetal node maintenance unset [-h] <node>
openstack baremetal node maintenance unset [-h] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.58. baremetal node manage
Set provision state of baremetal node to manage
Usage:
openstack baremetal node manage [-h] [--wait [<time-out>]] <node>
openstack baremetal node manage [-h] [--wait [<time-out>]] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, manageable. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
11.59. baremetal node passthru call
Call a vendor passthu method for a node
Usage:
openstack baremetal node passthru call [-h] [--arg <key=value>] [--http-method <http-method>] <node> <method>
openstack baremetal node passthru call [-h] [--arg <key=value>]
[--http-method <http-method>]
<node> <method>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<method> | Vendor passthru method to be executed |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--arg <key=value> | Argument to pass to the passthru method (repeat option to specify multiple arguments) |
--http-method <http-method> | The http method to use in the passthru request. one of DELETE, GET, PATCH, POST, PUT. Defaults to POST. |
11.60. baremetal node passthru list
List vendor passthru methods for a node
Usage:
openstack baremetal node 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] <node>
openstack baremetal node 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]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.61. baremetal node power off
Power off a node
Usage:
openstack baremetal node power off [-h] [--power-timeout <power-timeout>] [--soft] <node>
openstack baremetal node power off [-h]
[--power-timeout <power-timeout>]
[--soft]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--power-timeout <power-timeout> | Timeout (in seconds, positive integer) to wait for the target power state before erroring out. |
--soft | Request graceful power-off. |
11.62. baremetal node power on
Power on a node
Usage:
openstack baremetal node power on [-h] [--power-timeout <power-timeout>] <node>
openstack baremetal node power on [-h]
[--power-timeout <power-timeout>]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--power-timeout <power-timeout> | Timeout (in seconds, positive integer) to wait for the target power state before erroring out. |
11.63. baremetal node provide
Set provision state of baremetal node to provide
Usage:
openstack baremetal node provide [-h] [--wait [<time-out>]] <node>
openstack baremetal node provide [-h] [--wait [<time-out>]] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, available. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
11.64. baremetal node reboot
Reboot baremetal node
Usage:
openstack baremetal node reboot [-h] [--soft] [--power-timeout <power-timeout>] <node>
openstack baremetal node reboot [-h] [--soft]
[--power-timeout <power-timeout>]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--soft | Request graceful reboot. |
--power-timeout <power-timeout> | Timeout (in seconds, positive integer) to wait for the target power state before erroring out. |
11.65. baremetal node rebuild
Set provision state of baremetal node to rebuild
Usage:
openstack baremetal node rebuild [-h] [--wait [<time-out>]] [--config-drive <config-drive>] <node>
openstack baremetal node rebuild [-h] [--wait [<time-out>]]
[--config-drive <config-drive>]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
--config-drive <config-drive> |
A gzipped, base64-encoded configuration drive string OR the path to the configuration drive file OR the path to a directory containing the config drive files OR a JSON object to build config drive from. In case it’s a directory, a config drive will be generated from it. In case it’s a JSON object with optional keys |
11.66. baremetal node remove trait
Remove trait(s) from a node.
Usage:
openstack baremetal node remove trait [-h] [--all] <node> [<trait> [<trait> ...]]
openstack baremetal node remove trait [-h] [--all]
<node> [<trait> [<trait> ...]]
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<trait> | Trait(s) to remove |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all | Remove all traits |
11.67. baremetal node rescue
Set provision state of baremetal node to rescue
Usage:
openstack baremetal node rescue [-h] [--wait [<time-out>]] --rescue-password <rescue-password> <node>
openstack baremetal node rescue [-h] [--wait [<time-out>]]
--rescue-password <rescue-password>
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, rescue. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
--rescue-password <rescue-password> | The password that will be used to login to the rescue ramdisk. The value should be a non-empty string. |
11.68. baremetal node set
Set baremetal properties
Usage:
openstack baremetal node set [-h] [--instance-uuid <uuid>] [--name <name>] [--chassis-uuid <chassis UUID>] [--driver <driver>] [--bios-interface <bios_interface> | --reset-bios-interface] [--boot-interface <boot_interface> | --reset-boot-interface] [--console-interface <console_interface> | --reset-console-interface] [--deploy-interface <deploy_interface> | --reset-deploy-interface] [--inspect-interface <inspect_interface> | --reset-inspect-interface] [--management-interface <management_interface> | --reset-management-interface] [--network-interface <network_interface> | --reset-network-interface] [--power-interface <power_interface> | --reset-power-interface] [--raid-interface <raid_interface> | --reset-raid-interface] [--rescue-interface <rescue_interface> | --reset-rescue-interface] [--storage-interface <storage_interface> | --reset-storage-interface] [--vendor-interface <vendor_interface> | --reset-vendor-interface] [--reset-interfaces] [--resource-class <resource_class>] [--conductor-group <conductor_group>] [--automated-clean] [--protected] [--protected-reason <protected_reason>] [--target-raid-config <target_raid_config>] [--property <key=value>] [--extra <key=value>] [--driver-info <key=value>] [--instance-info <key=value>] [--owner <owner>] [--description <description>] <node>
openstack baremetal node set [-h] [--instance-uuid <uuid>]
[--name <name>]
[--chassis-uuid <chassis UUID>]
[--driver <driver>]
[--bios-interface <bios_interface> | --reset-bios-interface]
[--boot-interface <boot_interface> | --reset-boot-interface]
[--console-interface <console_interface> | --reset-console-interface]
[--deploy-interface <deploy_interface> | --reset-deploy-interface]
[--inspect-interface <inspect_interface> | --reset-inspect-interface]
[--management-interface <management_interface> | --reset-management-interface]
[--network-interface <network_interface> | --reset-network-interface]
[--power-interface <power_interface> | --reset-power-interface]
[--raid-interface <raid_interface> | --reset-raid-interface]
[--rescue-interface <rescue_interface> | --reset-rescue-interface]
[--storage-interface <storage_interface> | --reset-storage-interface]
[--vendor-interface <vendor_interface> | --reset-vendor-interface]
[--reset-interfaces]
[--resource-class <resource_class>]
[--conductor-group <conductor_group>]
[--automated-clean] [--protected]
[--protected-reason <protected_reason>]
[--target-raid-config <target_raid_config>]
[--property <key=value>]
[--extra <key=value>]
[--driver-info <key=value>]
[--instance-info <key=value>]
[--owner <owner>]
[--description <description>]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--instance-uuid <uuid> | Set instance uuid of node to <uuid> |
--name <name> | Set the name of the node |
--chassis-uuid <chassis UUID> | Set the chassis for the node |
--driver <driver> | Set the driver for the node |
--bios-interface <bios_interface> | Set the bios interface for the node |
--reset-bios-interface | Reset the bios interface to its hardware type default |
--boot-interface <boot_interface> | Set the boot interface for the node |
--reset-boot-interface | Reset the boot interface to its hardware type default |
--console-interface <console_interface> | Set the console interface for the node |
--reset-console-interface | Reset the console interface to its hardware type default |
--deploy-interface <deploy_interface> | Set the deploy interface for the node |
--reset-deploy-interface | Reset the deploy interface to its hardware type default |
--inspect-interface <inspect_interface> | Set the inspect interface for the node |
--reset-inspect-interface | Reset the inspect interface to its hardware type default |
--management-interface <management_interface> | Set the management interface for the node |
--reset-management-interface | Reset the management interface to its hardware type default |
--network-interface <network_interface> | Set the network interface for the node |
--reset-network-interface | Reset the network interface to its hardware type default |
--power-interface <power_interface> | Set the power interface for the node |
--reset-power-interface | Reset the power interface to its hardware type default |
--raid-interface <raid_interface> | Set the raid interface for the node |
--reset-raid-interface | Reset the raid interface to its hardware type default |
--rescue-interface <rescue_interface> | Set the rescue interface for the node |
--reset-rescue-interface | Reset the rescue interface to its hardware type default |
--storage-interface <storage_interface> | Set the storage interface for the node |
--reset-storage-interface | Reset the storage interface to its hardware type default |
--vendor-interface <vendor_interface> | Set the vendor interface for the node |
--reset-vendor-interface | Reset the vendor interface to its hardware type default |
--reset-interfaces | Reset all interfaces not specified explicitly to their default implementations. Only valid with --driver. |
--resource-class <resource_class> | Set the resource class for the node |
--conductor-group <conductor_group> | Set the conductor group for the node |
--automated-clean | Enable automated cleaning for the node |
--protected | Mark the node as protected |
--protected-reason <protected_reason> | Set the reason of marking the node as protected |
--target-raid-config <target_raid_config> | Set the target raid configuration (json) for the node. This can be one of: 1. a file containing JSON data of the RAID configuration; 2. "-" to read the contents from standard input; or 3. a valid JSON string. |
--property <key=value> | Property to set on this baremetal node (repeat option to set multiple properties) |
--extra <key=value> | Extra to set on this baremetal node (repeat option to set multiple extras) |
--driver-info <key=value> | Driver information to set on this baremetal node (repeat option to set multiple driver infos) |
--instance-info <key=value> | Instance information to set on this baremetal node (repeat option to set multiple instance infos) |
--owner <owner> | Set the owner for the node |
--description <description> | Set the description for the node |
11.69. baremetal node show
Show baremetal node details
Usage:
openstack baremetal node show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--instance] [--fields <field> [<field> ...]] <node>
openstack baremetal node show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
[--instance]
[--fields <field> [<field> ...]]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node (or instance uuid if --instance is specified) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--instance | <node> is an instance uuid. |
--fields <field> [<field> …] | One or more node fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.70. baremetal node trait list
List a node’s traits.
Usage:
openstack baremetal node trait 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>
openstack baremetal node trait 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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.71. baremetal node undeploy
Set provision state of baremetal node to deleted
Usage:
openstack baremetal node undeploy [-h] [--wait [<time-out>]] <node>
openstack baremetal node undeploy [-h] [--wait [<time-out>]] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, available. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
11.72. baremetal node unrescue
Set provision state of baremetal node to unrescue
Usage:
openstack baremetal node unrescue [-h] [--wait [<time-out>]] <node>
openstack baremetal node unrescue [-h] [--wait [<time-out>]] <node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--wait [<time-out>] | Wait for a node to reach the desired state, active. Optionally takes a timeout value (in seconds). The default value is 0, meaning it will wait indefinitely. |
11.73. baremetal node unset
Unset baremetal properties
Usage:
openstack baremetal node unset [-h] [--instance-uuid] [--name] [--resource-class] [--target-raid-config] [--property <key>] [--extra <key>] [--driver-info <key>] [--instance-info <key>] [--chassis-uuid] [--bios-interface] [--boot-interface] [--console-interface] [--deploy-interface] [--inspect-interface] [--management-interface] [--network-interface] [--power-interface] [--raid-interface] [--rescue-interface] [--storage-interface] [--vendor-interface] [--conductor-group] [--automated-clean] [--protected] [--protected-reason] [--owner] [--description] <node>
openstack baremetal node unset [-h] [--instance-uuid] [--name]
[--resource-class]
[--target-raid-config]
[--property <key>] [--extra <key>]
[--driver-info <key>]
[--instance-info <key>] [--chassis-uuid]
[--bios-interface] [--boot-interface]
[--console-interface]
[--deploy-interface]
[--inspect-interface]
[--management-interface]
[--network-interface]
[--power-interface] [--raid-interface]
[--rescue-interface]
[--storage-interface]
[--vendor-interface] [--conductor-group]
[--automated-clean] [--protected]
[--protected-reason] [--owner]
[--description]
<node>
Value | Summary |
---|---|
<node> | Name or uuid of the node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--instance-uuid | Unset instance uuid on this baremetal node |
--name | Unset the name of the node |
--resource-class | Unset the resource class of the node |
--target-raid-config | Unset the target raid configuration of the node |
--property <key> | Property to unset on this baremetal node (repeat option to unset multiple properties) |
--extra <key> | Extra to unset on this baremetal node (repeat option to unset multiple extras) |
--driver-info <key> | Driver information to unset on this baremetal node (repeat option to unset multiple driver informations) |
--instance-info <key> | Instance information to unset on this baremetal node (repeat option to unset multiple instance informations) |
--chassis-uuid | Unset chassis uuid on this baremetal node |
--bios-interface | Unset bios interface on this baremetal node |
--boot-interface | Unset boot interface on this baremetal node |
--console-interface | Unset console interface on this baremetal node |
--deploy-interface | Unset deploy interface on this baremetal node |
--inspect-interface | Unset inspect interface on this baremetal node |
--management-interface | Unset management interface on this baremetal node |
--network-interface | Unset network interface on this baremetal node |
--power-interface | Unset power interface on this baremetal node |
--raid-interface | Unset raid interface on this baremetal node |
--rescue-interface | Unset rescue interface on this baremetal node |
--storage-interface | Unset storage interface on this baremetal node |
--vendor-interface | Unset vendor interface on this baremetal node |
--conductor-group | Unset conductor group for this baremetal node (the default group will be used) |
--automated-clean | Unset automated clean option on this baremetal node (the value from configuration will be used) |
--protected | Unset the protected flag on the node |
--protected-reason | Unset the protected reason (gets unset automatically when protected is unset) |
--owner | Unset the owner field of the node |
--description | Unset the description field of the node |
11.74. baremetal node validate
Validate a node’s driver interfaces
Usage:
openstack baremetal node validate [-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>
openstack baremetal node validate [-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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.75. baremetal node vif attach
Attach VIF to a given node
Usage:
openstack baremetal node vif attach [-h] [--vif-info <key=value>] <node> <vif-id>
openstack baremetal node vif attach [-h] [--vif-info <key=value>]
<node> <vif-id>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<vif-id> | Name or uuid of the vif to attach to a node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--vif-info <key=value> | Record arbitrary key/value metadata. can be specified multiple times. The mandatory id parameter cannot be specified as a key. |
11.76. baremetal node vif detach
Detach VIF from a given node
Usage:
openstack baremetal node vif detach [-h] <node> <vif-id>
openstack baremetal node vif detach [-h] <node> <vif-id>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
<vif-id> | Name or uuid of the vif to detach from a node. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.77. baremetal node vif list
Show attached VIFs for a node
Usage:
openstack baremetal node vif 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>
openstack baremetal node vif 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>
Value | Summary |
---|---|
<node> | Name or uuid of the node |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.78. baremetal port create
Create a new port
Usage:
openstack baremetal port create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --node <uuid> [--uuid <uuid>] [--extra <key=value>] [--local-link-connection <key=value>] [-l <key=value>] [--pxe-enabled <boolean>] [--port-group <uuid>] [--physical-network <physical network>] [--is-smartnic] <address>
openstack baremetal port create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --node <uuid>
[--uuid <uuid>] [--extra <key=value>]
[--local-link-connection <key=value>]
[-l <key=value>]
[--pxe-enabled <boolean>]
[--port-group <uuid>]
[--physical-network <physical network>]
[--is-smartnic]
<address>
Value | Summary |
---|---|
<address> | Mac address for this port. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Uuid of the node that this port belongs to. |
--uuid <uuid> | Uuid of the port. |
--extra <key=value> | Record arbitrary key/value metadata. argument can be specified multiple times. |
--local-link-connection <key=value> | Key/value metadata describing local link connection information. Valid keys are switch_info, switch_id, port_id and hostname. The keys switch_id and port_id are required. In case of a Smart NIC port, the required keys are port_id and hostname. Argument can be specified multiple times. |
-l <key=value> | Deprecated. please use --local-link-connection instead. Key/value metadata describing Local link connection information. Valid keys are switch_info, switch_id, and port_id. The keys switch_id and port_id are required. Can be specified multiple times. |
--pxe-enabled <boolean> | Indicates whether this port should be used when pxe booting this Node. |
--port-group <uuid> | Uuid of the port group that this port belongs to. |
--physical-network <physical network> | Name of the physical network to which this port is connected. |
--is-smartnic | Indicates whether this port is a smart nic port |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.79. baremetal port delete
Delete port(s).
Usage:
openstack baremetal port delete [-h] <port> [<port> ...]
openstack baremetal port delete [-h] <port> [<port> ...]
Value | Summary |
---|---|
<port> | Uuid(s) of the port(s) to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.80. baremetal port group create
Create a new baremetal port group.
Usage:
openstack baremetal port group create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --node <uuid> [--address <mac-address>] [--name NAME] [--uuid UUID] [--extra <key=value>] [--mode MODE] [--property <key=value>] [--support-standalone-ports | --unsupport-standalone-ports]
openstack baremetal port group create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--node <uuid>
[--address <mac-address>]
[--name NAME] [--uuid UUID]
[--extra <key=value>]
[--mode MODE]
[--property <key=value>]
[--support-standalone-ports | --unsupport-standalone-ports]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Uuid of the node that this port group belongs to. |
--address <mac-address> | Mac address for this port group. |
--name NAME | Name of the port group. |
--uuid UUID | Uuid of the port group. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
--mode MODE | Mode of the port group. for possible values, refer to https://www.kernel.org/doc/Documentation/networking/bo nding.txt. |
--property <key=value> | Key/value property related to this port group’s configuration. Can be specified multiple times. |
--support-standalone-ports | Ports that are members of this port group can be used as stand-alone ports. (default) |
--unsupport-standalone-ports | Ports that are members of this port group cannot be used as stand-alone ports. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.81. baremetal port group delete
Unregister baremetal port group(s).
Usage:
openstack baremetal port group delete [-h] <port group> [<port group> ...]
openstack baremetal port group delete [-h]
<port group> [<port group> ...]
Value | Summary |
---|---|
<port group> | Port group(s) to delete (name or uuid). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.82. baremetal port group list
List baremetal port groups.
Usage:
openstack baremetal port group 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 <port group>] [--sort <key>[:<direction>]] [--address <mac-address>] [--node <node>] [--long | --fields <field> [<field> ...]]
openstack baremetal port group 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 <port group>]
[--sort <key>[:<direction>]]
[--address <mac-address>]
[--node <node>]
[--long | --fields <field> [<field> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of port groups to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <port group> | Port group uuid (for example, of the last port group in the list from a previous request). Returns the list of port groups after this UUID. |
--sort <key>[:<direction>] | Sort output by specified port group fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
--address <mac-address> | Only show information for the port group with this mac address. |
--node <node> | Only list port groups of this node (name or uuid). |
--long | Show detailed information about the port groups. |
--fields <field> [<field> …] | One or more port group fields. only these fields will be fetched from the server. Can not be used when -- long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.83. baremetal port group set
Set baremetal port group properties.
Usage:
openstack baremetal port group set [-h] [--node <uuid>] [--address <mac-address>] [--name <name>] [--extra <key=value>] [--mode MODE] [--property <key=value>] [--support-standalone-ports | --unsupport-standalone-ports] <port group>
openstack baremetal port group set [-h] [--node <uuid>]
[--address <mac-address>]
[--name <name>]
[--extra <key=value>] [--mode MODE]
[--property <key=value>]
[--support-standalone-ports | --unsupport-standalone-ports]
<port group>
Value | Summary |
---|---|
<port group> | Name or uuid of the port group. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Update uuid of the node that this port group belongs to. |
--address <mac-address> | Mac address for this port group. |
--name <name> | Name of the port group. |
--extra <key=value> | Extra to set on this baremetal port group (repeat option to set multiple extras). |
--mode MODE | Mode of the port group. for possible values, refer to https://www.kernel.org/doc/Documentation/networking/bo nding.txt. |
--property <key=value> | Key/value property related to this port group’s configuration (repeat option to set multiple properties). |
--support-standalone-ports | Ports that are members of this port group can be used as stand-alone ports. |
--unsupport-standalone-ports | Ports that are members of this port group cannot be used as stand-alone ports. |
11.84. baremetal port group show
Show baremetal port group details.
Usage:
openstack baremetal port group show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--address] [--fields <field> [<field> ...]] <id>
openstack baremetal port group show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--address]
[--fields <field> [<field> ...]]
<id>
Value | Summary |
---|---|
<id> | Uuid or name of the port group (or mac address if --address is specified). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--address | <id> is the mac address (instead of uuid or name) of the port group. |
--fields <field> [<field> …] | One or more port group fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.85. baremetal port group unset
Unset baremetal port group properties.
Usage:
openstack baremetal port group unset [-h] [--name] [--address] [--extra <key>] [--property <key>] <port group>
openstack baremetal port group unset [-h] [--name] [--address]
[--extra <key>] [--property <key>]
<port group>
Value | Summary |
---|---|
<port group> | Name or uuid of the port group. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name | Unset the name of the port group. |
--address | Unset the address of the port group. |
--extra <key> | Extra to unset on this baremetal port group (repeat option to unset multiple extras). |
--property <key> | Property to unset on this baremetal port group (repeat option to unset multiple properties). |
11.86. baremetal port list
List baremetal ports.
Usage:
openstack baremetal port 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] [--address <mac-address>] [--node <node>] [--port-group <port group>] [--limit <limit>] [--marker <port>] [--sort <key>[:<direction>]] [--long | --fields <field> [<field> ...]]
openstack baremetal port 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]
[--address <mac-address>] [--node <node>]
[--port-group <port group>]
[--limit <limit>] [--marker <port>]
[--sort <key>[:<direction>]]
[--long | --fields <field> [<field> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--address <mac-address> | Only show information for the port with this mac address. |
--node <node> | Only list ports of this node (name or uuid). |
--port-group <port group> | Only list ports of this port group (name or uuid). |
--limit <limit> | Maximum number of ports to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <port> | Port uuid (for example, of the last port in the list from a previous request). Returns the list of ports after this UUID. |
--sort <key>[:<direction>] | Sort output by specified port fields and directions (asc or desc) (default: asc). Multiple fields and directions can be specified, separated by comma. |
--long | Show detailed information about ports. |
--fields <field> [<field> …] | One or more port fields. only these fields will be fetched from the server. Can not be used when --long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.87. baremetal port set
Set baremetal port properties.
Usage:
openstack baremetal port set [-h] [--node <uuid>] [--address <address>] [--extra <key=value>] [--port-group <uuid>] [--local-link-connection <key=value>] [--pxe-enabled | --pxe-disabled] [--physical-network <physical network>] [--is-smartnic] <port>
openstack baremetal port set [-h] [--node <uuid>] [--address <address>]
[--extra <key=value>]
[--port-group <uuid>]
[--local-link-connection <key=value>]
[--pxe-enabled | --pxe-disabled]
[--physical-network <physical network>]
[--is-smartnic]
<port>
Value | Summary |
---|---|
<port> | Uuid of the port |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Set uuid of the node that this port belongs to |
--address <address> | Set mac address for this port |
--extra <key=value> | Extra to set on this baremetal port (repeat option to set multiple extras) |
--port-group <uuid> | Set uuid of the port group that this port belongs to. |
--local-link-connection <key=value> | Key/value metadata describing local link connection information. Valid keys are switch_info, switch_id, port_id and hostname. The keys switch_id and port_id are required. In case of a Smart NIC port, the required keys are port_id and hostname. Argument can be specified multiple times. |
--pxe-enabled | Indicates that this port should be used when pxe booting this node (default) |
--pxe-disabled | Indicates that this port should not be used when pxe booting this node |
--physical-network <physical network> | Set the name of the physical network to which this port is connected. |
--is-smartnic | Set port to be smart nic port |
11.88. baremetal port show
Show baremetal port details.
Usage:
openstack baremetal port show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--address] [--fields <field> [<field> ...]] <id>
openstack baremetal port show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty] [--address]
[--fields <field> [<field> ...]]
<id>
Value | Summary |
---|---|
<id> | Uuid of the port (or mac address if --address is specified). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--address | <id> is the mac address (instead of the uuid) of the port. |
--fields <field> [<field> …] | One or more port fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.89. baremetal port unset
Unset baremetal port properties.
Usage:
openstack baremetal port unset [-h] [--extra <key>] [--port-group] [--physical-network] [--is-smartnic] <port>
openstack baremetal port unset [-h] [--extra <key>] [--port-group]
[--physical-network] [--is-smartnic]
<port>
Value | Summary |
---|---|
<port> | Uuid of the port. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--extra <key> | Extra to unset on this baremetal port (repeat option to unset multiple extras) |
--port-group | Remove port from the port group |
--physical-network | Unset the physical network on this baremetal port. |
--is-smartnic | Set port as not smart nic port |
11.90. baremetal volume connector create
Create a new baremetal volume connector.
Usage:
openstack baremetal volume connector create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --node <uuid> --type <type> --connector-id <connector id> [--uuid <uuid>] [--extra <key=value>]
openstack baremetal volume connector create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty] --node
<uuid> --type <type>
--connector-id <connector
id> [--uuid <uuid>]
[--extra <key=value>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Uuid of the node that this volume connector belongs to. |
--type <type> | Type of the volume connector. can be iqn, ip, mac, wwnn, wwpn, port, portgroup. |
--connector-id <connector id> | Id of the volume connector in the specified type. for example, the iSCSI initiator IQN for the node if the type is iqn. |
--uuid <uuid> | Uuid of the volume connector. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.91. baremetal volume connector delete
Unregister baremetal volume connector(s).
Usage:
openstack baremetal volume connector delete [-h] <volume connector> [<volume connector> ...]
openstack baremetal volume connector delete [-h]
<volume connector>
[<volume connector> ...]
Value | Summary |
---|---|
<volume connector> | Uuid(s) of the volume connector(s) to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.92. baremetal volume connector list
List baremetal volume connectors.
Usage:
openstack baremetal volume connector 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 <node>] [--limit <limit>] [--marker <volume connector>] [--sort <key>[:<direction>]] [--long | --fields <field> [<field> ...]]
openstack baremetal volume connector 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 <node>]
[--limit <limit>]
[--marker <volume connector>]
[--sort <key>[:<direction>]]
[--long | --fields <field> [<field> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <node> | Only list volume connectors of this node (name or UUID). |
--limit <limit> | Maximum number of volume connectors to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <volume connector> | Volume connector uuid (for example, of the last volume connector in the list from a previous request). Returns the list of volume connectors after this UUID. |
--sort <key>[:<direction>] | Sort output by specified volume connector fields and directions (asc or desc) (default:asc). Multiple fields and directions can be specified, separated by comma. |
--long | Show detailed information about volume connectors. |
--fields <field> [<field> …] | One or more volume connector fields. only these fields will be fetched from the server. Can not be used when --long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.93. baremetal volume connector set
Set baremetal volume connector properties.
Usage:
openstack baremetal volume connector set [-h] [--node <uuid>] [--type <type>] [--connector-id <connector id>] [--extra <key=value>] <volume connector>
openstack baremetal volume connector set [-h] [--node <uuid>]
[--type <type>]
[--connector-id <connector id>]
[--extra <key=value>]
<volume connector>
Value | Summary |
---|---|
<volume connector> | Uuid of the volume connector. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Uuid of the node that this volume connector belongs to. |
--type <type> | Type of the volume connector. can be iqn, ip, mac, wwnn, wwpn, port, portgroup. |
--connector-id <connector id> | Id of the volume connector in the specified type. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
11.94. baremetal volume connector show
Show baremetal volume connector details.
Usage:
openstack baremetal volume connector show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--fields <field> [<field> ...]] <id>
openstack baremetal volume connector show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--fields <field> [<field> ...]]
<id>
Value | Summary |
---|---|
<id> | Uuid of the volume connector. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more volume connector fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.95. baremetal volume connector unset
Unset baremetal volume connector properties.
Usage:
openstack baremetal volume connector unset [-h] [--extra <key>] <volume connector>
openstack baremetal volume connector unset [-h] [--extra <key>]
<volume connector>
Value | Summary |
---|---|
<volume connector> | Uuid of the volume connector. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--extra <key> | Extra to unset (repeat option to unset multiple extras) |
11.96. baremetal volume target create
Create a new baremetal volume target.
Usage:
openstack baremetal volume target create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --node <uuid> --type <volume type> [--property <key=value>] --boot-index <boot index> --volume-id <volume id> [--uuid <uuid>] [--extra <key=value>]
openstack baremetal volume target create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--node <uuid> --type <volume
type> [--property <key=value>]
--boot-index <boot index>
--volume-id <volume id>
[--uuid <uuid>]
[--extra <key=value>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Uuid of the node that this volume target belongs to. |
--type <volume type> | Type of the volume target, e.g. iscsi, fibre_channel. |
--property <key=value> | Key/value property related to the type of this volume target. Can be specified multiple times. |
--boot-index <boot index> | Boot index of the volume target. |
--volume-id <volume id> | Id of the volume associated with this target. |
--uuid <uuid> | Uuid of the volume target. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.97. baremetal volume target delete
Unregister baremetal volume target(s).
Usage:
openstack baremetal volume target delete [-h] <volume target> [<volume target> ...]
openstack baremetal volume target delete [-h]
<volume target>
[<volume target> ...]
Value | Summary |
---|---|
<volume target> | Uuid(s) of the volume target(s) to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
11.98. baremetal volume target list
List baremetal volume targets.
Usage:
openstack baremetal volume target 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 <node>] [--limit <limit>] [--marker <volume target>] [--sort <key>[:<direction>]] [--long | --fields <field> [<field> ...]]
openstack baremetal volume target 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 <node>]
[--limit <limit>]
[--marker <volume target>]
[--sort <key>[:<direction>]]
[--long | --fields <field> [<field> ...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <node> | Only list volume targets of this node (name or uuid). |
--limit <limit> | Maximum number of volume targets to return per request, 0 for no limit. Default is the maximum number used by the Baremetal API Service. |
--marker <volume target> | Volume target uuid (for example, of the last volume target in the list from a previous request). Returns the list of volume targets after this UUID. |
--sort <key>[:<direction>] | Sort output by specified volume target fields and directions (asc or desc) (default:asc). Multiple fields and directions can be specified, separated by comma. |
--long | Show detailed information about volume targets. |
--fields <field> [<field> …] | One or more volume target fields. only these fields will be fetched from the server. Can not be used when --long is specified. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.99. baremetal volume target set
Set baremetal volume target properties.
Usage:
openstack baremetal volume target set [-h] [--node <uuid>] [--type <volume type>] [--property <key=value>] [--boot-index <boot index>] [--volume-id <volume id>] [--extra <key=value>] <volume target>
openstack baremetal volume target set [-h] [--node <uuid>]
[--type <volume type>]
[--property <key=value>]
[--boot-index <boot index>]
[--volume-id <volume id>]
[--extra <key=value>]
<volume target>
Value | Summary |
---|---|
<volume target> | Uuid of the volume target. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node <uuid> | Uuid of the node that this volume target belongs to. |
--type <volume type> | Type of the volume target, e.g. iscsi, fibre_channel. |
--property <key=value> | Key/value property related to the type of this volume target. Can be specified multiple times. |
--boot-index <boot index> | Boot index of the volume target. |
--volume-id <volume id> | Id of the volume associated with this target. |
--extra <key=value> | Record arbitrary key/value metadata. can be specified multiple times. |
11.100. baremetal volume target show
Show baremetal volume target details.
Usage:
openstack baremetal volume target show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--fields <field> [<field> ...]] <id>
openstack baremetal volume target show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--fields <field> [<field> ...]]
<id>
Value | Summary |
---|---|
<id> | Uuid of the volume target. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fields <field> [<field> …] | One or more volume target fields. only these fields will be fetched from the server. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
11.101. baremetal volume target unset
Unset baremetal volume target properties.
Usage:
openstack baremetal volume target unset [-h] [--extra <key>] [--property <key>] <volume target>
openstack baremetal volume target unset [-h] [--extra <key>]
[--property <key>]
<volume target>
Value | Summary |
---|---|
<volume target> | Uuid of the volume target. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--extra <key> | Extra to unset (repeat option to unset multiple extras) |
--property <key> | Property to unset on this baremetal volume target (repeat option to unset multiple properties). |
Chapter 12. bgp
This chapter describes the commands under the bgp
command.
12.1. bgp dragent add speaker
Add a BGP speaker to a dynamic routing agent
Usage:
openstack bgp dragent add speaker [-h] <agent-id> <bgp-speaker>
openstack bgp dragent add speaker [-h] <agent-id> <bgp-speaker>
Value | Summary |
---|---|
<agent-id> | Id of the dynamic routing agent |
<bgp-speaker> | Id or name of the bgp speaker |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.2. bgp dragent remove speaker
Removes a BGP speaker from a dynamic routing agent
Usage:
openstack bgp dragent remove speaker [-h] <agent-id> <bgp-speaker>
openstack bgp dragent remove speaker [-h] <agent-id> <bgp-speaker>
Value | Summary |
---|---|
<agent-id> | Id of the dynamic routing agent |
<bgp-speaker> | Id or name of the bgp speaker |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.3. bgp peer create
Create a BGP peer
Usage:
openstack bgp peer create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --peer-ip <peer-ip-address> --remote-as <peer-remote-as> [--auth-type <peer-auth-type>] [--password <auth-password>] [--project <project>] [--project-domain <project-domain>] <name>
openstack bgp peer create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --peer-ip <peer-ip-address>
--remote-as <peer-remote-as>
[--auth-type <peer-auth-type>]
[--password <auth-password>]
[--project <project>]
[--project-domain <project-domain>]
<name>
Value | Summary |
---|---|
<name> | Name of the bgp peer to create |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--peer-ip <peer-ip-address> | Peer ip address |
--remote-as <peer-remote-as> | Peer as number. (integer in [1, 65535] is allowed) |
--auth-type <peer-auth-type> | Authentication algorithm. supported algorithms: none (default), md5 |
--password <auth-password> | Authentication password |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.4. bgp peer delete
Delete a BGP peer
Usage:
openstack bgp peer delete [-h] <bgp-peer>
openstack bgp peer delete [-h] <bgp-peer>
Value | Summary |
---|---|
<bgp-peer> | Bgp peer to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.5. bgp peer list
List BGP peers
Usage:
openstack bgp peer 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]
openstack bgp peer 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.6. bgp peer set
Update a BGP peer
Usage:
openstack bgp peer set [-h] [--name NAME] [--password <auth-password>] <bgp-peer>
openstack bgp peer set [-h] [--name NAME] [--password <auth-password>]
<bgp-peer>
Value | Summary |
---|---|
<bgp-peer> | Bgp peer to update (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME | Updated name of the bgp peer |
--password <auth-password> | Updated authentication password |
12.7. bgp peer show
Show information for a BGP peer
Usage:
openstack bgp peer show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <bgp-peer>
openstack bgp peer show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<bgp-peer>
Value | Summary |
---|---|
<bgp-peer> | Bgp peer to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.8. bgp speaker add network
Add a network to a BGP speaker
Usage:
openstack bgp speaker add network [-h] <bgp-speaker> <network>
openstack bgp speaker add network [-h] <bgp-speaker> <network>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker (name or id) |
<network> | Network to add (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.9. bgp speaker add peer
Add a peer to a BGP speaker
Usage:
openstack bgp speaker add peer [-h] <bgp-speaker> <bgp-peer>
openstack bgp speaker add peer [-h] <bgp-speaker> <bgp-peer>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker (name or id) |
<bgp-peer> | Bgp peer to add (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.10. bgp speaker create
Create a BGP speaker
Usage:
openstack bgp speaker create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --local-as <local-as> [--ip-version {4,6}] [--advertise-floating-ip-host-routes] [--no-advertise-floating-ip-host-routes] [--advertise-tenant-networks] [--no-advertise-tenant-networks] [--project <project>] [--project-domain <project-domain>] <name>
openstack bgp speaker create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --local-as <local-as>
[--ip-version {4,6}]
[--advertise-floating-ip-host-routes]
[--no-advertise-floating-ip-host-routes]
[--advertise-tenant-networks]
[--no-advertise-tenant-networks]
[--project <project>]
[--project-domain <project-domain>]
<name>
Value | Summary |
---|---|
<name> | Name of the bgp speaker to create |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--local-as <local-as> | Local as number. (integer in [1, 65535] is allowed.) |
--ip-version {4,6} | Ip version for the bgp speaker (default is 4) |
--advertise-floating-ip-host-routes | Enable the advertisement of floating ip host routes by the BGP speaker. (default) |
--no-advertise-floating-ip-host-routes | Disable the advertisement of floating ip host routes by the BGP speaker. |
--advertise-tenant-networks | Enable the advertisement of tenant network routes by the BGP speaker. (default) |
--no-advertise-tenant-networks | Disable the advertisement of tenant network routes by the BGP speaker. |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.11. bgp speaker delete
Delete a BGP speaker
Usage:
openstack bgp speaker delete [-h] <bgp-speaker>
openstack bgp speaker delete [-h] <bgp-speaker>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.12. bgp speaker list advertised routes
List routes advertised
Usage:
openstack bgp speaker list advertised routes [-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] <bgp-speaker>
openstack bgp speaker list advertised routes [-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]
<bgp-speaker>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.13. bgp speaker list
List BGP speakers
Usage:
openstack bgp speaker 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] [--agent <agent-id>]
openstack bgp speaker 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]
[--agent <agent-id>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--agent <agent-id> | List bgp speakers hosted by an agent (id only) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.14. bgp speaker remove network
Remove a network from a BGP speaker
Usage:
openstack bgp speaker remove network [-h] <bgp-speaker> <network>
openstack bgp speaker remove network [-h] <bgp-speaker> <network>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker (name or id) |
<network> | Network to remove (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.15. bgp speaker remove peer
Remove a peer from a BGP speaker
Usage:
openstack bgp speaker remove peer [-h] <bgp-speaker> <bgp-peer>
openstack bgp speaker remove peer [-h] <bgp-speaker> <bgp-peer>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker (name or id) |
<bgp-peer> | Bgp peer to remove (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
12.16. bgp speaker set
Set BGP speaker properties
Usage:
openstack bgp speaker set [-h] [--name NAME] [--advertise-floating-ip-host-routes] [--no-advertise-floating-ip-host-routes] [--advertise-tenant-networks] [--no-advertise-tenant-networks] <bgp-speaker>
openstack bgp speaker set [-h] [--name NAME]
[--advertise-floating-ip-host-routes]
[--no-advertise-floating-ip-host-routes]
[--advertise-tenant-networks]
[--no-advertise-tenant-networks]
<bgp-speaker>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker to update (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME | Name of the bgp speaker to update |
--advertise-floating-ip-host-routes | Enable the advertisement of floating ip host routes by the BGP speaker. (default) |
--no-advertise-floating-ip-host-routes | Disable the advertisement of floating ip host routes by the BGP speaker. |
--advertise-tenant-networks | Enable the advertisement of tenant network routes by the BGP speaker. (default) |
--no-advertise-tenant-networks | Disable the advertisement of tenant network routes by the BGP speaker. |
12.17. bgp speaker show dragents
List dynamic routing agents hosting a BGP speaker
Usage:
openstack bgp speaker show dragents [-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] <bgp-speaker>
openstack bgp speaker show dragents [-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]
<bgp-speaker>
Value | Summary |
---|---|
<bgp-speaker> | Id or name of the bgp speaker |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
12.18. bgp speaker show
Show a BGP speaker
Usage:
openstack bgp speaker show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <bgp-speaker>
openstack bgp speaker show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<bgp-speaker>
Value | Summary |
---|---|
<bgp-speaker> | Bgp speaker to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 13. bgpvpn
This chapter describes the commands under the bgpvpn
command.
13.1. bgpvpn create
Create BGP VPN resource
Usage:
openstack bgpvpn create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--name <name>] [--route-target <route-target>] [--import-target <import-target>] [--export-target <export-target>] [--route-distinguisher <route-distinguisher>] [--vni VNI] [--local-pref LOCAL_PREF] [--type {l2,l3}]
openstack bgpvpn create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--project <project>]
[--project-domain <project-domain>]
[--name <name>] [--route-target <route-target>]
[--import-target <import-target>]
[--export-target <export-target>]
[--route-distinguisher <route-distinguisher>]
[--vni VNI] [--local-pref LOCAL_PREF]
[--type {l2,l3}]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--name <name> | Name of the bgp vpn |
--route-target <route-target> | Add route target to import/export list (repeat option for multiple Route Targets) |
--import-target <import-target> | Add route target to import list (repeat option for multiple Route Targets) |
--export-target <export-target> | Add route target to export list (repeat option for multiple Route Targets) |
--route-distinguisher <route-distinguisher> | Add route distinguisher to the list of route Distinguishers from which a Route Distinguishers will be picked from to advertise a VPN route (repeat option for multiple Route Distinguishers) |
--vni VNI | Vxlan network identifier to be used for this bgpvpn when a VXLAN encapsulation is used |
--local-pref LOCAL_PREF | Default bgp local_pref to use in route advertisementstowards this BGPVPN. |
--type {l2,l3} | Bgp vpn type selection between ip vpn (l3) and Ethernet VPN (l2) (default: l3) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.2. bgpvpn delete
Delete BGP VPN resource(s)
Usage:
openstack bgpvpn delete [-h] <bgpvpn> [<bgpvpn> ...]
openstack bgpvpn delete [-h] <bgpvpn> [<bgpvpn> ...]
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
13.3. bgpvpn list
List BGP VPN resources
Usage:
openstack bgpvpn 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] [--project <project>] [--project-domain <project-domain>] [--long] [--property <key=value>]
openstack bgpvpn 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] [--project <project>]
[--project-domain <project-domain>] [--long]
[--property <key=value>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--long | List additional fields in output |
--property <key=value> | Filter property to apply on returned bgp vpns (repeat to filter on multiple properties) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.4. bgpvpn network association create
Create a BGP VPN network association
Usage:
openstack bgpvpn network association create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] <bgpvpn> <network>
openstack bgpvpn network association create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--project <project>]
[--project-domain <project-domain>]
<bgpvpn> <network>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn to apply the network association (name or id) |
<network> | Network to associate the bgp vpn (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.5. bgpvpn network association delete
Delete a BGP VPN network association(s) for a given BGP VPN
Usage:
openstack bgpvpn network association delete [-h] <network association ID> [<network association ID> ...] <bgpvpn>
openstack bgpvpn network association delete [-h]
<network association ID>
[<network association ID> ...]
<bgpvpn>
Value | Summary |
---|---|
<network association ID> | Network association id(s) to remove |
<bgpvpn> | Bgp vpn the network association belongs to (name or ID) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
13.6. bgpvpn network association list
List BGP VPN network associations for a given BGP VPN
Usage:
openstack bgpvpn network association 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] [--property <key=value>] <bgpvpn>
openstack bgpvpn network association 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]
[--property <key=value>]
<bgpvpn>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn listed associations belong to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
--property <key=value> | Filter property to apply on returned bgp vpns (repeat to filter on multiple properties) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.7. bgpvpn network association show
Show information of a given BGP VPN network association
Usage:
openstack bgpvpn network association show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network association ID> <bgpvpn>
openstack bgpvpn network association show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<network association ID>
<bgpvpn>
Value | Summary |
---|---|
<network association ID> | Network association id to look up |
<bgpvpn> | Bgp vpn the association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.8. bgpvpn port association create
Create a BGP VPN port association
Usage:
openstack bgpvpn port association create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--advertise-fixed-ips | --no-advertise-fixed-ips] [--prefix-route prefix=<cidr>[,local_pref=<integer>]] [--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]] <bgpvpn> <port>
openstack bgpvpn port association create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--project <project>]
[--project-domain <project-domain>]
[--advertise-fixed-ips | --no-advertise-fixed-ips]
[--prefix-route prefix=<cidr>[,local_pref=<integer>]]
[--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]]
<bgpvpn> <port>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn to apply the port association (name or id) |
<port> | Port to associate the bgp vpn (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--advertise-fixed-ips | Fixed ips of the port will be advertised to the bgp VPN (default) |
--no-advertise-fixed-ips | Fixed ips of the port will not be advertised to the BGP VPN |
--prefix-route prefix=<cidr>[,local_pref=<integer>] | Add prefix route in cidr notation. optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple prefix routes) |
--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>] | Add bgp vpn route for route leaking. optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple BGP VPN routes) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.9. bgpvpn port association delete
Delete a BGP VPN port association(s) for a given BGP VPN
Usage:
openstack bgpvpn port association delete [-h] <port association ID> [<port association ID> ...] <bgpvpn>
openstack bgpvpn port association delete [-h]
<port association ID>
[<port association ID> ...]
<bgpvpn>
Value | Summary |
---|---|
<port association ID> | Port association id(s) to remove |
<bgpvpn> | Bgp vpn the port association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
13.10. bgpvpn port association list
List BGP VPN port associations for a given BGP VPN
Usage:
openstack bgpvpn port association 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] [--property <key=value>] <bgpvpn>
openstack bgpvpn port association 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]
[--property <key=value>]
<bgpvpn>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn listed associations belong to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
--property <key=value> | Filter property to apply on returned bgp vpns (repeat to filter on multiple properties) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.11. bgpvpn port association set
Set BGP VPN port association properties
Usage:
openstack bgpvpn port association set [-h] [--advertise-fixed-ips | --no-advertise-fixed-ips] [--prefix-route prefix=<cidr>[,local_pref=<integer>]] [--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]] [--no-prefix-route] [--no-bgpvpn-route] <port association ID> <bgpvpn>
openstack bgpvpn port association set [-h]
[--advertise-fixed-ips | --no-advertise-fixed-ips]
[--prefix-route prefix=<cidr>[,local_pref=<integer>]]
[--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>]]
[--no-prefix-route]
[--no-bgpvpn-route]
<port association ID> <bgpvpn>
Value | Summary |
---|---|
<port association ID> | Port association id to update |
<bgpvpn> | Bgp vpn the port association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--advertise-fixed-ips | Fixed ips of the port will be advertised to the bgp VPN |
--no-advertise-fixed-ips | Fixed ips of the port will not be advertised to the BGP VPN |
--prefix-route prefix=<cidr>[,local_pref=<integer>] | Add prefix route in cidr notation. optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple prefix routes) |
--bgpvpn-route bgpvpn=<BGP VPN ID or name>[,local_pref=<integer>] | Add bgp vpn route for route leaking. optionally, can control the value of the BGP LOCAL_PREF of the routes that will be advertised (repeat option for multiple BGP VPN routes) |
--no-prefix-route | Empty prefix route list |
--no-bgpvpn-route | Empty bgp vpn route list |
13.12. bgpvpn port association show
Show information of a given BGP VPN port association
Usage:
openstack bgpvpn port association show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <port association ID> <bgpvpn>
openstack bgpvpn port association show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<port association ID> <bgpvpn>
Value | Summary |
---|---|
<port association ID> | Port association id to look up |
<bgpvpn> | Bgp vpn the association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.13. bgpvpn port association unset
Unset BGP VPN port association properties
Usage:
openstack bgpvpn port association unset [-h] [--advertise-fixed-ips | --no-advertise-fixed-ips] [--prefix-route <cidr>] [--bgpvpn-route <BGP VPN ID or name>] [--all-prefix-routes] [--all-bgpvpn-routes] <port association ID> <bgpvpn>
openstack bgpvpn port association unset [-h]
[--advertise-fixed-ips | --no-advertise-fixed-ips]
[--prefix-route <cidr>]
[--bgpvpn-route <BGP VPN ID or name>]
[--all-prefix-routes]
[--all-bgpvpn-routes]
<port association ID> <bgpvpn>
Value | Summary |
---|---|
<port association ID> | Port association id to update |
<bgpvpn> | Bgp vpn the port association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--advertise-fixed-ips | Fixed ips of the port will not be advertised to the BGP VPN |
--no-advertise-fixed-ips | Fixed ips of the port will be advertised to the bgp VPN |
--prefix-route <cidr> | Remove prefix route in cidr notation (repeat option for multiple prefix routes) |
--bgpvpn-route <BGP VPN ID or name> | Remove bgp vpn route (repeat option for multiple bgp VPN routes) |
--all-prefix-routes | Empty prefix route list |
--all-bgpvpn-routes | Empty bgp vpn route list |
13.14. bgpvpn router association create
Create a BGP VPN router association
Usage:
openstack bgpvpn router association create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--advertise_extra_routes | --no-advertise_extra_routes] <bgpvpn> <router>
openstack bgpvpn router association create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--project <project>]
[--project-domain <project-domain>]
[--advertise_extra_routes | --no-advertise_extra_routes]
<bgpvpn> <router>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn to apply the router association (name or id) |
<router> | Router to associate the bgp vpn (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--advertise_extra_routes | Routes will be advertised to the bgp vpn (default) |
--no-advertise_extra_routes | Routes from the router will not be advertised to the BGP VPN |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.15. bgpvpn router association delete
Delete a BGP VPN router association(s) for a given BGP VPN
Usage:
openstack bgpvpn router association delete [-h] <router association ID> [<router association ID> ...] <bgpvpn>
openstack bgpvpn router association delete [-h]
<router association ID>
[<router association ID> ...]
<bgpvpn>
Value | Summary |
---|---|
<router association ID> | Router association id(s) to remove |
<bgpvpn> | Bgp vpn the router association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
13.16. bgpvpn router association list
List BGP VPN router associations for a given BGP VPN
Usage:
openstack bgpvpn router association 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] [--property <key=value>] <bgpvpn>
openstack bgpvpn router association 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]
[--property <key=value>]
<bgpvpn>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn listed associations belong to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
--property <key=value> | Filter property to apply on returned bgp vpns (repeat to filter on multiple properties) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.17. bgpvpn router association set
Set BGP VPN router association properties
Usage:
openstack bgpvpn router association set [-h] [--advertise_extra_routes | --no-advertise_extra_routes] <router association ID> <bgpvpn>
openstack bgpvpn router association set [-h]
[--advertise_extra_routes | --no-advertise_extra_routes]
<router association ID>
<bgpvpn>
Value | Summary |
---|---|
<router association ID> | Router association id to update |
<bgpvpn> | Bgp vpn the router association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--advertise_extra_routes | Routes will be advertised to the bgp vpn |
--no-advertise_extra_routes | Routes from the router will not be advertised to the BGP VPN |
13.18. bgpvpn router association show
Show information of a given BGP VPN router association
Usage:
openstack bgpvpn router association show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <router association ID> <bgpvpn>
openstack bgpvpn router association show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<router association ID>
<bgpvpn>
Value | Summary |
---|---|
<router association ID> | Router association id to look up |
<bgpvpn> | Bgp vpn the association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.19. bgpvpn router association unset
Unset BGP VPN router association properties
Usage:
openstack bgpvpn router association unset [-h] [--advertise_extra_routes | --no-advertise_extra_routes] <router association ID> <bgpvpn>
openstack bgpvpn router association unset [-h]
[--advertise_extra_routes | --no-advertise_extra_routes]
<router association ID>
<bgpvpn>
Value | Summary |
---|---|
<router association ID> | Router association id to update |
<bgpvpn> | Bgp vpn the router association belongs to (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--advertise_extra_routes | Routes from the router will not be advertised to the BGP VPN |
--no-advertise_extra_routes | Routes will be advertised to the bgp vpn |
13.20. bgpvpn set
Set BGP VPN properties
Usage:
openstack bgpvpn set [-h] [--name <name>] [--route-target <route-target>] [--no-route-target] [--import-target <import-target>] [--no-import-target] [--export-target <export-target>] [--no-export-target] [--route-distinguisher <route-distinguisher>] [--no-route-distinguisher] [--vni VNI] [--local-pref LOCAL_PREF] <bgpvpn>
openstack bgpvpn set [-h] [--name <name>]
[--route-target <route-target>]
[--no-route-target]
[--import-target <import-target>]
[--no-import-target]
[--export-target <export-target>]
[--no-export-target]
[--route-distinguisher <route-distinguisher>]
[--no-route-distinguisher] [--vni VNI]
[--local-pref LOCAL_PREF]
<bgpvpn>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn to update (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Name of the bgp vpn |
--route-target <route-target> | Add route target to import/export list (repeat option for multiple Route Targets) |
--no-route-target | Empty route target list |
--import-target <import-target> | Add route target to import list (repeat option for multiple Route Targets) |
--no-import-target | Empty import route target list |
--export-target <export-target> | Add route target to export list (repeat option for multiple Route Targets) |
--no-export-target | Empty export route target list |
--route-distinguisher <route-distinguisher> | Add route distinguisher to the list of route Distinguishers from which a Route Distinguishers will be picked from to advertise a VPN route (repeat option for multiple Route Distinguishers) |
--no-route-distinguisher | Empty route distinguisher list |
--vni VNI | Vxlan network identifier to be used for this bgpvpn when a VXLAN encapsulation is used |
--local-pref LOCAL_PREF | Default bgp local_pref to use in route advertisementstowards this BGPVPN. |
13.21. bgpvpn show
Show information of a given BGP VPN
Usage:
openstack bgpvpn show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <bgpvpn>
openstack bgpvpn show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<bgpvpn>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
13.22. bgpvpn unset
Unset BGP VPN properties
Usage:
openstack bgpvpn unset [-h] [--route-target <route-target>] [--all-route-target] [--import-target <import-target>] [--all-import-target] [--export-target <export-target>] [--all-export-target] [--route-distinguisher <route-distinguisher>] [--all-route-distinguisher] [--vni VNI] [--local-pref LOCAL_PREF] <bgpvpn>
openstack bgpvpn unset [-h] [--route-target <route-target>]
[--all-route-target]
[--import-target <import-target>]
[--all-import-target]
[--export-target <export-target>]
[--all-export-target]
[--route-distinguisher <route-distinguisher>]
[--all-route-distinguisher] [--vni VNI]
[--local-pref LOCAL_PREF]
<bgpvpn>
Value | Summary |
---|---|
<bgpvpn> | Bgp vpn to update (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--route-target <route-target> | Remove route target from import/export list (repeat option for multiple Route Targets) |
--all-route-target | Empty route target list |
--import-target <import-target> | Remove route target from import list (repeat option for multiple Route Targets) |
--all-import-target | Empty import route target list |
--export-target <export-target> | Remove route target from export list (repeat option for multiple Route Targets) |
--all-export-target | Empty export route target list |
--route-distinguisher <route-distinguisher> | Remove route distinguisher from the list of route Distinguishers from which a Route Distinguishers will be picked from to advertise a VPN route (repeat option for multiple Route Distinguishers) |
--all-route-distinguisher | Empty route distinguisher list |
--vni VNI | Vxlan network identifier to be used for this bgpvpn when a VXLAN encapsulation is used |
--local-pref LOCAL_PREF | Default bgp local_pref to use in route advertisementstowards this BGPVPN. |
Chapter 14. ca
This chapter describes the commands under the ca
command.
14.1. ca get
Retrieve a CA by providing its URI.
Usage:
openstack ca get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] URI
openstack ca get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[--noindent] [--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
URI
Value | Summary |
---|---|
URI | The uri reference for the ca. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
14.2. ca list
List CAs.
Usage:
openstack ca 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] [--offset OFFSET] [--name NAME]
openstack ca 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]
[--offset OFFSET] [--name NAME]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit LIMIT, -l LIMIT | Specify the limit to the number of items to list per page (default: 10; maximum: 100) |
--offset OFFSET, -o OFFSET | Specify the page offset (default: 0) |
--name NAME, -n NAME | Specify the ca name (default: none) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 15. catalog
This chapter describes the commands under the catalog
command.
15.1. catalog list
List services in the service catalog
Usage:
openstack catalog 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]
openstack catalog 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
15.2. catalog show
Display service catalog details
Usage:
openstack catalog show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <service>
openstack catalog show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<service>
Value | Summary |
---|---|
<service> | Service to display (type or name) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 16. coe
This chapter describes the commands under the coe
command.
16.1. coe ca rotate
Rotate the CA certificate for cluster to revoke access.
Usage:
openstack coe ca rotate [-h] <cluster>
openstack coe ca rotate [-h] <cluster>
Value | Summary |
---|---|
<cluster> | Id or name of the cluster |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
16.2. coe ca show
Show details about the CA certificate for a cluster.
Usage:
openstack coe ca show [-h] <cluster>
openstack coe ca show [-h] <cluster>
Value | Summary |
---|---|
<cluster> | Id or name of the cluster |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
16.3. coe ca sign
Generate the CA certificate for a cluster.
Usage:
openstack coe ca sign [-h] <cluster> <csr>
openstack coe ca sign [-h] <cluster> <csr>
Value | Summary |
---|---|
<cluster> | Id or name of the cluster |
<csr> | File path of csr file to send to magnum to get signed. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
16.4. coe cluster config
Get Configuration for a Cluster
Usage:
openstack coe cluster config [-h] [--dir <dir>] [--force] [--output-certs] [--use-certificate] [--use-keystone] <cluster>
openstack coe cluster config [-h] [--dir <dir>] [--force]
[--output-certs] [--use-certificate]
[--use-keystone]
<cluster>
Value | Summary |
---|---|
<cluster> | The name or uuid of cluster to update |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--dir <dir> | Directory to save the certificate and config files. |
--force | Overwrite files if existing. |
--output-certs | Output certificates in separate files. |
--use-certificate | Use certificate in config files. |
--use-keystone | Use keystone token in config files. |
16.5. coe cluster create
Create a cluster
Usage:
openstack coe cluster create [-h] --cluster-template <cluster-template> [--discovery-url <discovery-url>] [--docker-volume-size <docker-volume-size>] [--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>] [--keypair <keypair>] [--master-count <master-count>] [--node-count <node-count>] [--timeout <timeout>] [--master-flavor <master-flavor>] [--flavor <flavor>] <name>
openstack coe cluster create [-h] --cluster-template <cluster-template>
[--discovery-url <discovery-url>]
[--docker-volume-size <docker-volume-size>]
[--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>]
[--keypair <keypair>]
[--master-count <master-count>]
[--node-count <node-count>]
[--timeout <timeout>]
[--master-flavor <master-flavor>]
[--flavor <flavor>]
<name>
Value | Summary |
---|---|
<name> | Name of the cluster to create. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--cluster-template <cluster-template> | Id or name of the cluster template. |
--discovery-url <discovery-url> | Specifies custom delivery url for node discovery. |
--docker-volume-size <docker-volume-size> | The size in gb for the docker volume to use. |
--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3…> | Arbitrary labels in the form of key=valuepairs to associate with a cluster template. May be used multiple times. |
--keypair <keypair> | Uuid or name of the keypair to use. |
--master-count <master-count> | The number of master nodes for the cluster. |
--node-count <node-count> | The cluster node count. |
--timeout <timeout> | The timeout for cluster creation time. the default is 60 minutes. |
--master-flavor <master-flavor> | The nova flavor name or uuid to use when launching the master node of the Cluster. |
--flavor <flavor> | The nova flavor name or uuid to use when launching the Cluster. |
16.6. coe cluster delete
Delete a cluster
Usage:
openstack coe cluster delete [-h] <cluster> [<cluster> ...]
openstack coe cluster delete [-h] <cluster> [<cluster> ...]
Value | Summary |
---|---|
<cluster> | Id or name of the cluster(s) to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
16.7. coe cluster list
List clusters
Usage:
openstack coe cluster 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>] [--sort-key <sort-key>] [--sort-dir <sort-dir>]
openstack coe cluster 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>] [--sort-key <sort-key>]
[--sort-dir <sort-dir>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of clusters to return |
--sort-key <sort-key> | Column to sort results by |
--sort-dir <sort-dir> | Direction to sort. "asc" or "desc". |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.8. coe cluster show
Show a Cluster
Usage:
openstack coe cluster show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <cluster>
openstack coe cluster show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<cluster>
Value | Summary |
---|---|
<cluster> | Id or name of the cluster to show. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.9. coe cluster template create
Create a Cluster Template.
Usage:
openstack coe cluster template create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --coe <coe> --image <image> --external-network <external-network> [--keypair <keypair>] [--fixed-network <fixed-network>] [--fixed-subnet <fixed-subnet>] [--network-driver <network-driver>] [--volume-driver <volume-driver>] [--dns-nameserver <dns-nameserver>] [--flavor <flavor>] [--master-flavor <master-flavor>] [--docker-volume-size <docker-volume-size>] [--docker-storage-driver <docker-storage-driver>] [--http-proxy <http-proxy>] [--https-proxy <https-proxy>] [--no-proxy <no-proxy>] [--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>] [--tls-disabled] [--public] [--registry-enabled] [--server-type <server-type>] [--master-lb-enabled] [--floating-ip-enabled] [--floating-ip-disabled] <name>
openstack coe cluster template create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--coe <coe> --image <image>
--external-network
<external-network>
[--keypair <keypair>]
[--fixed-network <fixed-network>]
[--fixed-subnet <fixed-subnet>]
[--network-driver <network-driver>]
[--volume-driver <volume-driver>]
[--dns-nameserver <dns-nameserver>]
[--flavor <flavor>]
[--master-flavor <master-flavor>]
[--docker-volume-size <docker-volume-size>]
[--docker-storage-driver <docker-storage-driver>]
[--http-proxy <http-proxy>]
[--https-proxy <https-proxy>]
[--no-proxy <no-proxy>]
[--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3...>]
[--tls-disabled] [--public]
[--registry-enabled]
[--server-type <server-type>]
[--master-lb-enabled]
[--floating-ip-enabled]
[--floating-ip-disabled]
<name>
Value | Summary |
---|---|
<name> | Name of the cluster template to create. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--coe <coe> | Specify the container orchestration engine to use. |
--image <image> | The name or uuid of the base image to customize for the Cluster. |
--external-network <external-network> | The external neutron network name or uuid to connect to this Cluster Template. |
--keypair <keypair> | The name or uuid of the ssh keypair to load into the Cluster nodes. |
--fixed-network <fixed-network> | The private neutron network name to connect to this Cluster model. |
--fixed-subnet <fixed-subnet> | The private neutron subnet name to connect to cluster. |
--network-driver <network-driver> | The network driver name for instantiating container networks. |
--volume-driver <volume-driver> | The volume driver name for instantiating container volume. |
--dns-nameserver <dns-nameserver> | The dns nameserver to use for this cluster template. |
--flavor <flavor> | The nova flavor name or uuid to use when launching the Cluster. |
--master-flavor <master-flavor> | The nova flavor name or uuid to use when launching the master node of the Cluster. |
--docker-volume-size <docker-volume-size> | Specify the number of size in gb for the docker volume to use. |
--docker-storage-driver <docker-storage-driver> | Select a docker storage driver. supported: devicemapper, overlay. Default: devicemapper |
--http-proxy <http-proxy> | The http_proxy address to use for nodes in cluster. |
--https-proxy <https-proxy> | The https_proxy address to use for nodes in cluster. |
--no-proxy <no-proxy> | The no_proxy address to use for nodes in cluster. |
--labels <KEY1=VALUE1,KEY2=VALUE2;KEY3=VALUE3…> | Arbitrary labels in the form of key=value pairs to associate with a cluster template. May be used multiple times. |
--tls-disabled | Disable tls in the cluster. |
--public | Make cluster template public. |
--registry-enabled | Enable docker registry in the cluster |
--server-type <server-type> | Specify the server type to be used for example vm. for this release default server type will be vm. |
--master-lb-enabled | Indicates whether created clusters should have a load balancer for master nodes or not. |
--floating-ip-enabled | Indicates whether created clusters should have a floating ip. |
--floating-ip-disabled | Disables floating ip creation on the new cluster |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.10. coe cluster template delete
Delete a Cluster Template.
Usage:
openstack coe cluster template delete [-h] <cluster-templates> [<cluster-templates> ...]
openstack coe cluster template delete [-h]
<cluster-templates>
[<cluster-templates> ...]
Value | Summary |
---|---|
<cluster-templates> | Id or name of the (cluster template)s to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
16.11. coe cluster template list
List Cluster Templates.
Usage:
openstack coe cluster 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>] [--sort-key <sort-key>] [--sort-dir <sort-dir>] [--fields <fields>]
openstack coe cluster 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>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>]
[--fields <fields>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <limit> | Maximum number of cluster templates to return |
--sort-key <sort-key> | Column to sort results by |
--sort-dir <sort-dir> | Direction to sort. "asc" or "desc". |
--fields <fields> | Comma-separated list of fields to display. available fields: uuid, name, coe, image_id, public, link, apiserver_port, server_type, tls_disabled, registry_enabled |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.12. coe cluster template show
Show a Cluster Template.
Usage:
openstack coe cluster template show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <cluster-template>
openstack coe cluster template show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<cluster-template>
Value | Summary |
---|---|
<cluster-template> | Id or name of the cluster template to show. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.13. coe cluster template update
Update a Cluster Template.
Usage:
openstack coe cluster template update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <cluster-template> <op> <path=value> [<path=value> ...]
openstack coe cluster template update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<cluster-template> <op>
<path=value> [<path=value> ...]
Value | Summary |
---|---|
<cluster-template> | The name or uuid of cluster template to update |
<op> | Operations: one of add, replace or remove |
<path=value> | Attributes to add/replace or remove (only path is necessary on remove) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.14. coe cluster update
Update a Cluster
Usage:
openstack coe cluster update [-h] [--rollback] <cluster> <op> <path=value> [<path=value> ...]
openstack coe cluster update [-h] [--rollback]
<cluster> <op> <path=value>
[<path=value> ...]
Value | Summary |
---|---|
<cluster> | The name or uuid of cluster to update |
<op> | Operations: one of add, replace or remove |
<path=value> | Attributes to add/replace or remove (only path is necessary on remove) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--rollback | Rollback cluster on update failure. |
16.15. coe quotas create
Create a quota.
Usage:
openstack coe quotas create [-h] --project-id <project-id> --resource <resource> [--hard-limit <hard-limit>]
openstack coe quotas create [-h] --project-id <project-id> --resource
<resource> [--hard-limit <hard-limit>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-id <project-id> | Project id |
--resource <resource> | Resource name. |
--hard-limit <hard-limit> | Max resource limit (default: hard-limit=1) |
16.16. coe quotas delete
Delete specified resource quota.
Usage:
openstack coe quotas delete [-h] --project-id <project-id> --resource <resource>
openstack coe quotas delete [-h] --project-id <project-id> --resource
<resource>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-id <project-id> | Project id |
--resource <resource> | Resource name. |
16.17. coe quotas list
Print a list of available quotas.
Usage:
openstack coe quotas list [-h] [--marker <marker>] [--limit <limit>] [--sort-key <sort-key>] [--sort-dir <sort-dir>] [--all-tenants]
openstack coe quotas list [-h] [--marker <marker>] [--limit <limit>]
[--sort-key <sort-key>]
[--sort-dir <sort-dir>] [--all-tenants]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker <marker> | The last quota uuid of the previous page; displays list of quotas after "marker". |
--limit <limit> | Maximum number of quotas to return. |
--sort-key <sort-key> | Column to sort results by. |
--sort-dir <sort-dir> | Direction to sort. "asc" or "desc". |
--all-tenants | Flag to indicate list all tenant quotas. |
16.18. coe quotas show
Show details about the given project resource quota.
Usage:
openstack coe quotas show [-h] --project-id <project-id> --resource <resource>
openstack coe quotas show [-h] --project-id <project-id> --resource
<resource>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-id <project-id> | Project id |
--resource <resource> | Resource name. |
16.19. coe quotas update
Update information about the given project resource quota.
Usage:
openstack coe quotas update [-h] --project-id <project-id> --resource <resource> [--hard-limit <hard-limit>]
openstack coe quotas update [-h] --project-id <project-id> --resource
<resource> [--hard-limit <hard-limit>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-id <project-id> | Project id |
--resource <resource> | Resource name. |
--hard-limit <hard-limit> | Max resource limit (default: hard-limit=1) |
16.20. coe service list
Print a list of Magnum services.
Usage:
openstack coe service 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]
openstack coe service 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
16.21. coe stats list
Show stats for the given project_id
Usage:
openstack coe stats list [-h] <project>
openstack coe stats list [-h] <project>
Value | Summary |
---|---|
<project> | Project id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Chapter 17. command
This chapter describes the commands under the command
command.
17.1. command list
List recognized commands by group
Usage:
openstack command 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] [--group <group-keyword>]
openstack command 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]
[--group <group-keyword>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--group <group-keyword> | Show commands filtered by a command group, for example: identity, volume, compute, image, network and other keywords |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 18. complete.adoc
This chapter describes the commands under the complete.adoc
command.
18.1. complete
print bash completion command
Usage:
openstack complete [-h] [--name <command_name>] [--shell <shell>]
openstack complete [-h] [--name <command_name>] [--shell <shell>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <command_name> | Command name to support with command completion |
--shell <shell> | Shell being used. use none for data only (default: bash) |
Chapter 19. compute
This chapter describes the commands under the compute
command.
19.1. compute agent create
Create compute agent
Usage:
openstack compute agent create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <os> <architecture> <version> <url> <md5hash> <hypervisor>
openstack compute agent create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<os> <architecture> <version> <url>
<md5hash> <hypervisor>
Value | Summary |
---|---|
<os> | Type of os |
<architecture> | Type of architecture |
<version> | Version |
<url> | Url |
<md5hash> | Md5 hash |
<hypervisor> | Type of hypervisor |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
19.2. compute agent delete
Delete compute agent(s)
Usage:
openstack compute agent delete [-h] <id> [<id> ...]
openstack compute agent delete [-h] <id> [<id> ...]
Value | Summary |
---|---|
<id> | Id of agent(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
19.3. compute agent list
List compute agents
Usage:
openstack compute agent 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] [--hypervisor <hypervisor>]
openstack compute agent 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]
[--hypervisor <hypervisor>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--hypervisor <hypervisor> | Type of hypervisor |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
19.4. compute agent set
Set compute agent properties
Usage:
openstack compute agent set [-h] [--agent-version <version>] [--url <url>] [--md5hash <md5hash>] <id>
openstack compute agent set [-h] [--agent-version <version>]
[--url <url>] [--md5hash <md5hash>]
<id>
Value | Summary |
---|---|
<id> | Id of the agent |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--agent-version <version> | Version of the agent |
--url <url> | Url of the agent |
--md5hash <md5hash> | Md5 hash of the agent |
19.5. compute service delete
Delete compute service(s)
Usage:
openstack compute service delete [-h] <service> [<service> ...]
openstack compute service delete [-h] <service> [<service> ...]
Value | Summary |
---|---|
<service> | Compute service(s) to delete (id only). if using ``--os-compute- api-version`` 2.53 or greater, the ID is a UUID which can be retrieved by listing compute services using the same 2.53+ microversion. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
19.6. compute service list
List compute services. Using ``--os-compute-api-version`` 2.53 or greater will return the ID as a UUID value which can be used to uniquely identify the service in a multi-cell deployment.
Usage:
openstack compute service 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] [--host <host>] [--service <service>] [--long]
openstack compute service 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]
[--host <host>] [--service <service>]
[--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--host <host> | List services on specified host (name only) |
--service <service> | List only specified service (name only) |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
19.7. compute service set
Set compute service properties
Usage:
openstack compute service set [-h] [--enable | --disable] [--disable-reason <reason>] [--up | --down] <host> <service>
openstack compute service set [-h] [--enable | --disable]
[--disable-reason <reason>]
[--up | --down]
<host> <service>
Value | Summary |
---|---|
<host> | Name of host |
<service> | Name of service (binary name) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--enable | Enable service |
--disable | Disable service |
--disable-reason <reason> | Reason for disabling the service (in quotes). should be used with --disable option. |
--up | Force up service |
--down | Force down service |
Chapter 20. configuration
This chapter describes the commands under the configuration
command.
20.1. configuration show
Display configuration details
Usage:
openstack configuration show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--mask | --unmask]
openstack configuration show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--mask | --unmask]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--mask | Attempt to mask passwords (default) |
--unmask | Show password in clear text |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 21. consistency
This chapter describes the commands under the consistency
command.
21.1. consistency group add volume
Add volume(s) to consistency group
Usage:
openstack consistency group add volume [-h] <consistency-group> <volume> [<volume> ...]
openstack consistency group add volume [-h]
<consistency-group> <volume>
[<volume> ...]
Value | Summary |
---|---|
<consistency-group> | Consistency group to contain <volume> (name or id) |
<volume> | Volume(s) to add to <consistency-group> (name or id) (repeat option to add multiple volumes) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
21.2. consistency group create
Create new consistency group.
Usage:
openstack consistency group create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] (--volume-type <volume-type> | --consistency-group-source <consistency-group> | --consistency-group-snapshot <consistency-group-snapshot>) [--description <description>] [--availability-zone <availability-zone>] [<name>]
openstack consistency group create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
(--volume-type <volume-type> | --consistency-group-source <consistency-group> | --consistency-group-snapshot <consistency-group-snapshot>)
[--description <description>]
[--availability-zone <availability-zone>]
[<name>]
Value | Summary |
---|---|
<name> | Name of new consistency group (default to none) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--volume-type <volume-type> | Volume type of this consistency group (name or id) |
--consistency-group-source <consistency-group> | Existing consistency group (name or id) |
--consistency-group-snapshot <consistency-group-snapshot> | Existing consistency group snapshot (name or id) |
--description <description> | Description of this consistency group |
--availability-zone <availability-zone> | Availability zone for this consistency group (not available if creating consistency group from source) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
21.3. consistency group delete
Delete consistency group(s).
Usage:
openstack consistency group delete [-h] [--force] <consistency-group> [<consistency-group> ...]
openstack consistency group delete [-h] [--force]
<consistency-group>
[<consistency-group> ...]
Value | Summary |
---|---|
<consistency-group> | Consistency group(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--force | Allow delete in state other than error or available |
21.4. consistency group list
List consistency groups.
Usage:
openstack consistency group 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] [--all-projects] [--long]
openstack consistency group 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]
[--all-projects] [--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show details for all projects. admin only. (defaults to False) |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
21.5. consistency group remove volume
Remove volume(s) from consistency group
Usage:
openstack consistency group remove volume [-h] <consistency-group> <volume> [<volume> ...]
openstack consistency group remove volume [-h]
<consistency-group> <volume>
[<volume> ...]
Value | Summary |
---|---|
<consistency-group> | Consistency group containing <volume> (name or id) |
<volume> | Volume(s) to remove from <consistency-group> (name or ID) (repeat option to remove multiple volumes) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
21.6. consistency group set
Set consistency group properties
Usage:
openstack consistency group set [-h] [--name <name>] [--description <description>] <consistency-group>
openstack consistency group set [-h] [--name <name>]
[--description <description>]
<consistency-group>
Value | Summary |
---|---|
<consistency-group> | Consistency group to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New consistency group name |
--description <description> | New consistency group description |
21.7. consistency group show
Display consistency group details.
Usage:
openstack consistency group show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <consistency-group>
openstack consistency group show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<consistency-group>
Value | Summary |
---|---|
<consistency-group> | Consistency group to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
21.8. consistency group snapshot create
Create new consistency group snapshot.
Usage:
openstack consistency group snapshot create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--consistency-group <consistency-group>] [--description <description>] [<snapshot-name>]
openstack consistency group snapshot create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--consistency-group <consistency-group>]
[--description <description>]
[<snapshot-name>]
Value | Summary |
---|---|
<snapshot-name> | Name of new consistency group snapshot (default to None) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--consistency-group <consistency-group> | Consistency group to snapshot (name or id) (default to be the same as <snapshot-name>) |
--description <description> | Description of this consistency group snapshot |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
21.9. consistency group snapshot delete
Delete consistency group snapshot(s).
Usage:
openstack consistency group snapshot delete [-h] <consistency-group-snapshot> [<consistency-group-snapshot> ...]
openstack consistency group snapshot delete [-h]
<consistency-group-snapshot>
[<consistency-group-snapshot> ...]
Value | Summary |
---|---|
<consistency-group-snapshot> | Consistency group snapshot(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
21.10. consistency group snapshot list
List consistency group snapshots.
Usage:
openstack consistency group snapshot 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] [--all-projects] [--long] [--status <status>] [--consistency-group <consistency-group>]
openstack consistency group snapshot 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]
[--all-projects] [--long]
[--status <status>]
[--consistency-group <consistency-group>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show detail for all projects (admin only) (defaults to False) |
--long | List additional fields in output |
--status <status> | Filters results by a status ("available", "error", "creating", "deleting" or "error_deleting") |
--consistency-group <consistency-group> | Filters results by a consistency group (name or id) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
21.11. consistency group snapshot show
Display consistency group snapshot details
Usage:
openstack consistency group snapshot show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <consistency-group-snapshot>
openstack consistency group snapshot show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<consistency-group-snapshot>
Value | Summary |
---|---|
<consistency-group-snapshot> | Consistency group snapshot to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 22. console
This chapter describes the commands under the console
command.
22.1. console log show
Show server’s console output
Usage:
openstack console log show [-h] [--lines <num-lines>] <server>
openstack console log show [-h] [--lines <num-lines>] <server>
Value | Summary |
---|---|
<server> | Server to show console log (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--lines <num-lines> | Number of lines to display from the end of the log (default=all) |
22.2. console url show
Show server’s remote console URL
Usage:
openstack console url show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--novnc | --xvpvnc | --spice | --rdp | --serial | --mks] <server>
openstack console url show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--novnc | --xvpvnc | --spice | --rdp | --serial | --mks]
<server>
Value | Summary |
---|---|
<server> | Server to show url (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--novnc | Show novnc console url (default) |
--xvpvnc | Show xvpvnc console url |
--spice | Show spice console url |
--rdp | Show rdp console url |
--serial | Show serial console url |
--mks | Show webmks console url |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 23. consumer
This chapter describes the commands under the consumer
command.
23.1. consumer create
Create new consumer
Usage:
openstack consumer create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>]
openstack consumer create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--description <description>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | New consumer description |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
23.2. consumer delete
Delete consumer(s)
Usage:
openstack consumer delete [-h] <consumer> [<consumer> ...]
openstack consumer delete [-h] <consumer> [<consumer> ...]
Value | Summary |
---|---|
<consumer> | Consumer(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
23.3. consumer list
List consumers
Usage:
openstack consumer 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]
openstack consumer 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
23.4. consumer set
Set consumer properties
Usage:
openstack consumer set [-h] [--description <description>] <consumer>
openstack consumer set [-h] [--description <description>] <consumer>
Value | Summary |
---|---|
<consumer> | Consumer to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | New consumer description |
23.5. consumer show
Display consumer details
Usage:
openstack consumer show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <consumer>
openstack consumer show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<consumer>
Value | Summary |
---|---|
<consumer> | Consumer to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 24. container
This chapter describes the commands under the container
command.
24.1. container create
Create new container
Usage:
openstack container 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] <container-name> [<container-name> ...]
openstack container 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]
<container-name> [<container-name> ...]
Value | Summary |
---|---|
<container-name> | New container name(s) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
24.2. container delete
Delete container
Usage:
openstack container delete [-h] [--recursive] <container> [<container> ...]
openstack container delete [-h] [--recursive]
<container> [<container> ...]
Value | Summary |
---|---|
<container> | Container(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--recursive, -r | Recursively delete objects and container |
24.3. container list
List containers
Usage:
openstack container 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] [--prefix <prefix>] [--marker <marker>] [--end-marker <end-marker>] [--limit <num-containers>] [--long] [--all]
openstack container 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]
[--prefix <prefix>] [--marker <marker>]
[--end-marker <end-marker>]
[--limit <num-containers>] [--long] [--all]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--prefix <prefix> | Filter list using <prefix> |
--marker <marker> | Anchor for paging |
--end-marker <end-marker> | End anchor for paging |
--limit <num-containers> | Limit the number of containers returned |
--long | List additional fields in output |
--all | List all containers (default is 10000) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
24.4. container save
Save container contents locally
Usage:
openstack container save [-h] <container>
openstack container save [-h] <container>
Value | Summary |
---|---|
<container> | Container to save |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
24.5. container set
Set container properties
Usage:
openstack container set [-h] --property <key=value> <container>
openstack container set [-h] --property <key=value> <container>
Value | Summary |
---|---|
<container> | Container to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key=value> | Set a property on this container (repeat option to set multiple properties) |
24.6. container show
Display container details
Usage:
openstack container show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <container>
openstack container show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<container>
Value | Summary |
---|---|
<container> | Container to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
24.7. container unset
Unset container properties
Usage:
openstack container unset [-h] --property <key> <container>
openstack container unset [-h] --property <key> <container>
Value | Summary |
---|---|
<container> | Container to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key> | Property to remove from container (repeat option to remove multiple properties) |
Chapter 25. credential
This chapter describes the commands under the credential
command.
25.1. credential create
Create new credential
Usage:
openstack credential create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type <type>] [--project <project>] <user> <data>
openstack credential create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--type <type>]
[--project <project>]
<user> <data>
Value | Summary |
---|---|
<user> | User that owns the credential (name or id) |
<data> | New credential data |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | New credential type: cert, ec2, totp and so on |
--project <project> | Project which limits the scope of the credential (name or ID) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
25.2. credential delete
Delete credential(s)
Usage:
openstack credential delete [-h] <credential-id> [<credential-id> ...]
openstack credential delete [-h] <credential-id> [<credential-id> ...]
Value | Summary |
---|---|
<credential-id> | Id of credential(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
25.3. credential list
List credentials
Usage:
openstack 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>] [--type <type>]
openstack 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>] [--type <type>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user <user> | Filter credentials by <user> (name or id) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--type <type> | Filter credentials by type: cert, ec2, totp and so on |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
25.4. credential set
Set credential properties
Usage:
openstack credential set [-h] --user <user> --type <type> --data <data> [--project <project>] <credential-id>
openstack credential set [-h] --user <user> --type <type> --data <data>
[--project <project>]
<credential-id>
Value | Summary |
---|---|
<credential-id> | Id of credential to change |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user <user> | User that owns the credential (name or id) |
--type <type> | New credential type: cert, ec2, totp and so on |
--data <data> | New credential data |
--project <project> | Project which limits the scope of the credential (name or ID) |
25.5. credential show
Display credential details
Usage:
openstack credential show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <credential-id>
openstack credential show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<credential-id>
Value | Summary |
---|---|
<credential-id> | Id of credential to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 26. cron
This chapter describes the commands under the cron
command.
26.1. cron trigger create
Create new trigger.
Usage:
openstack cron trigger create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--params PARAMS] [--pattern <* * * * *>] [--first-time <YYYY-MM-DD HH:MM>] [--count <integer>] [--utc] name workflow_identifier [workflow_input]
openstack cron trigger create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
[--params PARAMS] [--pattern <* * * * *>]
[--first-time <YYYY-MM-DD HH:MM>]
[--count <integer>] [--utc]
name workflow_identifier [workflow_input]
Value | Summary |
---|---|
name | Cron trigger name |
workflow_identifier | Workflow name or id |
workflow_input | Workflow input |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--params PARAMS | Workflow params |
--pattern <* * * * *> | Cron trigger pattern |
--first-time <YYYY-MM-DD HH:MM> | Date and time of the first execution. time is treated as local time unless --utc is also specified |
--count <integer> | Number of wanted executions |
--utc | All times specified should be treated as utc |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
26.2. cron trigger delete
Delete trigger.
Usage:
openstack cron trigger delete [-h] cron_trigger [cron_trigger ...]
openstack cron trigger delete [-h] cron_trigger [cron_trigger ...]
Value | Summary |
---|---|
cron_trigger | Name of cron trigger(s). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
26.3. cron trigger list
List all cron triggers.
Usage:
openstack cron trigger 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]
openstack cron trigger 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
26.4. cron trigger show
Show specific cron trigger.
Usage:
openstack cron trigger show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] cron_trigger
openstack cron trigger show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
cron_trigger
Value | Summary |
---|---|
cron_trigger | Cron trigger name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 27. datastore
This chapter describes the commands under the datastore
command.
27.1. datastore list
List available datastores
Usage:
openstack datastore 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]
openstack datastore 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
27.2. datastore show
Shows details of a datastore
Usage:
openstack datastore show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <datastore>
openstack datastore show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<datastore>
Value | Summary |
---|---|
<datastore> | Id of the datastore |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
27.3. datastore version list
Lists available versions for a datastore
Usage:
openstack datastore version 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] <datastore>
openstack datastore version 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]
<datastore>
Value | Summary |
---|---|
<datastore> | Id or name of the datastore |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
27.4. datastore version show
Shows details of a datastore version.
Usage:
openstack datastore version show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--datastore <datastore>] <datastore_version>
openstack datastore version show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--datastore <datastore>]
<datastore_version>
Value | Summary |
---|---|
<datastore_version> | Id or name of the datastore version. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--datastore <datastore> | Id or name of the datastore. optional if the id ofthe datastore_version is provided. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 28. dns
This chapter describes the commands under the dns
command.
28.1. dns quota list
List quotas
Usage:
openstack dns quota list [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] [--project-id PROJECT_ID]
openstack dns quota list [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
[--project-id PROJECT_ID]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
--project-id PROJECT_ID | Project id default: current project |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
28.2. dns quota reset
Reset quotas
Usage:
openstack dns quota reset [-h] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] [--project-id PROJECT_ID]
openstack dns quota reset [-h] [--all-projects] [--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
[--project-id PROJECT_ID]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
--project-id PROJECT_ID | Project id |
28.3. dns quota set
Set quotas
Usage:
openstack dns quota set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] [--project-id PROJECT_ID] [--api-export-size <api-export-size>] [--recordset-records <recordset-records>] [--zone-records <zone-records>] [--zone-recordsets <zone-recordsets>] [--zones <zones>]
openstack dns quota set [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
[--project-id PROJECT_ID]
[--api-export-size <api-export-size>]
[--recordset-records <recordset-records>]
[--zone-records <zone-records>]
[--zone-recordsets <zone-recordsets>]
[--zones <zones>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
--project-id PROJECT_ID | Project id |
--api-export-size <api-export-size> | New value for the api-export-size quota |
--recordset-records <recordset-records> | New value for the recordset-records quota |
--zone-records <zone-records> | New value for the zone-records quota |
--zone-recordsets <zone-recordsets> | New value for the zone-recordsets quota |
--zones <zones> | New value for the zones quota |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
28.4. dns service list
List service statuses
Usage:
openstack dns service 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] [--hostname HOSTNAME] [--service_name SERVICE_NAME] [--status STATUS] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID]
openstack dns service 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]
[--hostname HOSTNAME]
[--service_name SERVICE_NAME]
[--status STATUS] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--hostname HOSTNAME | Hostname |
--service_name SERVICE_NAME | Service name |
--status STATUS | Status |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
28.5. dns service show
Show service status details
Usage:
openstack dns service show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] id
openstack dns service show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
id
Value | Summary |
---|---|
id | Service status id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 29. domain
This chapter describes the commands under the domain
command.
29.1. domain create
Create new domain
Usage:
openstack domain create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--enable | --disable] [--or-show] <domain-name>
openstack domain create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--description <description>]
[--enable | --disable] [--or-show]
<domain-name>
Value | Summary |
---|---|
<domain-name> | New domain name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | New domain description |
--enable | Enable domain (default) |
--disable | Disable domain |
--or-show | Return existing domain |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
29.2. domain delete
Delete domain(s)
Usage:
openstack domain delete [-h] <domain> [<domain> ...]
openstack domain delete [-h] <domain> [<domain> ...]
Value | Summary |
---|---|
<domain> | Domain(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
29.3. domain list
List domains
Usage:
openstack domain 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]
openstack domain 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
29.4. domain set
Set domain properties
Usage:
openstack domain set [-h] [--name <name>] [--description <description>] [--enable | --disable] <domain>
openstack domain set [-h] [--name <name>] [--description <description>]
[--enable | --disable]
<domain>
Value | Summary |
---|---|
<domain> | Domain to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New domain name |
--description <description> | New domain description |
--enable | Enable domain |
--disable | Disable domain |
29.5. domain show
Display domain details
Usage:
openstack domain show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <domain>
openstack domain show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<domain>
Value | Summary |
---|---|
<domain> | Domain to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 30. ec2
This chapter describes the commands under the ec2
command.
30.1. ec2 credentials create
Create EC2 credentials
Usage:
openstack ec2 credentials create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--user <user>] [--user-domain <user-domain>] [--project-domain <project-domain>]
openstack ec2 credentials create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--project <project>]
[--user <user>]
[--user-domain <user-domain>]
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Create credentials in project (name or id; default: current authenticated project) |
--user <user> | Create credentials for user (name or id; default: current authenticated user) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
30.2. ec2 credentials delete
Delete EC2 credentials
Usage:
openstack ec2 credentials delete [-h] [--user <user>] [--user-domain <user-domain>] <access-key> [<access-key> ...]
openstack ec2 credentials delete [-h] [--user <user>]
[--user-domain <user-domain>]
<access-key> [<access-key> ...]
Value | Summary |
---|---|
<access-key> | Credentials access key(s) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user <user> | Delete credentials for user (name or id) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
30.3. ec2 credentials list
List EC2 credentials
Usage:
openstack ec2 credentials 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>]
openstack ec2 credentials 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>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user <user> | Filter list by user (name or id) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
30.4. ec2 credentials show
Display EC2 credentials details
Usage:
openstack ec2 credentials show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--user <user>] [--user-domain <user-domain>] <access-key>
openstack ec2 credentials show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--user <user>]
[--user-domain <user-domain>]
<access-key>
Value | Summary |
---|---|
<access-key> | Credentials access key |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--user <user> | Show credentials for user (name or id) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 31. endpoint
This chapter describes the commands under the endpoint
command.
31.1. endpoint add project
Associate a project to an endpoint
Usage:
openstack endpoint add project [-h] [--project-domain <project-domain>] <endpoint> <project>
openstack endpoint add project [-h] [--project-domain <project-domain>]
<endpoint> <project>
Value | Summary |
---|---|
<endpoint> | Endpoint to associate with specified project (name or ID) |
<project> | Project to associate with specified endpoint name or ID) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
31.2. endpoint create
Create new endpoint
Usage:
openstack endpoint create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--region <region-id>] [--enable | --disable] <service> <interface> <url>
openstack endpoint create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--region <region-id>]
[--enable | --disable]
<service> <interface> <url>
Value | Summary |
---|---|
<service> | Service to be associated with new endpoint (name or ID) |
<interface> | New endpoint interface type (admin, public or internal) |
<url> | New endpoint url |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--region <region-id> | New endpoint region id |
--enable | Enable endpoint (default) |
--disable | Disable endpoint |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
31.3. endpoint delete
Delete endpoint(s)
Usage:
openstack endpoint delete [-h] <endpoint-id> [<endpoint-id> ...]
openstack endpoint delete [-h] <endpoint-id> [<endpoint-id> ...]
Value | Summary |
---|---|
<endpoint-id> | Endpoint(s) to delete (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
31.4. endpoint group add project
Add a project to an endpoint group
Usage:
openstack endpoint group add project [-h] [--project-domain <project-domain>] <endpoint-group> <project>
openstack endpoint group add project [-h]
[--project-domain <project-domain>]
<endpoint-group> <project>
Value | Summary |
---|---|
<endpoint-group> | Endpoint group (name or id) |
<project> | Project to associate (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
31.5. endpoint group create
Create new endpoint group
Usage:
openstack endpoint group create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description DESCRIPTION] <name> <filename>
openstack endpoint group create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description DESCRIPTION]
<name> <filename>
Value | Summary |
---|---|
<name> | Name of the endpoint group |
<filename> | Filename that contains a new set of filters |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description DESCRIPTION | Description of the endpoint group |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
31.6. endpoint group delete
Delete endpoint group(s)
Usage:
openstack endpoint group delete [-h] <endpoint-group> [<endpoint-group> ...]
openstack endpoint group delete [-h]
<endpoint-group> [<endpoint-group> ...]
Value | Summary |
---|---|
<endpoint-group> | Endpoint group(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
31.7. endpoint group list
List endpoint groups
Usage:
openstack endpoint group 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] [--endpointgroup <endpoint-group> | --project <project>] [--domain <domain>]
openstack endpoint group 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]
[--endpointgroup <endpoint-group> | --project <project>]
[--domain <domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--endpointgroup <endpoint-group> | Endpoint group (name or id) |
--project <project> | Project (name or id) |
--domain <domain> | Domain owning <project> (name or id) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
31.8. endpoint group remove project
Remove project from endpoint group
Usage:
openstack endpoint group remove project [-h] [--project-domain <project-domain>] <endpoint-group> <project>
openstack endpoint group remove project [-h]
[--project-domain <project-domain>]
<endpoint-group> <project>
Value | Summary |
---|---|
<endpoint-group> | Endpoint group (name or id) |
<project> | Project to remove (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
31.9. endpoint group set
Set endpoint group properties
Usage:
openstack endpoint group set [-h] [--name <name>] [--filters <filename>] [--description <description>] <endpoint-group>
openstack endpoint group set [-h] [--name <name>]
[--filters <filename>]
[--description <description>]
<endpoint-group>
Value | Summary |
---|---|
<endpoint-group> | Endpoint group to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New enpoint group name |
--filters <filename> | Filename that contains a new set of filters |
--description <description> | New endpoint group description |
31.10. endpoint group show
Display endpoint group details
Usage:
openstack endpoint group show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <endpointgroup>
openstack endpoint group show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
<endpointgroup>
Value | Summary |
---|---|
<endpointgroup> | Endpoint group (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
31.11. endpoint list
List endpoints
Usage:
openstack endpoint 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] [--service <service>] [--interface <interface>] [--region <region-id>] [--endpoint <endpoint-group> | --project <project>] [--project-domain <project-domain>]
openstack endpoint 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]
[--service <service>] [--interface <interface>]
[--region <region-id>]
[--endpoint <endpoint-group> | --project <project>]
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--service <service> | Filter by service (type, name or id) |
--interface <interface> | Filter by interface type (admin, public or internal) |
--region <region-id> | Filter by region id |
--endpoint <endpoint-group> | Endpoint to list filters |
--project <project> | Project to list filters (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
31.12. endpoint remove project
Dissociate a project from an endpoint
Usage:
openstack endpoint remove project [-h] [--project-domain <project-domain>] <endpoint> <project>
openstack endpoint remove project [-h]
[--project-domain <project-domain>]
<endpoint> <project>
Value | Summary |
---|---|
<endpoint> | Endpoint to dissociate from specified project (name or ID) |
<project> | Project to dissociate from specified endpoint name or ID) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
31.13. endpoint set
Set endpoint properties
Usage:
openstack endpoint set [-h] [--region <region-id>] [--interface <interface>] [--url <url>] [--service <service>] [--enable | --disable] <endpoint-id>
openstack endpoint set [-h] [--region <region-id>]
[--interface <interface>] [--url <url>]
[--service <service>] [--enable | --disable]
<endpoint-id>
Value | Summary |
---|---|
<endpoint-id> | Endpoint to modify (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--region <region-id> | New endpoint region id |
--interface <interface> | New endpoint interface type (admin, public or internal) |
--url <url> | New endpoint url |
--service <service> | New endpoint service (name or id) |
--enable | Enable endpoint |
--disable | Disable endpoint |
31.14. endpoint show
Display endpoint details
Usage:
openstack endpoint show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <endpoint>
openstack endpoint show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<endpoint>
Value | Summary |
---|---|
<endpoint> | Endpoint to display (endpoint id, service id, service name, service type) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 32. event
This chapter describes the commands under the event
command.
32.1. event trigger create
Create new trigger.
Usage:
openstack event trigger create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--params PARAMS] name workflow_id exchange topic event [workflow_input]
openstack event trigger create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--params PARAMS]
name workflow_id exchange topic event
[workflow_input]
Value | Summary |
---|---|
name | Event trigger name |
workflow_id | Workflow id |
exchange | Event trigger exchange |
topic | Event trigger topic |
event | Event trigger event name |
workflow_input | Workflow input |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--params PARAMS | Workflow params |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
32.2. event trigger delete
Delete trigger.
Usage:
openstack event trigger delete [-h] event_trigger_id [event_trigger_id ...]
openstack event trigger delete [-h]
event_trigger_id [event_trigger_id ...]
Value | Summary |
---|---|
event_trigger_id | Id of event trigger(s). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
32.3. event trigger list
List all event triggers.
Usage:
openstack event trigger 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]
openstack event trigger 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
32.4. event trigger show
Show specific event trigger.
Usage:
openstack event trigger show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] event_trigger
openstack event trigger show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
event_trigger
Value | Summary |
---|---|
event_trigger | Event trigger id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 33. extension
This chapter describes the commands under the extension
command.
33.1. extension list
List API extensions
Usage:
openstack extension 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] [--identity] [--network] [--volume] [--long]
openstack extension 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]
[--identity] [--network] [--volume] [--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--compute | List extensions for the compute api |
--identity | List extensions for the identity api |
--network | List extensions for the network api |
--volume | List extensions for the block storage api |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
33.2. extension show
Show API extension
Usage:
openstack extension show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <extension>
openstack extension show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<extension>
Value | Summary |
---|---|
<extension> | Extension to display. currently, only network extensions are supported. (Name or Alias) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 34. federation
This chapter describes the commands under the federation
command.
34.1. federation domain list
List accessible domains
Usage:
openstack federation domain 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]
openstack federation domain 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
34.2. federation project list
List accessible projects
Usage:
openstack federation project 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]
openstack federation project 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
34.3. federation protocol create
Create new federation protocol
Usage:
openstack federation protocol create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --identity-provider <identity-provider> --mapping <mapping> <name>
openstack federation protocol create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--identity-provider
<identity-provider> --mapping
<mapping>
<name>
Value | Summary |
---|---|
<name> | New federation protocol name (must be unique per identity provider) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--identity-provider <identity-provider> | Identity provider that will support the new federation protocol (name or ID) (required) |
--mapping <mapping> | Mapping that is to be used (name or id) (required) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
34.4. federation protocol delete
Delete federation protocol(s)
Usage:
openstack federation protocol delete [-h] --identity-provider <identity-provider> <federation-protocol> [<federation-protocol> ...]
openstack federation protocol delete [-h] --identity-provider
<identity-provider>
<federation-protocol>
[<federation-protocol> ...]
Value | Summary |
---|---|
<federation-protocol> | Federation protocol(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--identity-provider <identity-provider> | Identity provider that supports <federation-protocol> (name or ID) (required) |
34.5. federation protocol list
List federation protocols
Usage:
openstack federation protocol 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] --identity-provider <identity-provider>
openstack federation protocol 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]
--identity-provider
<identity-provider>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--identity-provider <identity-provider> | Identity provider to list (name or id) (required) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
34.6. federation protocol set
Set federation protocol properties
Usage:
openstack federation protocol set [-h] --identity-provider <identity-provider> [--mapping <mapping>] <name>
openstack federation protocol set [-h] --identity-provider
<identity-provider>
[--mapping <mapping>]
<name>
Value | Summary |
---|---|
<name> | Federation protocol to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--identity-provider <identity-provider> | Identity provider that supports <federation-protocol> (name or ID) (required) |
--mapping <mapping> | Mapping that is to be used (name or id) |
34.7. federation protocol show
Display federation protocol details
Usage:
openstack federation protocol show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --identity-provider <identity-provider> <federation-protocol>
openstack federation protocol show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--identity-provider
<identity-provider>
<federation-protocol>
Value | Summary |
---|---|
<federation-protocol> | Federation protocol to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--identity-provider <identity-provider> | Identity provider that supports <federation-protocol> (name or ID) (required) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 35. flavor
This chapter describes the commands under the flavor
command.
35.1. flavor create
Create new flavor
Usage:
openstack flavor create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--id <id>] [--ram <size-mb>] [--disk <size-gb>] [--ephemeral <size-gb>] [--swap <size-mb>] [--vcpus <vcpus>] [--rxtx-factor <factor>] [--public | --private] [--property <key=value>] [--project <project>] [--description <description>] [--project-domain <project-domain>] <flavor-name>
openstack flavor create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--id <id>] [--ram <size-mb>]
[--disk <size-gb>] [--ephemeral <size-gb>]
[--swap <size-mb>] [--vcpus <vcpus>]
[--rxtx-factor <factor>] [--public | --private]
[--property <key=value>] [--project <project>]
[--description <description>]
[--project-domain <project-domain>]
<flavor-name>
Value | Summary |
---|---|
<flavor-name> | New flavor name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--id <id> | Unique flavor id; auto creates a uuid (default: auto) |
--ram <size-mb> | Memory size in mb (default 256m) |
--disk <size-gb> | Disk size in gb (default 0g) |
--ephemeral <size-gb> | Ephemeral disk size in gb (default 0g) |
--swap <size-mb> | Additional swap space size in mb (default 0m) |
--vcpus <vcpus> | Number of vcpus (default 1) |
--rxtx-factor <factor> | Rx/tx factor (default 1.0) |
--public | Flavor is available to other projects (default) |
--private | Flavor is not available to other projects |
--property <key=value> | Property to add for this flavor (repeat option to set multiple properties) |
--project <project> | Allow <project> to access private flavor (name or id) (Must be used with --private option) |
--description <description> | Description for the flavor.(supported by api versions 2.55 - 2.latest |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
35.2. flavor delete
Delete flavor(s)
Usage:
openstack flavor delete [-h] <flavor> [<flavor> ...]
openstack flavor delete [-h] <flavor> [<flavor> ...]
Value | Summary |
---|---|
<flavor> | Flavor(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
35.3. flavor list
List flavors
Usage:
openstack flavor 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] [--public | --private | --all] [--long] [--marker <flavor-id>] [--limit <num-flavors>]
openstack flavor 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]
[--public | --private | --all] [--long]
[--marker <flavor-id>] [--limit <num-flavors>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--public | List only public flavors (default) |
--private | List only private flavors |
--all | List all flavors, whether public or private |
--long | List additional fields in output |
--marker <flavor-id> | The last flavor id of the previous page |
--limit <num-flavors> | Maximum number of flavors to display |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
35.4. flavor set
Set flavor properties
Usage:
openstack flavor set [-h] [--no-property] [--property <key=value>] [--project <project>] [--description <description>] [--project-domain <project-domain>] <flavor>
openstack flavor set [-h] [--no-property] [--property <key=value>]
[--project <project>]
[--description <description>]
[--project-domain <project-domain>]
<flavor>
Value | Summary |
---|---|
<flavor> | Flavor to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--no-property | Remove all properties from this flavor (specify both --no-property and --property to remove the current properties before setting new properties.) |
--property <key=value> | Property to add or modify for this flavor (repeat option to set multiple properties) |
--project <project> | Set flavor access to project (name or id) (admin only) |
--description <description> | Set description for the flavor.(supported by api versions 2.55 - 2.latest |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
35.5. flavor show
Display flavor details
Usage:
openstack flavor show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <flavor>
openstack flavor show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<flavor>
Value | Summary |
---|---|
<flavor> | Flavor to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
35.6. flavor unset
Unset flavor properties
Usage:
openstack flavor unset [-h] [--property <key>] [--project <project>] [--project-domain <project-domain>] <flavor>
openstack flavor unset [-h] [--property <key>] [--project <project>]
[--project-domain <project-domain>]
<flavor>
Value | Summary |
---|---|
<flavor> | Flavor to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key> | Property to remove from flavor (repeat option to unset multiple properties) |
--project <project> | Remove flavor access from project (name or id) (admin only) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Chapter 36. floating
This chapter describes the commands under the floating
command.
36.1. floating ip create
Create floating IP
Usage:
openstack floating ip create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--subnet <subnet>] [--port <port>] [--floating-ip-address <ip-address>] [--fixed-ip-address <ip-address>] [--qos-policy <qos-policy>] [--description <description>] [--project <project>] [--dns-domain <dns-domain>] [--dns-name <dns-name>] [--project-domain <project-domain>] [--tag <tag> | --no-tag] <network>
openstack floating ip create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--subnet <subnet>]
[--port <port>]
[--floating-ip-address <ip-address>]
[--fixed-ip-address <ip-address>]
[--qos-policy <qos-policy>]
[--description <description>]
[--project <project>]
[--dns-domain <dns-domain>]
[--dns-name <dns-name>]
[--project-domain <project-domain>]
[--tag <tag> | --no-tag]
<network>
Value | Summary |
---|---|
<network> | Network to allocate floating ip from (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--subnet <subnet> | Subnet on which you want to create the floating ip (name or ID) |
--port <port> | Port to be associated with the floating ip (name or ID) |
--floating-ip-address <ip-address> | Floating ip address |
--fixed-ip-address <ip-address> | Fixed ip address mapped to the floating ip |
--qos-policy <qos-policy> | Attach qos policy to the floating ip (name or id) |
--description <description> | Set floating ip description |
--project <project> | Owner’s project (name or id) |
--dns-domain <dns-domain> | Set dns domain for this floating ip |
--dns-name <dns-name> | Set dns name for this floating ip |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--tag <tag> | Tag to be added to the floating ip (repeat option to set multiple tags) |
--no-tag | No tags associated with the floating ip |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
36.2. floating ip delete
Delete floating IP(s)
Usage:
openstack floating ip delete [-h] <floating-ip> [<floating-ip> ...]
openstack floating ip delete [-h] <floating-ip> [<floating-ip> ...]
Value | Summary |
---|---|
<floating-ip> | Floating ip(s) to delete (ip address or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
36.3. floating ip list
List floating IP(s)
Usage:
openstack floating ip 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] [--network <network>] [--port <port>] [--fixed-ip-address <ip-address>] [--floating-ip-address <ip-address>] [--long] [--status <status>] [--project <project>] [--project-domain <project-domain>] [--router <router>] [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
openstack floating ip 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]
[--network <network>] [--port <port>]
[--fixed-ip-address <ip-address>]
[--floating-ip-address <ip-address>]
[--long] [--status <status>]
[--project <project>]
[--project-domain <project-domain>]
[--router <router>]
[--tags <tag>[,<tag>,...]]
[--any-tags <tag>[,<tag>,...]]
[--not-tags <tag>[,<tag>,...]]
[--not-any-tags <tag>[,<tag>,...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--network <network> | List floating ip(s) according to given network (name or ID) |
--port <port> | List floating ip(s) according to given port (name or ID) |
--fixed-ip-address <ip-address> | List floating ip(s) according to given fixed ip address |
--floating-ip-address <ip-address> | List floating ip(s) according to given floating ip address |
--long | List additional fields in output |
--status <status> | List floating ip(s) according to given status (ACTIVE, DOWN) |
--project <project> | List floating ip(s) according to given project (name or ID) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--router <router> | List floating ip(s) according to given router (name or ID) |
--tags <tag>[,<tag>,…] | List floating ip which have all given tag(s) (comma- separated list of tags) |
--any-tags <tag>[,<tag>,…] | List floating ip which have any given tag(s) (comma- separated list of tags) |
--not-tags <tag>[,<tag>,…] | Exclude floating ip which have all given tag(s) (Comma-separated list of tags) |
--not-any-tags <tag>[,<tag>,…] | Exclude floating ip which have any given tag(s) (Comma-separated list of tags) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
36.4. floating ip pool list
List pools of floating IP addresses
Usage:
openstack floating ip pool 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]
openstack floating ip pool 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
36.5. floating ip set
Set floating IP Properties
Usage:
openstack floating ip set [-h] [--port <port>] [--fixed-ip-address <ip-address>] [--qos-policy <qos-policy> | --no-qos-policy] [--tag <tag>] [--no-tag] <floating-ip>
openstack floating ip set [-h] [--port <port>]
[--fixed-ip-address <ip-address>]
[--qos-policy <qos-policy> | --no-qos-policy]
[--tag <tag>] [--no-tag]
<floating-ip>
Value | Summary |
---|---|
<floating-ip> | Floating ip to modify (ip address or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--port <port> | Associate the floating ip with port (name or id) |
--fixed-ip-address <ip-address> | Fixed ip of the port (required only if port has multiple IPs) |
--qos-policy <qos-policy> | Attach qos policy to the floating ip (name or id) |
--no-qos-policy | Remove the qos policy attached to the floating ip |
--tag <tag> | Tag to be added to the floating ip (repeat option to set multiple tags) |
--no-tag | Clear tags associated with the floating ip. specify both --tag and --no-tag to overwrite current tags |
36.6. floating ip show
Display floating IP details
Usage:
openstack floating ip show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <floating-ip>
openstack floating ip show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<floating-ip>
Value | Summary |
---|---|
<floating-ip> | Floating ip to display (ip address or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
36.7. floating ip unset
Unset floating IP Properties
Usage:
openstack floating ip unset [-h] [--port] [--qos-policy] [--tag <tag> | --all-tag] <floating-ip>
openstack floating ip unset [-h] [--port] [--qos-policy]
[--tag <tag> | --all-tag]
<floating-ip>
Value | Summary |
---|---|
<floating-ip> | Floating ip to disassociate (ip address or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--port | Disassociate any port associated with the floating ip |
--qos-policy | Remove the qos policy attached to the floating ip |
--tag <tag> | Tag to be removed from the floating ip (repeat option to remove multiple tags) |
--all-tag | Clear all tags associated with the floating ip |
Chapter 37. group
This chapter describes the commands under the group
command.
37.1. group add user
Add user to group
Usage:
openstack group add user [-h] [--group-domain <group-domain>] [--user-domain <user-domain>] <group> <user> [<user> ...]
openstack group add user [-h] [--group-domain <group-domain>]
[--user-domain <user-domain>]
<group> <user> [<user> ...]
Value | Summary |
---|---|
<group> | Group to contain <user> (name or id) |
<user> | User(s) to add to <group> (name or id) (repeat option to add multiple users) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
37.2. group contains user
Check user membership in group
Usage:
openstack group contains user [-h] [--group-domain <group-domain>] [--user-domain <user-domain>] <group> <user>
openstack group contains user [-h] [--group-domain <group-domain>]
[--user-domain <user-domain>]
<group> <user>
Value | Summary |
---|---|
<group> | Group to check (name or id) |
<user> | User to check (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
37.3. group create
Create new group
Usage:
openstack group create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--domain <domain>] [--description <description>] [--or-show] <group-name>
openstack group create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--domain <domain>]
[--description <description>] [--or-show]
<group-name>
Value | Summary |
---|---|
<group-name> | New group name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain to contain new group (name or id) |
--description <description> | New group description |
--or-show | Return existing group |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
37.4. group delete
Delete group(s)
Usage:
openstack group delete [-h] [--domain <domain>] <group> [<group> ...]
openstack group delete [-h] [--domain <domain>] <group> [<group> ...]
Value | Summary |
---|---|
<group> | Group(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain containing group(s) (name or id) |
37.5. group list
List groups
Usage:
openstack group 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] [--domain <domain>] [--user <user>] [--user-domain <user-domain>] [--long]
openstack group 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]
[--domain <domain>] [--user <user>]
[--user-domain <user-domain>] [--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Filter group list by <domain> (name or id) |
--user <user> | Filter group list by <user> (name or id) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
37.6. group remove user
Remove user from group
Usage:
openstack group remove user [-h] [--group-domain <group-domain>] [--user-domain <user-domain>] <group> <user> [<user> ...]
openstack group remove user [-h] [--group-domain <group-domain>]
[--user-domain <user-domain>]
<group> <user> [<user> ...]
Value | Summary |
---|---|
<group> | Group containing <user> (name or id) |
<user> | User(s) to remove from <group> (name or id) (repeat option to remove multiple users) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
37.7. group set
Set group properties
Usage:
openstack group set [-h] [--domain <domain>] [--name <name>] [--description <description>] <group>
openstack group set [-h] [--domain <domain>] [--name <name>]
[--description <description>]
<group>
Value | Summary |
---|---|
<group> | Group to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain containing <group> (name or id) |
--name <name> | New group name |
--description <description> | New group description |
37.8. group show
Display group details
Usage:
openstack group show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--domain <domain>] <group>
openstack group show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--domain <domain>]
<group>
Value | Summary |
---|---|
<group> | Group to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain containing <group> (name or id) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 38. help.adoc
This chapter describes the commands under the help.adoc
command.
38.1. help
print detailed help for another command
Usage:
openstack help [-h] [cmd [cmd ...]]
openstack help [-h] [cmd [cmd ...]]
Value | Summary |
---|---|
cmd | Name of the command |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Chapter 39. host
This chapter describes the commands under the host
command.
39.1. host list
List hosts
Usage:
openstack host 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] [--zone <zone>]
openstack host 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]
[--zone <zone>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--zone <zone> | Only return hosts in the availability zone |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
39.2. host set
Set host properties
Usage:
openstack host set [-h] [--enable | --disable] [--enable-maintenance | --disable-maintenance] <host>
openstack host set [-h] [--enable | --disable]
[--enable-maintenance | --disable-maintenance]
<host>
Value | Summary |
---|---|
<host> | Host to modify (name only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--enable | Enable the host |
--disable | Disable the host |
--enable-maintenance | Enable maintenance mode for the host |
--disable-maintenance | Disable maintenance mode for the host |
39.3. host show
Display host details
Usage:
openstack host 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] <host>
openstack host 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]
<host>
Value | Summary |
---|---|
<host> | Name of host |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 40. hypervisor
This chapter describes the commands under the hypervisor
command.
40.1. hypervisor list
List hypervisors
Usage:
openstack hypervisor 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] [--matching <hostname>] [--long]
openstack hypervisor 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]
[--matching <hostname>] [--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--matching <hostname> | Filter hypervisors using <hostname> substring |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
40.2. hypervisor show
Display hypervisor details
Usage:
openstack hypervisor show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <hypervisor>
openstack hypervisor show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<hypervisor>
Value | Summary |
---|---|
<hypervisor> | Hypervisor to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
40.3. hypervisor stats show
Display hypervisor stats details
Usage:
openstack hypervisor stats show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack hypervisor stats show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 41. identity
This chapter describes the commands under the identity
command.
41.1. identity provider create
Create new identity provider
Usage:
openstack identity provider create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--remote-id <remote-id> | --remote-id-file <file-name>] [--description <description>] [--domain <domain>] [--enable | --disable] <name>
openstack identity provider create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--remote-id <remote-id> | --remote-id-file <file-name>]
[--description <description>]
[--domain <domain>]
[--enable | --disable]
<name>
Value | Summary |
---|---|
<name> | New identity provider name (must be unique) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--remote-id <remote-id> | Remote ids to associate with the identity provider (repeat option to provide multiple values) |
--remote-id-file <file-name> | Name of a file that contains many remote ids to associate with the identity provider, one per line |
--description <description> | New identity provider description |
--domain <domain> | Domain to associate with the identity provider. if not specified, a domain will be created automatically. (Name or ID) |
--enable | Enable identity provider (default) |
--disable | Disable the identity provider |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
41.2. identity provider delete
Delete identity provider(s)
Usage:
openstack identity provider delete [-h] <identity-provider> [<identity-provider> ...]
openstack identity provider delete [-h]
<identity-provider>
[<identity-provider> ...]
Value | Summary |
---|---|
<identity-provider> | Identity provider(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
41.3. identity provider list
List identity providers
Usage:
openstack identity provider 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]
openstack identity provider 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
41.4. identity provider set
Set identity provider properties
Usage:
openstack identity provider set [-h] [--description <description>] [--remote-id <remote-id> | --remote-id-file <file-name>] [--enable | --disable] <identity-provider>
openstack identity provider set [-h] [--description <description>]
[--remote-id <remote-id> | --remote-id-file <file-name>]
[--enable | --disable]
<identity-provider>
Value | Summary |
---|---|
<identity-provider> | Identity provider to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Set identity provider description |
--remote-id <remote-id> | Remote ids to associate with the identity provider (repeat option to provide multiple values) |
--remote-id-file <file-name> | Name of a file that contains many remote ids to associate with the identity provider, one per line |
--enable | Enable the identity provider |
--disable | Disable the identity provider |
41.5. identity provider show
Display identity provider details
Usage:
openstack identity provider show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <identity-provider>
openstack identity provider show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<identity-provider>
Value | Summary |
---|---|
<identity-provider> | Identity provider to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 42. image
This chapter describes the commands under the image
command.
42.1. image add project
Associate project with image
Usage:
openstack image add project [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project-domain <project-domain>] <image> <project>
openstack image add project [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--project-domain <project-domain>]
<image> <project>
Value | Summary |
---|---|
<image> | Image to share (name or id) |
<project> | Project to associate with image (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
42.2. image create
Create/upload an image
Usage:
openstack image create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--id <id>] [--container-format <container-format>] [--disk-format <disk-format>] [--min-disk <disk-gb>] [--min-ram <ram-mb>] [--file <file> | --volume <volume>] [--force] [--sign-key-path <sign-key-path>] [--sign-cert-id <sign-cert-id>] [--protected | --unprotected] [--public | --private | --community | --shared] [--property <key=value>] [--tag <tag>] [--project <project>] [--project-domain <project-domain>] <image-name>
openstack image create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--id <id>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--min-disk <disk-gb>] [--min-ram <ram-mb>]
[--file <file> | --volume <volume>] [--force]
[--sign-key-path <sign-key-path>]
[--sign-cert-id <sign-cert-id>]
[--protected | --unprotected]
[--public | --private | --community | --shared]
[--property <key=value>] [--tag <tag>]
[--project <project>]
[--project-domain <project-domain>]
<image-name>
Value | Summary |
---|---|
<image-name> | New image name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--id <id> | Image id to reserve |
--container-format <container-format> | Image container format. the supported options are: ami, ari, aki, bare, docker, ova, ovf. The default format is: bare |
--disk-format <disk-format> | Image disk format. the supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop. The default format is: raw |
--min-disk <disk-gb> | Minimum disk size needed to boot image, in gigabytes |
--min-ram <ram-mb> | Minimum ram size needed to boot image, in megabytes |
--file <file> | Upload image from local file |
--volume <volume> | Create image from a volume |
--force | Force image creation if volume is in use (only meaningful with --volume) |
--sign-key-path <sign-key-path> | Sign the image using the specified private key. only use in combination with --sign-cert-id |
--sign-cert-id <sign-cert-id> | The specified certificate uuid is a reference to the certificate in the key manager that corresponds to the public key and is used for signature validation. Only use in combination with --sign-key-path |
--protected | Prevent image from being deleted |
--unprotected | Allow image to be deleted (default) |
--public | Image is accessible to the public |
--private | Image is inaccessible to the public (default) |
--community | Image is accessible to the community |
--shared | Image can be shared |
--property <key=value> | Set a property on this image (repeat option to set multiple properties) |
--tag <tag> | Set a tag on this image (repeat option to set multiple tags) |
--project <project> | Set an alternate project on this image (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
42.3. image delete
Delete image(s)
Usage:
openstack image delete [-h] <image> [<image> ...]
openstack image delete [-h] <image> [<image> ...]
Value | Summary |
---|---|
<image> | Image(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
42.4. image list
List available images
Usage:
openstack image 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] [--public | --private | --community | --shared] [--property <key=value>] [--name <name>] [--status <status>] [--member-status <member-status>] [--tag <tag>] [--long] [--sort <key>[:<direction>]] [--limit <num-images>] [--marker <image>]
openstack image 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]
[--public | --private | --community | --shared]
[--property <key=value>] [--name <name>]
[--status <status>]
[--member-status <member-status>] [--tag <tag>]
[--long] [--sort <key>[:<direction>]]
[--limit <num-images>] [--marker <image>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--public | List only public images |
--private | List only private images |
--community | List only community images |
--shared | List only shared images |
--property <key=value> | Filter output based on property (repeat option to filter on multiple properties) |
--name <name> | Filter images based on name. |
--status <status> | Filter images based on status. |
--member-status <member-status> | Filter images based on member status. the supported options are: accepted, pending, rejected, all. |
--tag <tag> | Filter images based on tag. |
--long | List additional fields in output |
--sort <key>[:<direction>] | Sort output by selected keys and directions(asc or desc) (default: name:asc), multiple keys and directions can be specified separated by comma |
--limit <num-images> | Maximum number of images to display. |
--marker <image> | The last image of the previous page. display list of images after marker. Display all images if not specified. (name or ID) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
42.5. image member list
List projects associated with image
Usage:
openstack image member 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] [--project-domain <project-domain>] <image>
openstack image member 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]
[--project-domain <project-domain>]
<image>
Value | Summary |
---|---|
<image> | Image (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
42.6. image remove project
Disassociate project with image
Usage:
openstack image remove project [-h] [--project-domain <project-domain>] <image> <project>
openstack image remove project [-h] [--project-domain <project-domain>]
<image> <project>
Value | Summary |
---|---|
<image> | Image to unshare (name or id) |
<project> | Project to disassociate with image (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
42.7. image save
Save an image locally
Usage:
openstack image save [-h] [--file <filename>] <image>
openstack image save [-h] [--file <filename>] <image>
Value | Summary |
---|---|
<image> | Image to save (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--file <filename> | Downloaded image save filename (default: stdout) |
42.8. image set
Set image properties
Usage:
openstack image set [-h] [--name <name>] [--min-disk <disk-gb>] [--min-ram <ram-mb>] [--container-format <container-format>] [--disk-format <disk-format>] [--protected | --unprotected] [--public | --private | --community | --shared] [--property <key=value>] [--tag <tag>] [--architecture <architecture>] [--instance-id <instance-id>] [--kernel-id <kernel-id>] [--os-distro <os-distro>] [--os-version <os-version>] [--ramdisk-id <ramdisk-id>] [--deactivate | --activate] [--project <project>] [--project-domain <project-domain>] [--accept | --reject | --pending] <image>
openstack image set [-h] [--name <name>] [--min-disk <disk-gb>]
[--min-ram <ram-mb>]
[--container-format <container-format>]
[--disk-format <disk-format>]
[--protected | --unprotected]
[--public | --private | --community | --shared]
[--property <key=value>] [--tag <tag>]
[--architecture <architecture>]
[--instance-id <instance-id>]
[--kernel-id <kernel-id>] [--os-distro <os-distro>]
[--os-version <os-version>]
[--ramdisk-id <ramdisk-id>]
[--deactivate | --activate] [--project <project>]
[--project-domain <project-domain>]
[--accept | --reject | --pending]
<image>
Value | Summary |
---|---|
<image> | Image to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New image name |
--min-disk <disk-gb> | Minimum disk size needed to boot image, in gigabytes |
--min-ram <ram-mb> | Minimum ram size needed to boot image, in megabytes |
--container-format <container-format> | Image container format. the supported options are: ami, ari, aki, bare, docker, ova, ovf |
--disk-format <disk-format> | Image disk format. the supported options are: ami, ari, aki, vhd, vmdk, raw, qcow2, vhdx, vdi, iso, ploop |
--protected | Prevent image from being deleted |
--unprotected | Allow image to be deleted (default) |
--public | Image is accessible to the public |
--private | Image is inaccessible to the public (default) |
--community | Image is accessible to the community |
--shared | Image can be shared |
--property <key=value> | Set a property on this image (repeat option to set multiple properties) |
--tag <tag> | Set a tag on this image (repeat option to set multiple tags) |
--architecture <architecture> | Operating system architecture |
--instance-id <instance-id> | Id of server instance used to create this image |
--kernel-id <kernel-id> | Id of kernel image used to boot this disk image |
--os-distro <os-distro> | Operating system distribution name |
--os-version <os-version> | Operating system distribution version |
--ramdisk-id <ramdisk-id> | Id of ramdisk image used to boot this disk image |
--deactivate | Deactivate the image |
--activate | Activate the image |
--project <project> | Set an alternate project on this image (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--accept | Accept the image membership |
--reject | Reject the image membership |
--pending | Reset the image membership to pending |
42.9. image show
Display image details
Usage:
openstack image show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--human-readable] <image>
openstack image show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--human-readable]
<image>
Value | Summary |
---|---|
<image> | Image to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--human-readable | Print image size in a human-friendly format. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
42.10. image unset
Unset image tags and properties
Usage:
openstack image unset [-h] [--tag <tag>] [--property <property-key>] <image>
openstack image unset [-h] [--tag <tag>] [--property <property-key>]
<image>
Value | Summary |
---|---|
<image> | Image to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--tag <tag> | Unset a tag on this image (repeat option to unset multiple tags) |
--property <property-key> | Unset a property on this image (repeat option to unset multiple properties) |
Chapter 43. implied
This chapter describes the commands under the implied
command.
43.1. implied role create
Creates an association between prior and implied roles
Usage:
openstack implied role create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --implied-role <role> <role>
openstack implied role create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
--implied-role <role>
<role>
Value | Summary |
---|---|
<role> | Role (name or id) that implies another role |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--implied-role <role> | <role> (name or id) implied by another role |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
43.2. implied role delete
Deletes an association between prior and implied roles
Usage:
openstack implied role delete [-h] --implied-role <role> <role>
openstack implied role delete [-h] --implied-role <role> <role>
Value | Summary |
---|---|
<role> | Role (name or id) that implies another role |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--implied-role <role> | <role> (name or id) implied by another role |
43.3. implied role list
List implied roles
Usage:
openstack implied role 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]
openstack implied role 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 44. ip
This chapter describes the commands under the ip
command.
44.1. ip availability list
List IP availability for network
Usage:
openstack ip availability 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] [--ip-version <ip-version>] [--project <project>] [--project-domain <project-domain>]
openstack ip availability 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]
[--ip-version <ip-version>]
[--project <project>]
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--ip-version <ip-version> | List ip availability of given ip version networks (default is 4) |
--project <project> | List ip availability of given project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
44.2. ip availability show
Show network IP availability details
Usage:
openstack ip availability show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network>
openstack ip availability show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<network>
Value | Summary |
---|---|
<network> | Show ip availability for a specific network (name or ID) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 45. keypair
This chapter describes the commands under the keypair
command.
45.1. keypair create
Create new public or private key for server ssh access
Usage:
openstack keypair create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--public-key <file> | --private-key <file>] <name>
openstack keypair create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--public-key <file> | --private-key <file>]
<name>
Value | Summary |
---|---|
<name> | New public or private key name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--public-key <file> | Filename for public key to add. if not used, creates a private key. |
--private-key <file> | Filename for private key to save. if not used, print private key in console. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
45.2. keypair delete
Delete public or private key(s)
Usage:
openstack keypair delete [-h] <key> [<key> ...]
openstack keypair delete [-h] <key> [<key> ...]
Value | Summary |
---|---|
<key> | Name of key(s) to delete (name only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
45.3. keypair list
List key fingerprints
Usage:
openstack keypair 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]
openstack keypair 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
45.4. keypair show
Display key details
Usage:
openstack keypair show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--public-key] <key>
openstack keypair show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--public-key]
<key>
Value | Summary |
---|---|
<key> | Public or private key to display (name only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--public-key | Show only bare public key paired with the generated key |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 46. l2gw
This chapter describes the commands under the l2gw
command.
46.1. l2gw connection create
Create l2gateway-connection
Usage:
openstack l2gw connection create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--default-segmentation-id SEG_ID] <GATEWAY-NAME/UUID> <NETWORK-NAME/UUID>
openstack l2gw connection create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--default-segmentation-id SEG_ID]
<GATEWAY-NAME/UUID>
<NETWORK-NAME/UUID>
Value | Summary |
---|---|
<GATEWAY-NAME/UUID> | Descriptive name for logical gateway. |
<NETWORK-NAME/UUID> | Network name or uuid. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--default-segmentation-id SEG_ID | Default segmentation-id that will be applied to the interfaces for which segmentation id was not specified in l2-gateway-create command. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
46.2. l2gw connection delete
Delete a given l2gateway-connection
Usage:
openstack l2gw connection delete [-h] <L2_GATEWAY_CONNECTIONS> [<L2_GATEWAY_CONNECTIONS> ...]
openstack l2gw connection delete [-h]
<L2_GATEWAY_CONNECTIONS>
[<L2_GATEWAY_CONNECTIONS> ...]
Value | Summary |
---|---|
<L2_GATEWAY_CONNECTIONS> | Id(s) of l2_gateway_connections(s) to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
46.3. l2gw connection list
List l2gateway-connections
Usage:
openstack l2gw connection 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] [--project <project>] [--project-domain <project-domain>]
openstack l2gw connection 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]
[--project <project>]
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
46.4. l2gw connection show
Show information of a given l2gateway-connection
Usage:
openstack l2gw connection show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <L2_GATEWAY_CONNECTION>
openstack l2gw connection show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<L2_GATEWAY_CONNECTION>
Value | Summary |
---|---|
<L2_GATEWAY_CONNECTION> | Id of l2_gateway_connection to look up. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
46.5. l2gw create
Create l2gateway resource
Usage:
openstack l2gw create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--device name=name,interface_names=INTERFACE-DETAILS] <GATEWAY-NAME>
openstack l2gw create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--project <project>]
[--project-domain <project-domain>]
[--device name=name,interface_names=INTERFACE-DETAILS]
<GATEWAY-NAME>
Value | Summary |
---|---|
<GATEWAY-NAME> | Descriptive name for logical gateway. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--device name=name,interface_names=INTERFACE-DETAILS | Device name and interface-names of l2gateway. INTERFACE-DETAILS is of form "<interface_name1>;[<inte rface_name2>][ |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
46.6. l2gw delete
Delete a given l2gateway
Usage:
openstack l2gw delete [-h] <L2_GATEWAY> [<L2_GATEWAY> ...]
openstack l2gw delete [-h] <L2_GATEWAY> [<L2_GATEWAY> ...]
Value | Summary |
---|---|
<L2_GATEWAY> | Id(s) or name(s) of l2_gateway to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
46.7. l2gw list
List l2gateway that belongs to a given tenant
Usage:
openstack l2gw 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] [--project <project>] [--project-domain <project-domain>]
openstack l2gw 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]
[--project <project>]
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
46.8. l2gw show
Show information of a given l2gateway
Usage:
openstack l2gw show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <L2_GATEWAY>
openstack l2gw show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<L2_GATEWAY>
Value | Summary |
---|---|
<L2_GATEWAY> | Id or name of l2_gateway to look up. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
46.9. l2gw update
Update a given l2gateway
Usage:
openstack l2gw update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name name] [--device name=name,interface_names=INTERFACE-DETAILS] <L2_GATEWAY>
openstack l2gw update [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--name name]
[--device name=name,interface_names=INTERFACE-DETAILS]
<L2_GATEWAY>
Value | Summary |
---|---|
<L2_GATEWAY> | Id or name of l2_gateway to update. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name name | Descriptive name for logical gateway. |
--device name=name,interface_names=INTERFACE-DETAILS | Device name and interface-names of l2gateway. INTERFACE-DETAILS is of form "<interface_name1>;[<inte rface_name2>][ |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 47. limit
This chapter describes the commands under the limit
command.
47.1. limit create
Create a limit
Usage:
openstack limit create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--region <region>] --project <project> --service <service> --resource-limit <resource-limit> <resource-name>
openstack limit create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--description <description>]
[--region <region>] --project <project>
--service <service> --resource-limit
<resource-limit>
<resource-name>
Value | Summary |
---|---|
<resource-name> | The name of the resource to limit |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of the limit |
--region <region> | Region for the limit to affect. |
--project <project> | Project to associate the resource limit to |
--service <service> | Service responsible for the resource to limit |
--resource-limit <resource-limit> | The resource limit for the project to assume |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
47.2. limit delete
Delete a limit
Usage:
openstack limit delete [-h] <limit-id> [<limit-id> ...]
openstack limit delete [-h] <limit-id> [<limit-id> ...]
Value | Summary |
---|---|
<limit-id> | Limit to delete (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
47.3. limit list
List limits
Usage:
openstack limit 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] [--service <service>] [--resource-name <resource-name>] [--region <region>] [--project <project>]
openstack limit 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]
[--service <service>]
[--resource-name <resource-name>]
[--region <region>] [--project <project>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--service <service> | Service responsible for the resource to limit |
--resource-name <resource-name> | The name of the resource to limit |
--region <region> | Region for the registered limit to affect. |
--project <project> | List resource limits associated with project |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
47.4. limit set
Update information about a limit
Usage:
openstack limit set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--resource-limit <resource-limit>] <limit-id>
openstack limit set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--description <description>]
[--resource-limit <resource-limit>]
<limit-id>
Value | Summary |
---|---|
<limit-id> | Limit to update (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of the limit |
--resource-limit <resource-limit> | The resource limit for the project to assume |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
47.5. limit show
Display limit details
Usage:
openstack limit show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <limit-id>
openstack limit show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<limit-id>
Value | Summary |
---|---|
<limit-id> | Limit to display (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 48. limits
This chapter describes the commands under the limits
command.
48.1. limits show
Show compute and block storage limits
Usage:
openstack limits 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] (--absolute | --rate) [--reserved] [--project <project>] [--domain <domain>]
openstack limits 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] (--absolute | --rate)
[--reserved] [--project <project>]
[--domain <domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--absolute | Show absolute limits |
--rate | Show rate limits |
--reserved | Include reservations count [only valid with --absolute] |
--project <project> | Show limits for a specific project (name or id) [only valid with --absolute] |
--domain <domain> | Domain the project belongs to (name or id) [only valid with --absolute] |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 49. loadbalancer
This chapter describes the commands under the loadbalancer
command.
49.1. loadbalancer amphora configure
Update the amphora agent configuration
Usage:
openstack loadbalancer amphora configure [-h] <amphora-id>
openstack loadbalancer amphora configure [-h] <amphora-id>
Value | Summary |
---|---|
<amphora-id> | Uuid of the amphora to configure. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.2. loadbalancer amphora failover
Force failover an amphora
Usage:
openstack loadbalancer amphora failover [-h] <amphora-id>
openstack loadbalancer amphora failover [-h] <amphora-id>
Value | Summary |
---|---|
<amphora-id> | Uuid of the amphora. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.3. loadbalancer amphora list
List amphorae
Usage:
openstack loadbalancer amphora 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] [--loadbalancer <loadbalancer>] [--compute-id <compute-id>] [--role {BACKUP,MASTER,STANDALONE}] [--status {ALLOCATED,BOOTING,DELETED,ERROR,PENDING_CREATE,PENDING_DELETE,READY}]
openstack loadbalancer amphora 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]
[--loadbalancer <loadbalancer>]
[--compute-id <compute-id>]
[--role {BACKUP,MASTER,STANDALONE}]
[--status {ALLOCATED,BOOTING,DELETED,ERROR,PENDING_CREATE,PENDING_DELETE,READY}]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--loadbalancer <loadbalancer> | Filter by load balancer (name or id). |
--compute-id <compute-id> | Filter by compute id. |
--role {BACKUP,MASTER,STANDALONE} | Filter by role. |
--status {ALLOCATED,BOOTING,DELETED,ERROR,PENDING_CREATE,PENDING_DELETE,READY}, --provisioning-status {ALLOCATED,BOOTING,DELETED,ERROR,PENDING_CREATE,PENDING_DELETE,READY} | Filter by amphora provisioning status. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.4. loadbalancer amphora show
Show the details of a single amphora
Usage:
openstack loadbalancer amphora show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <amphora-id>
openstack loadbalancer amphora show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<amphora-id>
Value | Summary |
---|---|
<amphora-id> | Uuid of the amphora. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.5. loadbalancer create
Create a load balancer
Usage:
openstack loadbalancer create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] [--description <description>] [--vip-address <vip_address>] [--vip-port-id <vip_port_id>] [--vip-subnet-id <vip_subnet_id>] [--vip-network-id <vip_network_id>] [--vip-qos-policy-id <vip_qos_policy_id>] [--project <project>] [--provider <provider>] [--enable | --disable] [--flavor <flavor>]
openstack loadbalancer create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
[--name <name>]
[--description <description>]
[--vip-address <vip_address>]
[--vip-port-id <vip_port_id>]
[--vip-subnet-id <vip_subnet_id>]
[--vip-network-id <vip_network_id>]
[--vip-qos-policy-id <vip_qos_policy_id>]
[--project <project>]
[--provider <provider>]
[--enable | --disable]
[--flavor <flavor>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New load balancer name. |
--description <description> | Set load balancer description. |
--vip-address <vip_address> | Set the vip ip address. |
--vip-qos-policy-id <vip_qos_policy_id> | Set qos policy id for vip port. unset with none. |
--project <project> | Project for the load balancer (name or id). |
--provider <provider> | Provider name for the load balancer. |
--enable | Enable load balancer (default). |
--disable | Disable load balancer. |
--flavor <flavor> | The name or id of the flavor for the load balancer. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Value | Summary |
---|---|
At least one of the following arguments is required.--vip-port-id <vip_port_id> | Set port for the load balancer (name or id). |
--vip-subnet-id <vip_subnet_id> | Set subnet for the load balancer (name or id). |
--vip-network-id <vip_network_id> | Set network for the load balancer (name or id). |
49.6. loadbalancer delete
Delete a load balancer
Usage:
openstack loadbalancer delete [-h] [--cascade] <load_balancer>
openstack loadbalancer delete [-h] [--cascade] <load_balancer>
Value | Summary |
---|---|
<load_balancer> | Load balancers to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--cascade | Cascade the delete to all child elements of the load balancer. |
49.7. loadbalancer failover
Trigger load balancer failover
Usage:
openstack loadbalancer failover [-h] <load_balancer>
openstack loadbalancer failover [-h] <load_balancer>
Value | Summary |
---|---|
<load_balancer> | Name or uuid of the load balancer. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.8. loadbalancer flavor create
Create a octavia flavor
Usage:
openstack loadbalancer flavor create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --name <name> --flavorprofile <flavor_profile> [--description <description>] [--enable | --disable]
openstack loadbalancer flavor create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--name <name> --flavorprofile
<flavor_profile>
[--description <description>]
[--enable | --disable]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New flavor name. |
--flavorprofile <flavor_profile> | Flavor profile to add the flavor to (name or id). |
--description <description> | Set flavor description. |
--enable | Enable flavor. |
--disable | Disable flavor. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.9. loadbalancer flavor delete
Delete a flavor
Usage:
openstack loadbalancer flavor delete [-h] <flavor>
openstack loadbalancer flavor delete [-h] <flavor>
Value | Summary |
---|---|
<flavor> | Flavor to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.10. loadbalancer flavor list
List flavor
Usage:
openstack loadbalancer flavor 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>] [--flavorprofile <flavor_profile>] [--enable | --disable]
openstack loadbalancer flavor 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>]
[--flavorprofile <flavor_profile>]
[--enable | --disable]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | List flavors according to their name. |
--flavorprofile <flavor_profile> | List flavors according to their flavor profile. |
--enable | List enabled flavors. |
--disable | List disabled flavors. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.11. loadbalancer flavor set
Update a flavor
Usage:
openstack loadbalancer flavor set [-h] [--name <name>] [--enable | --disable] <flavor>
openstack loadbalancer flavor set [-h] [--name <name>]
[--enable | --disable]
<flavor>
Value | Summary |
---|---|
<flavor> | Name or uuid of the flavor to update. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the name of the flavor. |
--enable | Enable flavor. |
--disable | Disable flavor. |
49.12. loadbalancer flavor show
Show the details for a single flavor
Usage:
openstack loadbalancer flavor show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <flavor>
openstack loadbalancer flavor show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<flavor>
Value | Summary |
---|---|
<flavor> | Name or uuid of the flavor. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.13. loadbalancer flavorprofile create
Create a octavia flavor profile
Usage:
openstack loadbalancer flavorprofile create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --name <name> --provider <provider name> --flavor-data <flavor_data>
openstack loadbalancer flavorprofile create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty] --name
<name> --provider <provider
name> --flavor-data
<flavor_data>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | New octavia flavor profile name. |
--provider <provider name> | Provider name for the flavor profile. |
--flavor-data <flavor_data> | The json string containing the flavor metadata. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.14. loadbalancer flavorprofile delete
Delete a flavor profile
Usage:
openstack loadbalancer flavorprofile delete [-h] <flavor_profile>
openstack loadbalancer flavorprofile delete [-h] <flavor_profile>
Value | Summary |
---|---|
<flavor_profile> | Flavor profiles to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.15. loadbalancer flavorprofile list
List flavor profile
Usage:
openstack loadbalancer flavorprofile 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>] [--provider <provider_name>]
openstack loadbalancer flavorprofile 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>]
[--provider <provider_name>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | List flavor profiles by flavor profile name. |
--provider <provider_name> | List flavor profiles according to their provider. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.16. loadbalancer flavorprofile set
Update a flavor profile
Usage:
openstack loadbalancer flavorprofile set [-h] [--name <name>] [--provider <provider_name>] [--flavor-data <flavor_data>] <flavor_profile>
openstack loadbalancer flavorprofile set [-h] [--name <name>]
[--provider <provider_name>]
[--flavor-data <flavor_data>]
<flavor_profile>
Value | Summary |
---|---|
<flavor_profile> | Name or uuid of the flavor profile to update. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the name of the flavor profile. |
--provider <provider_name> | Set the provider of the flavor profile. |
--flavor-data <flavor_data> | Set the flavor data of the flavor profile. |
49.17. loadbalancer flavorprofile show
Show the details for a single flavor profile
Usage:
openstack loadbalancer flavorprofile show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <flavor_profile>
openstack loadbalancer flavorprofile show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<flavor_profile>
Value | Summary |
---|---|
<flavor_profile> | Name or uuid of the flavor profile to show. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.18. loadbalancer healthmonitor create
Create a health monitor
Usage:
openstack loadbalancer healthmonitor create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] --delay <delay> [--domain-name <domain_name>] [--expected-codes <codes>] [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}] [--http-version <http_version>] --timeout <timeout> --max-retries <max_retries> [--url-path <url_path>] --type {PING,HTTP,TCP,HTTPS,TLS-HELLO,UDP-CONNECT} [--max-retries-down <max_retries_down>] [--enable | --disable] <pool>
openstack loadbalancer healthmonitor create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--name <name>] --delay
<delay>
[--domain-name <domain_name>]
[--expected-codes <codes>]
[--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
[--http-version <http_version>]
--timeout <timeout>
--max-retries <max_retries>
[--url-path <url_path>]
--type
{PING,HTTP,TCP,HTTPS,TLS-HELLO,UDP-CONNECT}
[--max-retries-down <max_retries_down>]
[--enable | --disable]
<pool>
Value | Summary |
---|---|
<pool> | Set the pool for the health monitor (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the health monitor name. |
--delay <delay> | Set the time in seconds, between sending probes to members. |
--domain-name <domain_name> | Set the domain name, which be injected into the http Host Header to the backend server for HTTP health check. |
--expected-codes <codes> | Set the list of http status codes expected in response from the member to declare it healthy. |
--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE} | Set the http method that the health monitor uses for requests. |
--http-version <http_version> | Set the http version. |
--timeout <timeout> | Set the maximum time, in seconds, that a monitor waits to connect before it times out. This value must be less than the delay value. |
--max-retries <max_retries> | The number of successful checks before changing the operating status of the member to ONLINE. |
--url-path <url_path> | Set the http url path of the request sent by the monitor to test the health of a backend member. |
--type {PING,HTTP,TCP,HTTPS,TLS-HELLO,UDP-CONNECT} | Set the health monitor type. |
--max-retries-down <max_retries_down> | Set the number of allowed check failures before changing the operating status of the member to ERROR. |
--enable | Enable health monitor (default). |
--disable | Disable health monitor. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.19. loadbalancer healthmonitor delete
Delete a health monitor
Usage:
openstack loadbalancer healthmonitor delete [-h] <health_monitor>
openstack loadbalancer healthmonitor delete [-h] <health_monitor>
Value | Summary |
---|---|
<health_monitor> | Health monitor to delete (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.20. loadbalancer healthmonitor list
List health monitors
Usage:
openstack loadbalancer healthmonitor 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]
openstack loadbalancer healthmonitor 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.21. loadbalancer healthmonitor set
Update a health monitor
Usage:
openstack loadbalancer healthmonitor set [-h] [--name <name>] [--delay <delay>] [--domain-name <domain_name>] [--expected-codes <codes>] [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}] [--http-version <http_version>] [--timeout <timeout>] [--max-retries <max_retries>] [--max-retries-down <max_retries_down>] [--url-path <url_path>] [--enable | --disable] <health_monitor>
openstack loadbalancer healthmonitor set [-h] [--name <name>]
[--delay <delay>]
[--domain-name <domain_name>]
[--expected-codes <codes>]
[--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
[--http-version <http_version>]
[--timeout <timeout>]
[--max-retries <max_retries>]
[--max-retries-down <max_retries_down>]
[--url-path <url_path>]
[--enable | --disable]
<health_monitor>
Value | Summary |
---|---|
<health_monitor> | Health monitor to update (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set health monitor name. |
--delay <delay> | Set the time in seconds, between sending probes to members. |
--domain-name <domain_name> | Set the domain name, which be injected into the http Host Header to the backend server for HTTP health check. |
--expected-codes <codes> | Set the list of http status codes expected in response from the member to declare it healthy. |
--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE} | Set the http method that the health monitor uses for requests. |
--http-version <http_version> | Set the http version. |
--timeout <timeout> | Set the maximum time, in seconds, that a monitor waits to connect before it times out. This value must be less than the delay value. |
--max-retries <max_retries> | Set the number of successful checks before changing the operating status of the member to ONLINE. |
--max-retries-down <max_retries_down> | Set the number of allowed check failures before changing the operating status of the member to ERROR. |
--url-path <url_path> | Set the http url path of the request sent by the monitor to test the health of a backend member. |
--enable | Enable health monitor. |
--disable | Disable health monitor. |
49.22. loadbalancer healthmonitor show
Show the details of a single health monitor
Usage:
openstack loadbalancer healthmonitor show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <health_monitor>
openstack loadbalancer healthmonitor show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<health_monitor>
Value | Summary |
---|---|
<health_monitor> | Name or uuid of the health monitor. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.23. loadbalancer l7policy create
Create a l7policy
Usage:
openstack loadbalancer l7policy create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] [--description <description>] --action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT} [--redirect-pool <pool> | --redirect-url <url> | --redirect-prefix <url>] [--redirect-http-code <redirect_http_code>] [--position <position>] [--enable | --disable] <listener>
openstack loadbalancer l7policy create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--name <name>]
[--description <description>]
--action
{REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT}
[--redirect-pool <pool> | --redirect-url <url> | --redirect-prefix <url>]
[--redirect-http-code <redirect_http_code>]
[--position <position>]
[--enable | --disable]
<listener>
Value | Summary |
---|---|
<listener> | Listener to add l7policy to (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the l7policy name. |
--description <description> | Set l7policy description. |
--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT} | Set the action of the policy. |
--redirect-pool <pool> | Set the pool to redirect requests to (name or id). |
--redirect-url <url> | Set the url to redirect requests to. |
--redirect-prefix <url> | Set the url prefix to redirect requests to. |
--redirect-http-code <redirect_http_code> | Set the http response code for redirect_url orREDIRECT_PREFIX action. |
--position <position> | Sequence number of this l7 policy. |
--enable | Enable l7policy (default). |
--disable | Disable l7policy. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.24. loadbalancer l7policy delete
Delete a l7policy
Usage:
openstack loadbalancer l7policy delete [-h] <policy>
openstack loadbalancer l7policy delete [-h] <policy>
Value | Summary |
---|---|
<policy> | L7policy to delete (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.25. loadbalancer l7policy list
List l7policies
Usage:
openstack loadbalancer l7policy 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]
openstack loadbalancer l7policy 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.26. loadbalancer l7policy set
Update a l7policy
Usage:
openstack loadbalancer l7policy set [-h] [--name <name>] [--description <description>] [--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT}] [--redirect-pool <pool> | --redirect-url <url> | --redirect-prefix <url>] [--redirect-http-code <redirect_http_code>] [--position <position>] [--enable | --disable] <policy>
openstack loadbalancer l7policy set [-h] [--name <name>]
[--description <description>]
[--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT}]
[--redirect-pool <pool> | --redirect-url <url> | --redirect-prefix <url>]
[--redirect-http-code <redirect_http_code>]
[--position <position>]
[--enable | --disable]
<policy>
Value | Summary |
---|---|
<policy> | L7policy to update (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set l7policy name. |
--description <description> | Set l7policy description. |
--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT} | Set the action of the policy. |
--redirect-pool <pool> | Set the pool to redirect requests to (name or id). |
--redirect-url <url> | Set the url to redirect requests to. |
--redirect-prefix <url> | Set the url prefix to redirect requests to. |
--redirect-http-code <redirect_http_code> | Set the http response code for redirect_url orREDIRECT_PREFIX action. |
--position <position> | Set sequence number of this l7 policy. |
--enable | Enable l7policy. |
--disable | Disable l7policy. |
49.27. loadbalancer l7policy show
Show the details of a single l7policy
Usage:
openstack loadbalancer l7policy show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <policy>
openstack loadbalancer l7policy show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<policy>
Value | Summary |
---|---|
<policy> | Name or uuid of the l7policy. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.28. loadbalancer l7rule create
Create a l7rule
Usage:
openstack loadbalancer l7rule create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH} [--invert] --value <value> [--key <key>] --type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD} [--enable | --disable] <l7policy>
openstack loadbalancer l7rule create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
--compare-type
{REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}
[--invert] --value <value>
[--key <key>] --type
{FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}
[--enable | --disable]
<l7policy>
Value | Summary |
---|---|
<l7policy> | L7policy to add l7rule to (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH} | Set the compare type for the l7rule. |
--invert | Invert l7rule. |
--value <value> | Set the rule value to match on. |
--key <key> | Set the key for the l7rule’s value to match on. |
--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD} | Set the type for the l7rule. |
--enable | Enable l7rule (default). |
--disable | Disable l7rule. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.29. loadbalancer l7rule delete
Delete a l7rule
Usage:
openstack loadbalancer l7rule delete [-h] <l7policy> <rule_id>
openstack loadbalancer l7rule delete [-h] <l7policy> <rule_id>
Value | Summary |
---|---|
<l7policy> | L7policy to delete rule from (name or id). |
<rule_id> | L7rule to delete. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.30. loadbalancer l7rule list
List l7rules for l7policy
Usage:
openstack loadbalancer l7rule 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] <l7policy>
openstack loadbalancer l7rule 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]
<l7policy>
Value | Summary |
---|---|
<l7policy> | L7policy to list rules for (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.31. loadbalancer l7rule set
Update a l7rule
Usage:
openstack loadbalancer l7rule set [-h] [--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}] [--invert] [--value <value>] [--key <key>] [--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}] [--enable | --disable] <l7policy> <l7rule_id>
openstack loadbalancer l7rule set [-h]
[--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}]
[--invert] [--value <value>]
[--key <key>]
[--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}]
[--enable | --disable]
<l7policy> <l7rule_id>
Value | Summary |
---|---|
<l7policy> | L7policy to update l7rule on (name or id). |
<l7rule_id> | L7rule to update. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH} | Set the compare type for the l7rule. |
--invert | Invert l7rule. |
--value <value> | Set the rule value to match on. |
--key <key> | Set the key for the l7rule’s value to match on. |
--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD} | Set the type for the l7rule. |
--enable | Enable l7rule. |
--disable | Disable l7rule. |
49.32. loadbalancer l7rule show
Show the details of a single l7rule
Usage:
openstack loadbalancer l7rule show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <l7policy> <l7rule_id>
openstack loadbalancer l7rule show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<l7policy> <l7rule_id>
Value | Summary |
---|---|
<l7policy> | L7policy to show rule from (name or id). |
<l7rule_id> | L7rule to show. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.33. loadbalancer list
List load balancers
Usage:
openstack loadbalancer 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>] [--enable | --disable] [--project <project-id>] [--vip-network-id <vip_network_id>] [--vip-subnet-id <vip_subnet_id>] [--vip-qos-policy-id <vip_qos_policy_id>] [--vip-port-id <vip_port_id>] [--provisioning-status {ACTIVE,DELETED,ERROR,PENDING_CREATE,PENDING_UPDATE,PENDING_DELETE}] [--operating-status {ONLINE,DRAINING,OFFLINE,DEGRADED,ERROR,NO_MONITOR}] [--provider <provider>] [--flavor <flavor>]
openstack loadbalancer 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>]
[--enable | --disable]
[--project <project-id>]
[--vip-network-id <vip_network_id>]
[--vip-subnet-id <vip_subnet_id>]
[--vip-qos-policy-id <vip_qos_policy_id>]
[--vip-port-id <vip_port_id>]
[--provisioning-status {ACTIVE,DELETED,ERROR,PENDING_CREATE,PENDING_UPDATE,PENDING_DELETE}]
[--operating-status {ONLINE,DRAINING,OFFLINE,DEGRADED,ERROR,NO_MONITOR}]
[--provider <provider>] [--flavor <flavor>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | List load balancers according to their name. |
--enable | List enabled load balancers. |
--disable | List disabled load balancers. |
--project <project-id> | List load balancers according to their project (name or ID). |
--vip-network-id <vip_network_id> | List load balancers according to their vip network (name or ID). |
--vip-subnet-id <vip_subnet_id> | List load balancers according to their vip subnet (name or ID). |
--vip-qos-policy-id <vip_qos_policy_id> | List load balancers according to their vip qos policy (name or ID). |
--vip-port-id <vip_port_id> | List load balancers according to their vip port (name or ID). |
--provisioning-status {ACTIVE,DELETED,ERROR,PENDING_CREATE,PENDING_UPDATE,PENDING_DELETE} | List load balancers according to their provisioning status. |
--operating-status {ONLINE,DRAINING,OFFLINE,DEGRADED,ERROR,NO_MONITOR} | List load balancers according to their operating status. |
--provider <provider> | List load balancers according to their provider. |
--flavor <flavor> | List load balancers according to their flavor. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.34. loadbalancer listener create
Create a listener
Usage:
openstack loadbalancer listener create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] [--description <description>] --protocol {TCP,HTTP,HTTPS,TERMINATED_HTTPS,UDP} [--connection-limit <limit>] [--default-pool <pool>] [--default-tls-container-ref <container_ref>] [--sni-container-refs [<container_ref> [<container_ref> ...]]] [--insert-headers <header=value,...>] --protocol-port <port> [--timeout-client-data <timeout>] [--timeout-member-connect <timeout>] [--timeout-member-data <timeout>] [--timeout-tcp-inspect <timeout>] [--enable | --disable] [--client-ca-tls-container-ref <container_ref>] [--client-authentication {NONE,OPTIONAL,MANDATORY}] [--client-crl-container-ref <client_crl_container_ref>] <loadbalancer>
openstack loadbalancer listener create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--name <name>]
[--description <description>]
--protocol
{TCP,HTTP,HTTPS,TERMINATED_HTTPS,UDP}
[--connection-limit <limit>]
[--default-pool <pool>]
[--default-tls-container-ref <container_ref>]
[--sni-container-refs [<container_ref> [<container_ref> ...]]]
[--insert-headers <header=value,...>]
--protocol-port <port>
[--timeout-client-data <timeout>]
[--timeout-member-connect <timeout>]
[--timeout-member-data <timeout>]
[--timeout-tcp-inspect <timeout>]
[--enable | --disable]
[--client-ca-tls-container-ref <container_ref>]
[--client-authentication {NONE,OPTIONAL,MANDATORY}]
[--client-crl-container-ref <client_crl_container_ref>]
<loadbalancer>
Value | Summary |
---|---|
<loadbalancer> | Load balancer for the listener (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the listener name. |
--description <description> | Set the description of this listener. |
--protocol {TCP,HTTP,HTTPS,TERMINATED_HTTPS,UDP} | The protocol for the listener. |
--connection-limit <limit> | Set the maximum number of connections permitted for this listener. |
--default-pool <pool> | Set the name or id of the pool used by the listener if no L7 policies match. |
--default-tls-container-ref <container_ref> | The uri to the key manager service secrets container containing the certificate and key for TERMINATED_TLS listeners. |
--sni-container-refs [<container_ref> [<container_ref> …]] | A list of uris to the key manager service secrets containers containing the certificates and keys for TERMINATED_TLS the listener using Server Name Indication. |
--insert-headers <header=value,…> | A dictionary of optional headers to insert into the request before it is sent to the backend member. |
--protocol-port <port> | Set the protocol port number for the listener. |
--timeout-client-data <timeout> | Frontend client inactivity timeout in milliseconds. Default: 50000. |
--timeout-member-connect <timeout> | Backend member connection timeout in milliseconds. Default: 5000. |
--timeout-member-data <timeout> | Backend member inactivity timeout in milliseconds. Default: 50000. |
--timeout-tcp-inspect <timeout> | Time, in milliseconds, to wait for additional tcp packets for content inspection. Default: 0. |
--enable | Enable listener (default). |
--disable | Disable listener. |
--client-ca-tls-container-ref <container_ref> | The uri to the key manager service secrets container containing the CA certificate for TERMINATED_TLS listeners. |
--client-authentication {NONE,OPTIONAL,MANDATORY} | The tls client authentication verify options for TERMINATED_TLS listeners. |
--client-crl-container-ref <client_crl_container_ref> | The uri to the key manager service secrets container containting the CA revocation list file for TERMINATED_TLS listeners. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.35. loadbalancer listener delete
Delete a listener
Usage:
openstack loadbalancer listener delete [-h] <listener>
openstack loadbalancer listener delete [-h] <listener>
Value | Summary |
---|---|
<listener> | Listener to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.36. loadbalancer listener list
List listeners
Usage:
openstack loadbalancer listener 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>] [--loadbalancer <loadbalancer>] [--enable | --disable] [--project <project>]
openstack loadbalancer listener 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>]
[--loadbalancer <loadbalancer>]
[--enable | --disable]
[--project <project>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | List listeners by listener name. |
--loadbalancer <loadbalancer> | Filter by load balancer (name or id). |
--enable | List enabled listeners. |
--disable | List disabled listeners. |
--project <project> | List listeners by project id. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.37. loadbalancer listener set
Update a listener
Usage:
openstack loadbalancer listener set [-h] [--name <name>] [--description <description>] [--connection-limit <limit>] [--default-pool <pool>] [--default-tls-container-ref <container-ref>] [--sni-container-refs [<container-ref> [<container-ref> ...]]] [--insert-headers <header=value>] [--timeout-client-data <timeout>] [--timeout-member-connect <timeout>] [--timeout-member-data <timeout>] [--timeout-tcp-inspect <timeout>] [--enable | --disable] [--client-ca-tls-container-ref <container_ref>] [--client-authentication {NONE,OPTIONAL,MANDATORY}] [--client-crl-container-ref <client_crl_container_ref>] <listener>
openstack loadbalancer listener set [-h] [--name <name>]
[--description <description>]
[--connection-limit <limit>]
[--default-pool <pool>]
[--default-tls-container-ref <container-ref>]
[--sni-container-refs [<container-ref> [<container-ref> ...]]]
[--insert-headers <header=value>]
[--timeout-client-data <timeout>]
[--timeout-member-connect <timeout>]
[--timeout-member-data <timeout>]
[--timeout-tcp-inspect <timeout>]
[--enable | --disable]
[--client-ca-tls-container-ref <container_ref>]
[--client-authentication {NONE,OPTIONAL,MANDATORY}]
[--client-crl-container-ref <client_crl_container_ref>]
<listener>
Value | Summary |
---|---|
<listener> | Listener to modify (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the listener name. |
--description <description> | Set the description of this listener. |
--connection-limit <limit> | The maximum number of connections permitted for this listener. Default value is -1 which represents infinite connections. |
--default-pool <pool> | The id of the pool used by the listener if no l7 policies match. |
--default-tls-container-ref <container-ref> | The uri to the key manager service secrets container containing the certificate and key for TERMINATED_TLSlisteners. |
--sni-container-refs [<container-ref> [<container-ref> …]] | A list of uris to the key manager service secrets containers containing the certificates and keys for TERMINATED_TLS the listener using Server Name Indication. |
--insert-headers <header=value> | A dictionary of optional headers to insert into the request before it is sent to the backend member. |
--timeout-client-data <timeout> | Frontend client inactivity timeout in milliseconds. Default: 50000. |
--timeout-member-connect <timeout> | Backend member connection timeout in milliseconds. Default: 5000. |
--timeout-member-data <timeout> | Backend member inactivity timeout in milliseconds. Default: 50000. |
--timeout-tcp-inspect <timeout> | Time, in milliseconds, to wait for additional tcp packets for content inspection. Default: 0. |
--enable | Enable listener. |
--disable | Disable listener. |
--client-ca-tls-container-ref <container_ref> | The uri to the key manager service secrets container containing the CA certificate for TERMINATED_TLS listeners. |
--client-authentication {NONE,OPTIONAL,MANDATORY} | The tls client authentication verify options for TERMINATED_TLS listeners. |
--client-crl-container-ref <client_crl_container_ref> | The uri to the key manager service secrets container containting the CA revocation list file for TERMINATED_TLS listeners. |
49.38. loadbalancer listener show
Show the details of a single listener
Usage:
openstack loadbalancer listener show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <listener>
openstack loadbalancer listener show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<listener>
Value | Summary |
---|---|
<listener> | Name or uuid of the listener |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.39. loadbalancer listener stats show
Shows the current statistics for a listener.
Usage:
openstack loadbalancer listener stats show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <listener>
openstack loadbalancer listener stats show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
<listener>
Value | Summary |
---|---|
<listener> | Name or uuid of the listener |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.40. loadbalancer member create
Creating a member in a pool
Usage:
openstack loadbalancer member create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] [--disable-backup | --enable-backup] [--weight <weight>] --address <ip_address> [--subnet-id <subnet_id>] --protocol-port <protocol_port> [--monitor-port <monitor_port>] [--monitor-address <monitor_address>] [--enable | --disable] <pool>
openstack loadbalancer member create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--name <name>]
[--disable-backup | --enable-backup]
[--weight <weight>] --address
<ip_address>
[--subnet-id <subnet_id>]
--protocol-port <protocol_port>
[--monitor-port <monitor_port>]
[--monitor-address <monitor_address>]
[--enable | --disable]
<pool>
Value | Summary |
---|---|
<pool> | Id or name of the pool to create the member for. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Name of the member. |
--disable-backup | Disable member backup (default) |
--enable-backup | Enable member backup |
--weight <weight> | The weight of a member determines the portion of requests or connections it services compared to the other members of the pool. |
--address <ip_address> | The ip address of the backend member server |
--subnet-id <subnet_id> | The subnet id the member service is accessible from. |
--protocol-port <protocol_port> | The protocol port number the backend member server is listening on. |
--monitor-port <monitor_port> | An alternate protocol port used for health monitoring a backend member. |
--monitor-address <monitor_address> | An alternate ip address used for health monitoring a backend member. |
--enable | Enable member (default) |
--disable | Disable member |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.41. loadbalancer member delete
Delete a member from a pool
Usage:
openstack loadbalancer member delete [-h] <pool> <member>
openstack loadbalancer member delete [-h] <pool> <member>
Value | Summary |
---|---|
<pool> | Pool name or id to delete the member from. |
<member> | Name or id of the member to be deleted. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.42. loadbalancer member list
List members in a pool
Usage:
openstack loadbalancer member 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] <pool>
openstack loadbalancer member 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]
<pool>
Value | Summary |
---|---|
<pool> | Pool name or id to list the members of. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.43. loadbalancer member set
Update a member
Usage:
openstack loadbalancer member set [-h] [--name <name>] [--disable-backup | --enable-backup] [--weight <weight>] [--monitor-port <monitor_port>] [--monitor-address <monitor_address>] [--enable | --disable] <pool> <member>
openstack loadbalancer member set [-h] [--name <name>]
[--disable-backup | --enable-backup]
[--weight <weight>]
[--monitor-port <monitor_port>]
[--monitor-address <monitor_address>]
[--enable | --disable]
<pool> <member>
Value | Summary |
---|---|
<pool> | Pool that the member to update belongs to (name or ID). |
<member> | Name or id of the member to update |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the name of the member |
--disable-backup | Disable member backup (default) |
--enable-backup | Enable member backup |
--weight <weight> | Set the weight of member in the pool |
--monitor-port <monitor_port> | An alternate protocol port used for health monitoring a backend member |
--monitor-address <monitor_address> | An alternate ip address used for health monitoring a backend member. |
--enable | Set the admin_state_up to true |
--disable | Set the admin_state_up to false |
49.44. loadbalancer member show
Shows details of a single Member
Usage:
openstack loadbalancer member show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <pool> <member>
openstack loadbalancer member show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<pool> <member>
Value | Summary |
---|---|
<pool> | Pool name or id to show the members of. |
<member> | Name or id of the member to show. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.45. loadbalancer pool create
Create a pool
Usage:
openstack loadbalancer pool create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name <name>] [--description <description>] --protocol {TCP,HTTP,HTTPS,TERMINATED_HTTPS,PROXY,UDP} (--listener <listener> | --loadbalancer <load_balancer>) [--session-persistence <session persistence>] --lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS} [--enable | --disable] [--tls-container-ref <container-ref>] [--ca-tls-container-ref <ca_tls_container_ref>] [--crl-container-ref <crl_container_ref>] [--enable-tls | --disable-tls]
openstack loadbalancer pool create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--name <name>]
[--description <description>]
--protocol
{TCP,HTTP,HTTPS,TERMINATED_HTTPS,PROXY,UDP}
(--listener <listener> | --loadbalancer <load_balancer>)
[--session-persistence <session persistence>]
--lb-algorithm
{SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}
[--enable | --disable]
[--tls-container-ref <container-ref>]
[--ca-tls-container-ref <ca_tls_container_ref>]
[--crl-container-ref <crl_container_ref>]
[--enable-tls | --disable-tls]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set pool name. |
--description <description> | Set pool description. |
--protocol {TCP,HTTP,HTTPS,TERMINATED_HTTPS,PROXY,UDP} | Set the pool protocol. |
--listener <listener> | Listener to add the pool to (name or id). |
--loadbalancer <load_balancer> | Load balncer to add the pool to (name or id) |
--session-persistence <session persistence> | Set the session persistence for the listener (key=value). |
--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS} | Load balancing algorithm to use. |
--enable | Enable pool (default). |
--disable | Disable pool. |
--tls-container-ref <container-ref> | The reference to the key manager service secrets container containing the certificate and key for ``tls_enabled``pools to re-encrpt the traffic to backend member servers. |
--ca-tls-container-ref <ca_tls_container_ref> | The reference to the key manager service secrets container containing the CA certificate for ``tls_enabled`` pools to check the backend member servers certificates |
--crl-container-ref <crl_container_ref> | The reference to the key manager service secrets container containting the CA revocation list file for ``tls_enabled`` pools to validate the backend member servers certificates. |
--enable-tls | Enable backend member re-encryption. |
--disable-tls | Disable backend member re-encryption. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.46. loadbalancer pool delete
Delete a pool
Usage:
openstack loadbalancer pool delete [-h] <pool>
openstack loadbalancer pool delete [-h] <pool>
Value | Summary |
---|---|
<pool> | Pool to delete (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.47. loadbalancer pool list
List pools
Usage:
openstack loadbalancer pool 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] [--loadbalancer <loadbalancer>]
openstack loadbalancer pool 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]
[--loadbalancer <loadbalancer>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--loadbalancer <loadbalancer> | Filter by load balancer (name or id). |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.48. loadbalancer pool set
Update a pool
Usage:
openstack loadbalancer pool set [-h] [--name <name>] [--description <description>] [--session-persistence <session_persistence>] [--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}] [--enable | --disable] [--tls-container-ref <container-ref>] [--ca-tls-container-ref <ca_tls_container_ref>] [--crl-container-ref <crl_container_ref>] [--enable-tls | --disable-tls] <pool>
openstack loadbalancer pool set [-h] [--name <name>]
[--description <description>]
[--session-persistence <session_persistence>]
[--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}]
[--enable | --disable]
[--tls-container-ref <container-ref>]
[--ca-tls-container-ref <ca_tls_container_ref>]
[--crl-container-ref <crl_container_ref>]
[--enable-tls | --disable-tls]
<pool>
Value | Summary |
---|---|
<pool> | Pool to update (name or id). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set the name of the pool. |
--description <description> | Set the description of the pool. |
--session-persistence <session_persistence> | Set the session persistence for the listener (key=value). |
--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS} | Set the load balancing algorithm to use. |
--enable | Enable pool. |
--disable | Disable pool. |
--tls-container-ref <container-ref> | The uri to the key manager service secrets container containing the certificate and key for TERMINATED_TLS pools to re-encrpt the traffic from TERMINATED_TLS listener to backend servers. |
--ca-tls-container-ref <ca_tls_container_ref> | The uri to the key manager service secrets container containing the CA certificate for TERMINATED_TLS listeners to check the backend servers certificates in ssl traffic. |
--crl-container-ref <crl_container_ref> | The uri to the key manager service secrets container containting the CA revocation list file for TERMINATED_TLS listeners to valid the backend servers certificates in ssl traffic. |
--enable-tls | Enable backend associated members re-encryption. |
--disable-tls | Disable backend associated members re-encryption. |
49.49. loadbalancer pool show
Show the details of a single pool
Usage:
openstack loadbalancer pool show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <pool>
openstack loadbalancer pool show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<pool>
Value | Summary |
---|---|
<pool> | Name or uuid of the pool. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.50. loadbalancer provider capability list
List specified provider driver’s flavor capabilicies.
Usage:
openstack loadbalancer provider capability 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] <provider_name>
openstack loadbalancer provider capability 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]
<provider_name>
Value | Summary |
---|---|
<provider_name> | Name of the provider driver. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.51. loadbalancer provider list
List all providers
Usage:
openstack loadbalancer provider 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]
openstack loadbalancer provider 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.52. loadbalancer quota defaults show
Show quota defaults
Usage:
openstack loadbalancer quota defaults show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack loadbalancer quota defaults show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.53. loadbalancer quota list
List quotas
Usage:
openstack loadbalancer quota 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] [--project <project-id>]
openstack loadbalancer quota 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]
[--project <project-id>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project-id> | Name or uuid of the project. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.54. loadbalancer quota reset
Resets quotas to default quotas
Usage:
openstack loadbalancer quota reset [-h] <project>
openstack loadbalancer quota reset [-h] <project>
Value | Summary |
---|---|
<project> | Project to reset quotas (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
49.55. loadbalancer quota set
Update a quota
Usage:
openstack loadbalancer quota set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--healthmonitor <health_monitor>] [--listener <listener>] [--loadbalancer <load_balancer>] [--member <member>] [--pool <pool>] <project>
openstack loadbalancer quota set [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--healthmonitor <health_monitor>]
[--listener <listener>]
[--loadbalancer <load_balancer>]
[--member <member>] [--pool <pool>]
<project>
Value | Summary |
---|---|
<project> | Name or uuid of the project. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Value | Summary |
---|---|
At least one of the following arguments is required.--healthmonitor <health_monitor> | New value for the health monitor quota. value -1 means unlimited. |
--listener <listener> | New value for the listener quota. value -1 means unlimited. |
--loadbalancer <load_balancer> | New value for the load balancer quota limit. value -1 means unlimited. |
--member <member> | New value for the member quota limit. value -1 means unlimited. |
--pool <pool> | New value for the pool quota limit. value -1 means unlimited. |
49.56. loadbalancer quota show
Show the quota details for a project
Usage:
openstack loadbalancer quota show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <project>
openstack loadbalancer quota show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<project>
Value | Summary |
---|---|
<project> | Name or uuid of the project. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.57. loadbalancer set
Update a load balancer
Usage:
openstack loadbalancer set [-h] [--name <name>] [--description <description>] [--vip-qos-policy-id <vip_qos_policy_id>] [--enable | --disable] <load_balancer>
openstack loadbalancer set [-h] [--name <name>]
[--description <description>]
[--vip-qos-policy-id <vip_qos_policy_id>]
[--enable | --disable]
<load_balancer>
Value | Summary |
---|---|
<load_balancer> | Name or uuid of the load balancer to update. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set load balancer name. |
--description <description> | Set load balancer description. |
--vip-qos-policy-id <vip_qos_policy_id> | Set qos policy id for vip port. unset with none. |
--enable | Enable load balancer. |
--disable | Disable load balancer. |
49.58. loadbalancer show
Show the details for a single load balancer
Usage:
openstack loadbalancer show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <load_balancer>
openstack loadbalancer show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<load_balancer>
Value | Summary |
---|---|
<load_balancer> | Name or uuid of the load balancer. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.59. loadbalancer stats show
Shows the current statistics for a load balancer
Usage:
openstack loadbalancer stats show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <load_balancer>
openstack loadbalancer stats show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<load_balancer>
Value | Summary |
---|---|
<load_balancer> | Name or uuid of the load balancer. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
49.60. loadbalancer status show
Display load balancer status tree in json format
Usage:
openstack loadbalancer status show [-h] <load_balancer>
openstack loadbalancer status show [-h] <load_balancer>
Value | Summary |
---|---|
<load_balancer> | Name or uuid of the load balancer. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Chapter 50. mapping
This chapter describes the commands under the mapping
command.
50.1. mapping create
Create new mapping
Usage:
openstack mapping create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --rules <filename> <name>
openstack mapping create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --rules <filename>
<name>
Value | Summary |
---|---|
<name> | New mapping name (must be unique) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--rules <filename> | Filename that contains a set of mapping rules (required) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
50.2. mapping delete
Delete mapping(s)
Usage:
openstack mapping delete [-h] <mapping> [<mapping> ...]
openstack mapping delete [-h] <mapping> [<mapping> ...]
Value | Summary |
---|---|
<mapping> | Mapping(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
50.3. mapping list
List mappings
Usage:
openstack mapping 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]
openstack mapping 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
50.4. mapping set
Set mapping properties
Usage:
openstack mapping set [-h] [--rules <filename>] <name>
openstack mapping set [-h] [--rules <filename>] <name>
Value | Summary |
---|---|
<name> | Mapping to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--rules <filename> | Filename that contains a new set of mapping rules |
50.5. mapping show
Display mapping details
Usage:
openstack mapping show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <mapping>
openstack mapping show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<mapping>
Value | Summary |
---|---|
<mapping> | Mapping to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 51. messaging
This chapter describes the commands under the messaging
command.
51.1. messaging claim create
Create claim and return a list of claimed messages
Usage:
openstack messaging claim 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] [--ttl <ttl>] [--grace <grace>] [--limit <limit>] <queue_name>
openstack messaging claim 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]
[--ttl <ttl>] [--grace <grace>]
[--limit <limit>]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue to be claim |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--ttl <ttl> | Time to live in seconds for claim |
--grace <grace> | The message grace period in seconds |
--limit <limit> | Claims a set of messages, up to limit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.2. messaging claim query
Display claim details
Usage:
openstack messaging claim query [-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] <queue_name> <claim_id>
openstack messaging claim query [-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]
<queue_name> <claim_id>
Value | Summary |
---|---|
<queue_name> | Name of the claimed queue |
<claim_id> | Id of the claim |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.3. messaging claim release
Delete a claim
Usage:
openstack messaging claim release [-h] <queue_name> <claim_id>
openstack messaging claim release [-h] <queue_name> <claim_id>
Value | Summary |
---|---|
<queue_name> | Name of the claimed queue |
<claim_id> | Claim id to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.4. messaging claim renew
Renew a claim
Usage:
openstack messaging claim renew [-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] [--ttl <ttl>] [--grace <grace>] <queue_name> <claim_id>
openstack messaging claim renew [-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]
[--ttl <ttl>] [--grace <grace>]
<queue_name> <claim_id>
Value | Summary |
---|---|
<queue_name> | Name of the claimed queue |
<claim_id> | Claim id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--ttl <ttl> | Time to live in seconds for claim |
--grace <grace> | The message grace period in seconds |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.5. messaging flavor create
Create a pool flavor
Usage:
openstack messaging flavor create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--capabilities <capabilities>] <flavor_name> <pool_group>
openstack messaging flavor create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--capabilities <capabilities>]
<flavor_name> <pool_group>
Value | Summary |
---|---|
<flavor_name> | Name of the flavor |
<pool_group> | Pool group for flavor |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--capabilities <capabilities> | Describes flavor-specific capabilities, this option is only available in client api version < 2 . |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.6. messaging flavor delete
Delete a pool flavor
Usage:
openstack messaging flavor delete [-h] <flavor_name>
openstack messaging flavor delete [-h] <flavor_name>
Value | Summary |
---|---|
<flavor_name> | Name of the flavor |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.7. messaging flavor list
List available pool flavors
Usage:
openstack messaging flavor 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 <flavor_name>] [--limit <limit>] [--detailed]
openstack messaging flavor 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 <flavor_name>]
[--limit <limit>] [--detailed]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker <flavor_name> | Flavor’s paging marker |
--limit <limit> | Page size limit |
--detailed | If show detailed capabilities of flavor |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.8. messaging flavor show
Display pool flavor details
Usage:
openstack messaging flavor show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <flavor_name>
openstack messaging flavor show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<flavor_name>
Value | Summary |
---|---|
<flavor_name> | Flavor to display (name) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.9. messaging flavor update
Update a flavor’s attributes
Usage:
openstack messaging flavor update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--pool_group <pool_group>] [--capabilities <capabilities>] <flavor_name>
openstack messaging flavor update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--pool_group <pool_group>]
[--capabilities <capabilities>]
<flavor_name>
Value | Summary |
---|---|
<flavor_name> | Name of the flavor |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--pool_group <pool_group> | Pool group the flavor sits on |
--capabilities <capabilities> | Describes flavor-specific capabilities. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.10. messaging health
Display detailed health status of Zaqar server
Usage:
openstack messaging health [-h]
openstack messaging health [-h]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.11. messaging homedoc
Display detailed resource doc of Zaqar server
Usage:
openstack messaging homedoc [-h]
openstack messaging homedoc [-h]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.12. messaging message list
List all messages for a given queue
Usage:
openstack messaging message 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] [--message-ids <message_ids>] [--limit <limit>] [--echo] [--include-claimed] [--include-delayed] [--client-id <client_id>] <queue_name>
openstack messaging message 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]
[--message-ids <message_ids>]
[--limit <limit>] [--echo]
[--include-claimed]
[--include-delayed]
[--client-id <client_id>]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--message-ids <message_ids> | List of messages' ids to retrieve |
--limit <limit> | Maximum number of messages to get |
--echo | Whether to get this client’s own messages |
--include-claimed | Whether to include claimed messages |
--include-delayed | Whether to include delayed messages |
--client-id <client_id> | A uuid for each client instance. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.13. messaging message post
Post messages for a given queue
Usage:
openstack messaging message post [-h] [--client-id <client_id>] <queue_name> <messages>
openstack messaging message post [-h] [--client-id <client_id>]
<queue_name> <messages>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
<messages> | Messages to be posted. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--client-id <client_id> | A uuid for each client instance. |
51.14. messaging ping
Check if Zaqar server is alive or not
Usage:
openstack messaging ping [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack messaging ping [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.15. messaging pool create
Create a pool
Usage:
openstack messaging pool create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--pool_group <pool_group>] [--pool_options <pool_options>] <pool_name> <pool_uri> <pool_weight>
openstack messaging pool create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--pool_group <pool_group>]
[--pool_options <pool_options>]
<pool_name> <pool_uri> <pool_weight>
Value | Summary |
---|---|
<pool_name> | Name of the pool |
<pool_uri> | Storage engine uri |
<pool_weight> | Weight of the pool |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--pool_group <pool_group> | Group of the pool |
--pool_options <pool_options> | An optional request component related to storage- specific options |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.16. messaging pool delete
Delete a pool
Usage:
openstack messaging pool delete [-h] <pool_name>
openstack messaging pool delete [-h] <pool_name>
Value | Summary |
---|---|
<pool_name> | Name of the pool |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.17. messaging pool list
List available Pools
Usage:
openstack messaging pool 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 <pool_name>] [--limit <limit>] [--detailed]
openstack messaging pool 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 <pool_name>] [--limit <limit>]
[--detailed]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker <pool_name> | Pool’s paging marker |
--limit <limit> | Page size limit |
--detailed | Detailed output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.18. messaging pool show
Display pool details
Usage:
openstack messaging pool show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <pool_name>
openstack messaging pool show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
<pool_name>
Value | Summary |
---|---|
<pool_name> | Pool to display (name) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.19. messaging pool update
Update a pool attribute
Usage:
openstack messaging pool update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--pool_uri <pool_uri>] [--pool_weight <pool_weight>] [--pool_group <pool_group>] [--pool_options <pool_options>] <pool_name>
openstack messaging pool update [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--pool_uri <pool_uri>]
[--pool_weight <pool_weight>]
[--pool_group <pool_group>]
[--pool_options <pool_options>]
<pool_name>
Value | Summary |
---|---|
<pool_name> | Name of the pool |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--pool_uri <pool_uri> | Storage engine uri |
--pool_weight <pool_weight> | Weight of the pool |
--pool_group <pool_group> | Group of the pool |
--pool_options <pool_options> | An optional request component related to storage- specific options |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.20. messaging queue create
Create a queue
Usage:
openstack messaging queue create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <queue_name>
openstack messaging queue create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.21. messaging queue delete
Delete a queue
Usage:
openstack messaging queue delete [-h] <queue_name>
openstack messaging queue delete [-h] <queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.22. messaging queue get metadata
Get queue metadata
Usage:
openstack messaging queue get metadata [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <queue_name>
openstack messaging queue get metadata [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.23. messaging queue list
List available queues
Usage:
openstack messaging queue 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 <queue_id>] [--limit <limit>] [--detailed]
openstack messaging queue 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 <queue_id>] [--limit <limit>]
[--detailed]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker <queue_id> | Queue’s paging marker |
--limit <limit> | Page size limit |
--detailed | If show detailed information of queue |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.24. messaging queue purge
Purge a queue
Usage:
openstack messaging queue purge [-h] [--resource_types <resource_types>] <queue_name>
openstack messaging queue purge [-h]
[--resource_types <resource_types>]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource_types <resource_types> | Resource types want to be purged. |
51.25. messaging queue set metadata
Set queue metadata
Usage:
openstack messaging queue set metadata [-h] <queue_name> <queue_metadata>
openstack messaging queue set metadata [-h]
<queue_name> <queue_metadata>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
<queue_metadata> | Queue metadata, all the metadata of the queue will be replaced by queue_metadata |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.26. messaging queue signed url
Create a pre-signed url
Usage:
openstack messaging queue signed url [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--paths <paths>] [--ttl-seconds <ttl_seconds>] [--methods <methods>] <queue_name>
openstack messaging queue signed url [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--paths <paths>]
[--ttl-seconds <ttl_seconds>]
[--methods <methods>]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--paths <paths> | Allowed paths in a comma-separated list. options: messages, subscriptions, claims |
--ttl-seconds <ttl_seconds> | Length of time (in seconds) until the signature expires |
--methods <methods> | Http methods to allow as a comma-separated list. Options: GET, HEAD, OPTIONS, POST, PUT, DELETE |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.27. messaging queue stats
Get queue stats
Usage:
openstack messaging queue stats [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <queue_name>
openstack messaging queue stats [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.28. messaging subscription create
Create a subscription for queue
Usage:
openstack messaging subscription create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--options <options>] <queue_name> <subscriber> <ttl>
openstack messaging subscription create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--options <options>]
<queue_name> <subscriber> <ttl>
Value | Summary |
---|---|
<queue_name> | Name of the queue to subscribe to |
<subscriber> | Subscriber which will be notified |
<ttl> | Time to live of the subscription in seconds |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--options <options> | Metadata of the subscription in json format |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.29. messaging subscription delete
Delete a subscription
Usage:
openstack messaging subscription delete [-h] <queue_name> <subscription_id>
openstack messaging subscription delete [-h]
<queue_name> <subscription_id>
Value | Summary |
---|---|
<queue_name> | Name of the queue for the subscription |
<subscription_id> | Id of the subscription |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
51.30. messaging subscription list
List available subscriptions
Usage:
openstack messaging subscription 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 <subscription_id>] [--limit <limit>] <queue_name>
openstack messaging subscription 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 <subscription_id>]
[--limit <limit>]
<queue_name>
Value | Summary |
---|---|
<queue_name> | Name of the queue to subscribe to |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker <subscription_id> | Subscription’s paging marker, the id of the last subscription of the previous page |
--limit <limit> | Page size limit, default value is 20 |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.31. messaging subscription show
Display subscription details
Usage:
openstack messaging subscription show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <queue_name> <subscription_id>
openstack messaging subscription show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<queue_name> <subscription_id>
Value | Summary |
---|---|
<queue_name> | Name of the queue to subscribe to |
<subscription_id> | Id of the subscription |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
51.32. messaging subscription update
Update a subscription
Usage:
openstack messaging subscription update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--subscriber <subscriber>] [--ttl <ttl>] [--options <options>] <queue_name> <subscription_id>
openstack messaging subscription update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--subscriber <subscriber>]
[--ttl <ttl>]
[--options <options>]
<queue_name> <subscription_id>
Value | Summary |
---|---|
<queue_name> | Name of the queue to subscribe to |
<subscription_id> | Id of the subscription |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--subscriber <subscriber> | Subscriber which will be notified |
--ttl <ttl> | Time to live of the subscription in seconds |
--options <options> | Metadata of the subscription in json format |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 52. metric
This chapter describes the commands under the metric
command.
52.1. metric aggregates
Get measurements of aggregated metrics.
Usage:
openstack metric aggregates [-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] [--resource-type RESOURCE_TYPE] [--start START] [--stop STOP] [--granularity GRANULARITY] [--needed-overlap NEEDED_OVERLAP] [--groupby GROUPBY] [--fill FILL] operations [search]
openstack metric aggregates [-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]
[--resource-type RESOURCE_TYPE]
[--start START] [--stop STOP]
[--granularity GRANULARITY]
[--needed-overlap NEEDED_OVERLAP]
[--groupby GROUPBY] [--fill FILL]
operations [search]
Value | Summary |
---|---|
operations | Operations to apply to time series |
search | A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-type RESOURCE_TYPE | Resource type to query |
--start START | Beginning of the period |
--stop STOP | End of the period |
--granularity GRANULARITY | Granularity to retrieve |
--needed-overlap NEEDED_OVERLAP | Percentage of overlap across datapoints |
--groupby GROUPBY | Attribute to use to group resources |
--fill FILL | Value to use when backfilling timestamps with missing values in a subset of series. Value should be a float or null. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.2. metric archive-policy create
Create an archive policy.
Usage:
openstack metric archive-policy create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] -d <DEFINITION> [-b BACK_WINDOW] [-m AGGREGATION_METHODS] name
openstack metric archive-policy create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty] -d
<DEFINITION> [-b BACK_WINDOW]
[-m AGGREGATION_METHODS]
name
Value | Summary |
---|---|
name | Name of the archive policy |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-d <DEFINITION>, --definition <DEFINITION> | Two attributes (separated by ,) of an archive policy definition with its name and value separated with a : |
-b BACK_WINDOW, --back-window BACK_WINDOW | Back window of the archive policy |
-m AGGREGATION_METHODS, --aggregation-method AGGREGATION_METHODS | Aggregation method of the archive policy |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.3. metric archive-policy delete
Delete an archive policy.
Usage:
openstack metric archive-policy delete [-h] name
openstack metric archive-policy delete [-h] name
Value | Summary |
---|---|
name | Name of the archive policy |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
52.4. metric archive-policy list
List archive policies.
Usage:
openstack metric archive-policy 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]
openstack metric archive-policy 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.5. metric archive-policy-rule create
Create an archive policy rule.
Usage:
openstack metric archive-policy-rule create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] -a ARCHIVE_POLICY_NAME -m METRIC_PATTERN name
openstack metric archive-policy-rule create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty] -a
ARCHIVE_POLICY_NAME -m
METRIC_PATTERN
name
Value | Summary |
---|---|
name | Rule name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-a ARCHIVE_POLICY_NAME, --archive-policy-name ARCHIVE_POLICY_NAME | Archive policy name |
-m METRIC_PATTERN, --metric-pattern METRIC_PATTERN | Wildcard of metric name to match |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.6. metric archive-policy-rule delete
Delete an archive policy rule.
Usage:
openstack metric archive-policy-rule delete [-h] name
openstack metric archive-policy-rule delete [-h] name
Value | Summary |
---|---|
name | Name of the archive policy rule |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
52.7. metric archive-policy-rule list
List archive policy rules.
Usage:
openstack metric archive-policy-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]
openstack metric archive-policy-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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.8. metric archive-policy-rule show
Show an archive policy rule.
Usage:
openstack metric archive-policy-rule show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] name
openstack metric archive-policy-rule show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
name
Value | Summary |
---|---|
name | Name of the archive policy rule |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.9. metric archive-policy show
Show an archive policy.
Usage:
openstack metric archive-policy show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] name
openstack metric archive-policy show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
name
Value | Summary |
---|---|
name | Name of the archive policy |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.10. metric archive-policy update
Update an archive policy.
Usage:
openstack metric archive-policy update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] -d <DEFINITION> name
openstack metric archive-policy update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty] -d
<DEFINITION>
name
Value | Summary |
---|---|
name | Name of the archive policy |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-d <DEFINITION>, --definition <DEFINITION> | Two attributes (separated by ,) of an archive policy definition with its name and value separated with a : |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.11. metric benchmark measures add
Do benchmark testing of adding measurements.
Usage:
openstack metric benchmark measures add [-h] [--resource-id RESOURCE_ID] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--workers WORKERS] --count COUNT [--batch BATCH] [--timestamp-start TIMESTAMP_START] [--timestamp-end TIMESTAMP_END] [--wait] metric
openstack metric benchmark measures add [-h]
[--resource-id RESOURCE_ID]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--workers WORKERS] --count
COUNT [--batch BATCH]
[--timestamp-start TIMESTAMP_START]
[--timestamp-end TIMESTAMP_END]
[--wait]
metric
Value | Summary |
---|---|
metric | Id or name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--workers WORKERS, -w WORKERS | Number of workers to use |
--count COUNT, -n COUNT | Number of total measures to send |
--batch BATCH, -b BATCH | Number of measures to send in each batch |
--timestamp-start TIMESTAMP_START, -s TIMESTAMP_START | First timestamp to use |
--timestamp-end TIMESTAMP_END, -e TIMESTAMP_END | Last timestamp to use |
--wait | Wait for all measures to be processed |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.12. metric benchmark measures show
Do benchmark testing of measurements show.
Usage:
openstack metric benchmark measures show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--utc] [--resource-id RESOURCE_ID] [--aggregation AGGREGATION] [--start START] [--stop STOP] [--granularity GRANULARITY] [--refresh] [--resample RESAMPLE] [--workers WORKERS] --count COUNT metric
openstack metric benchmark measures show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--sort-column SORT_COLUMN]
[--utc]
[--resource-id RESOURCE_ID]
[--aggregation AGGREGATION]
[--start START] [--stop STOP]
[--granularity GRANULARITY]
[--refresh]
[--resample RESAMPLE]
[--workers WORKERS] --count
COUNT
metric
Value | Summary |
---|---|
metric | Id or name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--utc | Return timestamps as utc |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--aggregation AGGREGATION | Aggregation to retrieve |
--start START | Beginning of the period |
--stop STOP | End of the period |
--granularity GRANULARITY | Granularity to retrieve |
--refresh | Force aggregation of all known measures |
--resample RESAMPLE | Granularity to resample time-series to (in seconds) |
--workers WORKERS, -w WORKERS | Number of workers to use |
--count COUNT, -n COUNT | Number of total measures to send |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.13. metric benchmark metric create
Do benchmark testing of metric creation.
Usage:
openstack metric benchmark metric create [-h] [--resource-id RESOURCE_ID] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--archive-policy-name ARCHIVE_POLICY_NAME] [--workers WORKERS] --count COUNT [--keep]
openstack metric benchmark metric create [-h]
[--resource-id RESOURCE_ID]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--archive-policy-name ARCHIVE_POLICY_NAME]
[--workers WORKERS] --count
COUNT [--keep]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME | Name of the archive policy |
--workers WORKERS, -w WORKERS | Number of workers to use |
--count COUNT, -n COUNT | Number of metrics to create |
--keep, -k | Keep created metrics |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.14. metric benchmark metric show
Do benchmark testing of metric show.
Usage:
openstack metric benchmark metric show [-h] [--resource-id RESOURCE_ID] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--workers WORKERS] --count COUNT metric [metric ...]
openstack metric benchmark metric show [-h] [--resource-id RESOURCE_ID]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--workers WORKERS] --count
COUNT
metric [metric ...]
Value | Summary |
---|---|
metric | Id or name of the metrics |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--workers WORKERS, -w WORKERS | Number of workers to use |
--count COUNT, -n COUNT | Number of metrics to get |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.15. metric capabilities list
List capabilities.
Usage:
openstack metric capabilities list [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack metric capabilities list [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.16. metric create
Create a metric.
Usage:
openstack metric create [-h] [--resource-id RESOURCE_ID] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--archive-policy-name ARCHIVE_POLICY_NAME] [--unit UNIT] [METRIC_NAME]
openstack metric create [-h] [--resource-id RESOURCE_ID]
[-f {json,shell,table,value,yaml}] [-c COLUMN]
[--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--archive-policy-name ARCHIVE_POLICY_NAME]
[--unit UNIT]
[METRIC_NAME]
Value | Summary |
---|---|
METRIC_NAME | Name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME | Name of the archive policy |
--unit UNIT, -u UNIT | Unit of the metric |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.17. metric delete
Delete a metric.
Usage:
openstack metric delete [-h] [--resource-id RESOURCE_ID] metric [metric ...]
openstack metric delete [-h] [--resource-id RESOURCE_ID]
metric [metric ...]
Value | Summary |
---|---|
metric | Ids or names of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
52.18. metric list
List metrics.
Usage:
openstack metric 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 <MARKER>] [--sort <SORT>]
openstack metric 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 <MARKER>] [--sort <SORT>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <LIMIT> | Number of metrics to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value |
--sort <SORT> | Sort of metric attribute (example: user_id:desc- nullslast |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.19. metric measures add
Add measurements to a metric.
Usage:
openstack metric measures add [-h] [--resource-id RESOURCE_ID] -m MEASURE metric
openstack metric measures add [-h] [--resource-id RESOURCE_ID] -m
MEASURE
metric
Value | Summary |
---|---|
metric | Id or name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
-m MEASURE, --measure MEASURE | Timestamp and value of a measure separated with a @ |
52.20. metric measures aggregation
Get measurements of aggregated metrics.
Usage:
openstack metric measures aggregation [-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] [--utc] -m METRIC [METRIC ...] [--aggregation AGGREGATION] [--reaggregation REAGGREGATION] [--start START] [--stop STOP] [--granularity GRANULARITY] [--needed-overlap NEEDED_OVERLAP] [--query QUERY] [--resource-type RESOURCE_TYPE] [--groupby GROUPBY] [--refresh] [--resample RESAMPLE] [--fill FILL]
openstack metric measures aggregation [-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]
[--utc] -m METRIC [METRIC ...]
[--aggregation AGGREGATION]
[--reaggregation REAGGREGATION]
[--start START] [--stop STOP]
[--granularity GRANULARITY]
[--needed-overlap NEEDED_OVERLAP]
[--query QUERY]
[--resource-type RESOURCE_TYPE]
[--groupby GROUPBY] [--refresh]
[--resample RESAMPLE]
[--fill FILL]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--utc | Return timestamps as utc |
-m METRIC [METRIC …], --metric METRIC [METRIC …] | Metrics ids or metric name |
--aggregation AGGREGATION | Granularity aggregation function to retrieve |
--reaggregation REAGGREGATION | Groupby aggregation function to retrieve |
--start START | Beginning of the period |
--stop STOP | End of the period |
--granularity GRANULARITY | Granularity to retrieve |
--needed-overlap NEEDED_OVERLAP | Percent of datapoints in each metrics required |
--query QUERY | A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in. |
--resource-type RESOURCE_TYPE | Resource type to query |
--groupby GROUPBY | Attribute to use to group resources |
--refresh | Force aggregation of all known measures |
--resample RESAMPLE | Granularity to resample time-series to (in seconds) |
--fill FILL | Value to use when backfilling timestamps with missing values in a subset of series. Value should be a float or null. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.21. metric measures batch-metrics
Usage:
openstack metric measures batch-metrics [-h] file
openstack metric measures batch-metrics [-h] file
Value | Summary |
---|---|
file | File containing measurements to batch or - for stdin (see Gnocchi REST API docs for the format |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
52.22. metric measures batch-resources-metrics
Usage:
openstack metric measures batch-resources-metrics [-h] [--create-metrics] file
openstack metric measures batch-resources-metrics [-h]
[--create-metrics]
file
Value | Summary |
---|---|
file | File containing measurements to batch or - for stdin (see Gnocchi REST API docs for the format |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--create-metrics | Create unknown metrics |
52.23. metric measures show
Get measurements of a metric.
Usage:
openstack metric measures 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] [--utc] [--resource-id RESOURCE_ID] [--aggregation AGGREGATION] [--start START] [--stop STOP] [--granularity GRANULARITY] [--refresh] [--resample RESAMPLE] metric
openstack metric measures 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] [--utc]
[--resource-id RESOURCE_ID]
[--aggregation AGGREGATION]
[--start START] [--stop STOP]
[--granularity GRANULARITY] [--refresh]
[--resample RESAMPLE]
metric
Value | Summary |
---|---|
metric | Id or name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--utc | Return timestamps as utc |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--aggregation AGGREGATION | Aggregation to retrieve |
--start START | Beginning of the period |
--stop STOP | End of the period |
--granularity GRANULARITY | Granularity to retrieve |
--refresh | Force aggregation of all known measures |
--resample RESAMPLE | Granularity to resample time-series to (in seconds) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.24. metric metric create
Deprecated: Create a metric.
Usage:
openstack metric metric create [-h] [--resource-id RESOURCE_ID] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--archive-policy-name ARCHIVE_POLICY_NAME] [--unit UNIT] [METRIC_NAME]
openstack metric metric create [-h] [--resource-id RESOURCE_ID]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--archive-policy-name ARCHIVE_POLICY_NAME]
[--unit UNIT]
[METRIC_NAME]
Value | Summary |
---|---|
METRIC_NAME | Name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
--archive-policy-name ARCHIVE_POLICY_NAME, -a ARCHIVE_POLICY_NAME | Name of the archive policy |
--unit UNIT, -u UNIT | Unit of the metric |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.25. metric metric delete
Deprecated: Delete a metric.
Usage:
openstack metric metric delete [-h] [--resource-id RESOURCE_ID] metric [metric ...]
openstack metric metric delete [-h] [--resource-id RESOURCE_ID]
metric [metric ...]
Value | Summary |
---|---|
metric | Ids or names of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
52.26. metric metric list
Deprecated: List metrics.
Usage:
openstack metric metric 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 <MARKER>] [--sort <SORT>]
openstack metric metric 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 <MARKER>]
[--sort <SORT>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit <LIMIT> | Number of metrics to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value |
--sort <SORT> | Sort of metric attribute (example: user_id:desc- nullslast |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.27. metric metric show
Deprecated: Show a metric.
Usage:
openstack metric metric show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--resource-id RESOURCE_ID] metric
openstack metric metric show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--resource-id RESOURCE_ID]
metric
Value | Summary |
---|---|
metric | Id or name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.28. metric resource batch delete
Delete a batch of resources based on attribute values.
Usage:
openstack metric resource batch delete [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type RESOURCE_TYPE] query
openstack metric resource batch delete [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--type RESOURCE_TYPE]
query
Value | Summary |
---|---|
query | A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.29. metric resource create
Create a resource.
Usage:
openstack metric resource create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type RESOURCE_TYPE] [-a ATTRIBUTE] [-m ADD_METRIC] [-n CREATE_METRIC] resource_id
openstack metric resource create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--type RESOURCE_TYPE]
[-a ATTRIBUTE] [-m ADD_METRIC]
[-n CREATE_METRIC]
resource_id
Value | Summary |
---|---|
resource_id | Id of the resource |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
-a ATTRIBUTE, --attribute ATTRIBUTE | Name and value of an attribute separated with a : |
-m ADD_METRIC, --add-metric ADD_METRIC | Name:id of a metric to add |
-n CREATE_METRIC, --create-metric CREATE_METRIC | Name:archive_policy_name of a metric to create |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.30. metric resource delete
Delete a resource.
Usage:
openstack metric resource delete [-h] resource_id
openstack metric resource delete [-h] resource_id
Value | Summary |
---|---|
resource_id | Id of the resource |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
52.31. metric resource history
Show the history of a resource.
Usage:
openstack metric resource history [-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] [--details] [--limit <LIMIT>] [--marker <MARKER>] [--sort <SORT>] [--type RESOURCE_TYPE] resource_id
openstack metric resource history [-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]
[--details] [--limit <LIMIT>]
[--marker <MARKER>] [--sort <SORT>]
[--type RESOURCE_TYPE]
resource_id
Value | Summary |
---|---|
resource_id | Id of a resource |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--details | Show all attributes of generic resources |
--limit <LIMIT> | Number of resources to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value |
--sort <SORT> | Sort of resource attribute (example: user_id:desc- nullslast |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.32. metric resource list
List resources.
Usage:
openstack metric resource 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] [--details] [--history] [--limit <LIMIT>] [--marker <MARKER>] [--sort <SORT>] [--type RESOURCE_TYPE]
openstack metric resource 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] [--details]
[--history] [--limit <LIMIT>]
[--marker <MARKER>] [--sort <SORT>]
[--type RESOURCE_TYPE]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--details | Show all attributes of generic resources |
--history | Show history of the resources |
--limit <LIMIT> | Number of resources to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value |
--sort <SORT> | Sort of resource attribute (example: user_id:desc- nullslast |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.33. metric resource search
Search resources with specified query rules.
Usage:
openstack metric resource search [-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] [--details] [--history] [--limit <LIMIT>] [--marker <MARKER>] [--sort <SORT>] [--type RESOURCE_TYPE] query
openstack metric resource search [-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]
[--details] [--history]
[--limit <LIMIT>] [--marker <MARKER>]
[--sort <SORT>] [--type RESOURCE_TYPE]
query
Value | Summary |
---|---|
query | A query to filter resource. the syntax is a combination of attribute, operator and value. For example: id=90d58eea-70d7-4294-a49a-170dcdf44c3c would filter resource with a certain id. More complex queries can be built, e.g.: not (flavor_id!="1" and memory>=24). Use "" to force data to be interpreted as string. Supported operators are: not, and, ∧ or, ∨, >=, ⇐, !=, >, <, =, ==, eq, ne, lt, gt, ge, le, in, like, ≠, ≥, ≤, like, in. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--details | Show all attributes of generic resources |
--history | Show history of the resources |
--limit <LIMIT> | Number of resources to return (default is server default) |
--marker <MARKER> | Last item of the previous listing. return the next results after this value |
--sort <SORT> | Sort of resource attribute (example: user_id:desc- nullslast |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.34. metric resource show
Show a resource.
Usage:
openstack metric resource show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type RESOURCE_TYPE] resource_id
openstack metric resource show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--type RESOURCE_TYPE]
resource_id
Value | Summary |
---|---|
resource_id | Id of a resource |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.35. metric resource-type create
Create a resource type.
Usage:
openstack metric resource-type create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [-a ATTRIBUTE] name
openstack metric resource-type create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[-a ATTRIBUTE]
name
Value | Summary |
---|---|
name | Name of the resource type |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-a ATTRIBUTE, --attribute ATTRIBUTE | Attribute definition, attribute_name:attribute_type:at tribute_is_required:attribute_type_option_name=attribu te_type_option_value:… For example: display_name:string:true:max_length=255 |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.36. metric resource-type delete
Delete a resource type.
Usage:
openstack metric resource-type delete [-h] name
openstack metric resource-type delete [-h] name
Value | Summary |
---|---|
name | Name of the resource type |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
52.37. metric resource-type list
List resource types.
Usage:
openstack metric resource-type 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]
openstack metric resource-type 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.38. metric resource-type show
Show a resource type.
Usage:
openstack metric resource-type show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] name
openstack metric resource-type show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
name
Value | Summary |
---|---|
name | Name of the resource type |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.39. metric resource-type update
Create a resource type.
Usage:
openstack metric resource-type update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [-a ATTRIBUTE] [-r REMOVE_ATTRIBUTE] name
openstack metric resource-type update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[-a ATTRIBUTE]
[-r REMOVE_ATTRIBUTE]
name
Value | Summary |
---|---|
name | Name of the resource type |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-a ATTRIBUTE, --attribute ATTRIBUTE | Attribute definition, attribute_name:attribute_type:at tribute_is_required:attribute_type_option_name=attribu te_type_option_value:… For example: display_name:string:true:max_length=255 |
-r REMOVE_ATTRIBUTE, --remove-attribute REMOVE_ATTRIBUTE | Attribute name |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.40. metric resource update
Update a resource.
Usage:
openstack metric resource update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type RESOURCE_TYPE] [-a ATTRIBUTE] [-m ADD_METRIC] [-n CREATE_METRIC] [-d DELETE_METRIC] resource_id
openstack metric resource update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--type RESOURCE_TYPE]
[-a ATTRIBUTE] [-m ADD_METRIC]
[-n CREATE_METRIC] [-d DELETE_METRIC]
resource_id
Value | Summary |
---|---|
resource_id | Id of the resource |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type RESOURCE_TYPE, -t RESOURCE_TYPE | Type of resource |
-a ATTRIBUTE, --attribute ATTRIBUTE | Name and value of an attribute separated with a : |
-m ADD_METRIC, --add-metric ADD_METRIC | Name:id of a metric to add |
-n CREATE_METRIC, --create-metric CREATE_METRIC | Name:archive_policy_name of a metric to create |
-d DELETE_METRIC, --delete-metric DELETE_METRIC | Name of a metric to delete |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.41. metric server version
Show the version of Gnocchi server.
Usage:
openstack metric server version [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack metric server version [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.42. metric show
Show a metric.
Usage:
openstack metric show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--resource-id RESOURCE_ID] metric
openstack metric show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--resource-id RESOURCE_ID]
metric
Value | Summary |
---|---|
metric | Id or name of the metric |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--resource-id RESOURCE_ID, -r RESOURCE_ID | Id of the resource |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
52.43. metric status
Show the status of measurements processing.
Usage:
openstack metric status [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack metric status [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 53. module
This chapter describes the commands under the module
command.
53.1. module list
List module versions
Usage:
openstack module list [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all]
openstack module list [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all | Show all modules that have version information |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 54. network
This chapter describes the commands under the network
command.
54.1. network agent add network
Add network to an agent
Usage:
openstack network agent add network [-h] [--dhcp] <agent-id> <network>
openstack network agent add network [-h] [--dhcp] <agent-id> <network>
Value | Summary |
---|---|
<agent-id> | Agent to which a network is added (id only) |
<network> | Network to be added to an agent (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--dhcp | Add network to a dhcp agent |
54.2. network agent add router
Add router to an agent
Usage:
openstack network agent add router [-h] [--l3] <agent-id> <router>
openstack network agent add router [-h] [--l3] <agent-id> <router>
Value | Summary |
---|---|
<agent-id> | Agent to which a router is added (id only) |
<router> | Router to be added to an agent (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--l3 | Add router to an l3 agent |
54.3. network agent delete
Delete network agent(s)
Usage:
openstack network agent delete [-h] <network-agent> [<network-agent> ...]
openstack network agent delete [-h]
<network-agent> [<network-agent> ...]
Value | Summary |
---|---|
<network-agent> | Network agent(s) to delete (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.4. network agent list
List network agents
Usage:
openstack network agent 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] [--agent-type <agent-type>] [--host <host>] [--network <network> | --router <router>] [--long]
openstack network agent 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]
[--agent-type <agent-type>]
[--host <host>]
[--network <network> | --router <router>]
[--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--agent-type <agent-type> | List only agents with the specified agent type. the supported agent types are: bgp, dhcp, open-vswitch, linux-bridge, ofa, l3, loadbalancer, metering, metadata, macvtap, nic. |
--host <host> | List only agents running on the specified host |
--network <network> | List agents hosting a network (name or id) |
--router <router> | List agents hosting this router (name or id) |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.5. network agent remove network
Remove network from an agent.
Usage:
openstack network agent remove network [-h] [--dhcp] <agent-id> <network>
openstack network agent remove network [-h] [--dhcp]
<agent-id> <network>
Value | Summary |
---|---|
<agent-id> | Agent to which a network is removed (id only) |
<network> | Network to be removed from an agent (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--dhcp | Remove network from dhcp agent |
54.6. network agent remove router
Remove router from an agent
Usage:
openstack network agent remove router [-h] [--l3] <agent-id> <router>
openstack network agent remove router [-h] [--l3] <agent-id> <router>
Value | Summary |
---|---|
<agent-id> | Agent from which router will be removed (id only) |
<router> | Router to be removed from an agent (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--l3 | Remove router from an l3 agent |
54.7. network agent set
Set network agent properties
Usage:
openstack network agent set [-h] [--description <description>] [--enable | --disable] <network-agent>
openstack network agent set [-h] [--description <description>]
[--enable | --disable]
<network-agent>
Value | Summary |
---|---|
<network-agent> | Network agent to modify (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Set network agent description |
--enable | Enable network agent |
--disable | Disable network agent |
54.8. network agent show
Display network agent details
Usage:
openstack network agent show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network-agent>
openstack network agent show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<network-agent>
Value | Summary |
---|---|
<network-agent> | Network agent to display (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.9. network auto allocated topology create
Create the auto allocated topology for project
Usage:
openstack network auto allocated topology create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--check-resources] [--or-show]
openstack network auto allocated topology create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN]
[--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--project <project>]
[--project-domain <project-domain>]
[--check-resources]
[--or-show]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Return the auto allocated topology for a given project. Default is current project |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--check-resources | Validate the requirements for auto allocated topology. Does not return a topology. |
--or-show | If topology exists returns the topology’s information (Default) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.10. network auto allocated topology delete
Delete auto allocated topology for project
Usage:
openstack network auto allocated topology delete [-h] [--project <project>] [--project-domain <project-domain>]
openstack network auto allocated topology delete [-h]
[--project <project>]
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Delete auto allocated topology for a given project. Default is the current project |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
54.11. network create
Create new network
Usage:
openstack network create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--share | --no-share] [--enable | --disable] [--project <project>] [--description <description>] [--mtu <mtu>] [--project-domain <project-domain>] [--availability-zone-hint <availability-zone>] [--enable-port-security | --disable-port-security] [--external | --internal] [--default | --no-default] [--qos-policy <qos-policy>] [--transparent-vlan | --no-transparent-vlan] [--provider-network-type <provider-network-type>] [--provider-physical-network <provider-physical-network>] [--provider-segment <provider-segment>] [--dns-domain <dns-domain>] [--tag <tag> | --no-tag] <name>
openstack network create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--share | --no-share]
[--enable | --disable] [--project <project>]
[--description <description>] [--mtu <mtu>]
[--project-domain <project-domain>]
[--availability-zone-hint <availability-zone>]
[--enable-port-security | --disable-port-security]
[--external | --internal]
[--default | --no-default]
[--qos-policy <qos-policy>]
[--transparent-vlan | --no-transparent-vlan]
[--provider-network-type <provider-network-type>]
[--provider-physical-network <provider-physical-network>]
[--provider-segment <provider-segment>]
[--dns-domain <dns-domain>]
[--tag <tag> | --no-tag]
<name>
Value | Summary |
---|---|
<name> | New network name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--share | Share the network between projects |
--no-share | Do not share the network between projects |
--enable | Enable network (default) |
--disable | Disable network |
--project <project> | Owner’s project (name or id) |
--description <description> | Set network description |
--mtu <mtu> | Set network mtu |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--availability-zone-hint <availability-zone> | Availability zone in which to create this network (Network Availability Zone extension required, repeat option to set multiple availability zones) |
--enable-port-security | Enable port security by default for ports created on this network (default) |
--disable-port-security | Disable port security by default for ports created on this network |
--external | Set this network as an external network (external-net extension required) |
--internal | Set this network as an internal network (default) |
--default | Specify if this network should be used as the default external network |
--no-default | Do not use the network as the default external network (default) |
--qos-policy <qos-policy> | Qos policy to attach to this network (name or id) |
--transparent-vlan | Make the network vlan transparent |
--no-transparent-vlan | Do not make the network vlan transparent |
--provider-network-type <provider-network-type> | The physical mechanism by which the virtual network is implemented. For example: flat, geneve, gre, local, vlan, vxlan. |
--provider-physical-network <provider-physical-network> | Name of the physical network over which the virtual network is implemented |
--provider-segment <provider-segment> | Vlan id for vlan networks or tunnel id for GENEVE/GRE/VXLAN networks |
--dns-domain <dns-domain> | Set dns domain for this network (requires dns integration extension) |
--tag <tag> | Tag to be added to the network (repeat option to set multiple tags) |
--no-tag | No tags associated with the network |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.12. network delete
Delete network(s)
Usage:
openstack network delete [-h] <network> [<network> ...]
openstack network delete [-h] <network> [<network> ...]
Value | Summary |
---|---|
<network> | Network(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.13. network flavor add profile
Add a service profile to a network flavor
Usage:
openstack network flavor add profile [-h] <flavor> <service-profile>
openstack network flavor add profile [-h] <flavor> <service-profile>
Value | Summary |
---|---|
<flavor> | Network flavor (name or id) |
<service-profile> | Service profile (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.14. network flavor create
Create new network flavor
Usage:
openstack network flavor create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --service-type <service-type> [--description DESCRIPTION] [--project <project>] [--project-domain <project-domain>] [--enable | --disable] <name>
openstack network flavor create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --service-type
<service-type>
[--description DESCRIPTION]
[--project <project>]
[--project-domain <project-domain>]
[--enable | --disable]
<name>
Value | Summary |
---|---|
<name> | Name for the flavor |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--service-type <service-type> | Service type to which the flavor applies to: e.g. vpn (See openstack network service provider list for loaded examples.) |
--description DESCRIPTION | Description for the flavor |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--enable | Enable the flavor (default) |
--disable | Disable the flavor |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.15. network flavor delete
Delete network flavors
Usage:
openstack network flavor delete [-h] <flavor> [<flavor> ...]
openstack network flavor delete [-h] <flavor> [<flavor> ...]
Value | Summary |
---|---|
<flavor> | Flavor(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.16. network flavor list
List network flavors
Usage:
openstack network flavor 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]
openstack network flavor 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.17. network flavor profile create
Create new network flavor profile
Usage:
openstack network flavor profile create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--description <description>] [--enable | --disable] [--driver DRIVER] [--metainfo METAINFO]
openstack network flavor profile create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--project <project>]
[--project-domain <project-domain>]
[--description <description>]
[--enable | --disable]
[--driver DRIVER]
[--metainfo METAINFO]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--description <description> | Description for the flavor profile |
--enable | Enable the flavor profile |
--disable | Disable the flavor profile |
--driver DRIVER | Python module path to driver. this becomes required if --metainfo is missing and vice versa |
--metainfo METAINFO | Metainfo for the flavor profile. this becomes required if --driver is missing and vice versa |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.18. network flavor profile delete
Delete network flavor profile
Usage:
openstack network flavor profile delete [-h] <flavor-profile> [<flavor-profile> ...]
openstack network flavor profile delete [-h]
<flavor-profile>
[<flavor-profile> ...]
Value | Summary |
---|---|
<flavor-profile> | Flavor profile(s) to delete (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.19. network flavor profile list
List network flavor profile(s)
Usage:
openstack network flavor profile 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]
openstack network flavor profile 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.20. network flavor profile set
Set network flavor profile properties
Usage:
openstack network flavor profile set [-h] [--project-domain <project-domain>] [--description <description>] [--enable | --disable] [--driver DRIVER] [--metainfo METAINFO] <flavor-profile>
openstack network flavor profile set [-h]
[--project-domain <project-domain>]
[--description <description>]
[--enable | --disable]
[--driver DRIVER]
[--metainfo METAINFO]
<flavor-profile>
Value | Summary |
---|---|
<flavor-profile> | Flavor profile to update (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--description <description> | Description for the flavor profile |
--enable | Enable the flavor profile |
--disable | Disable the flavor profile |
--driver DRIVER | Python module path to driver. this becomes required if --metainfo is missing and vice versa |
--metainfo METAINFO | Metainfo for the flavor profile. this becomes required if --driver is missing and vice versa |
54.21. network flavor profile show
Display network flavor profile details
Usage:
openstack network flavor profile show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <flavor-profile>
openstack network flavor profile show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<flavor-profile>
Value | Summary |
---|---|
<flavor-profile> | Flavor profile to display (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.22. network flavor remove profile
Remove service profile from network flavor
Usage:
openstack network flavor remove profile [-h] <flavor> <service-profile>
openstack network flavor remove profile [-h] <flavor> <service-profile>
Value | Summary |
---|---|
<flavor> | Network flavor (name or id) |
<service-profile> | Service profile (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.23. network flavor set
Set network flavor properties
Usage:
openstack network flavor set [-h] [--description DESCRIPTION] [--disable | --enable] [--name <name>] <flavor>
openstack network flavor set [-h] [--description DESCRIPTION]
[--disable | --enable] [--name <name>]
<flavor>
Value | Summary |
---|---|
<flavor> | Flavor to update (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description DESCRIPTION | Set network flavor description |
--disable | Disable network flavor |
--enable | Enable network flavor |
--name <name> | Set flavor name |
54.24. network flavor show
Display network flavor details
Usage:
openstack network flavor show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <flavor>
openstack network flavor show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty]
<flavor>
Value | Summary |
---|---|
<flavor> | Flavor to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.25. network list
List networks
Usage:
openstack network 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] [--external | --internal] [--long] [--name <name>] [--enable | --disable] [--project <project>] [--project-domain <project-domain>] [--share | --no-share] [--status <status>] [--provider-network-type <provider-network-type>] [--provider-physical-network <provider-physical-network>] [--provider-segment <provider-segment>] [--agent <agent-id>] [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
openstack network 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]
[--external | --internal] [--long]
[--name <name>] [--enable | --disable]
[--project <project>]
[--project-domain <project-domain>]
[--share | --no-share] [--status <status>]
[--provider-network-type <provider-network-type>]
[--provider-physical-network <provider-physical-network>]
[--provider-segment <provider-segment>]
[--agent <agent-id>] [--tags <tag>[,<tag>,...]]
[--any-tags <tag>[,<tag>,...]]
[--not-tags <tag>[,<tag>,...]]
[--not-any-tags <tag>[,<tag>,...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--external | List external networks |
--internal | List internal networks |
--long | List additional fields in output |
--name <name> | List networks according to their name |
--enable | List enabled networks |
--disable | List disabled networks |
--project <project> | List networks according to their project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--share | List networks shared between projects |
--no-share | List networks not shared between projects |
--status <status> | List networks according to their status (active, BUILD, DOWN, ERROR) |
--provider-network-type <provider-network-type> | List networks according to their physical mechanisms. The supported options are: flat, geneve, gre, local, vlan, vxlan. |
--provider-physical-network <provider-physical-network> | List networks according to name of the physical network |
--provider-segment <provider-segment> | List networks according to vlan id for vlan networks or Tunnel ID for GENEVE/GRE/VXLAN networks |
--agent <agent-id> | List networks hosted by agent (id only) |
--tags <tag>[,<tag>,…] | List networks which have all given tag(s) (comma- separated list of tags) |
--any-tags <tag>[,<tag>,…] | List networks which have any given tag(s) (comma- separated list of tags) |
--not-tags <tag>[,<tag>,…] | Exclude networks which have all given tag(s) (comma- separated list of tags) |
--not-any-tags <tag>[,<tag>,…] | Exclude networks which have any given tag(s) (comma- separated list of tags) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.26. network log create
Create a new network log
Usage:
openstack network log create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--enable | --disable] [--project <project>] [--project-domain <project-domain>] [--event <event>] --resource-type <resource-type> [--resource <resource>] [--target <target>] <name>
openstack network log create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description <description>]
[--enable | --disable]
[--project <project>]
[--project-domain <project-domain>]
[--event <event>] --resource-type
<resource-type> [--resource <resource>]
[--target <target>]
<name>
Value | Summary |
---|---|
<name> | Name for the network log |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of the network log |
--enable | Enable this log (default is disabled) |
--disable | Disable this log |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--event <event> | An event to store with log |
--resource-type <resource-type> | Network log type(s). you can see supported type(s) with following command: $ openstack network loggable resources list |
--resource <resource> | Name or id of resource (security group or firewall group) that used for logging. You can control for logging target combination with --target option. |
--target <target> | Port (name or id) for logging. you can control for logging target combination with --resource option. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.27. network log delete
Delete network log(s)
Usage:
openstack network log delete [-h] <network-log> [<network-log> ...]
openstack network log delete [-h] <network-log> [<network-log> ...]
Value | Summary |
---|---|
<network-log> | Network log(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.28. network log list
List network logs
Usage:
openstack network log 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]
openstack network log 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.29. network log set
Set network log properties
Usage:
openstack network log set [-h] [--description <description>] [--enable | --disable] [--name <name>] <network-log>
openstack network log set [-h] [--description <description>]
[--enable | --disable] [--name <name>]
<network-log>
Value | Summary |
---|---|
<network-log> | Network log to set (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of the network log |
--enable | Enable this log (default is disabled) |
--disable | Disable this log |
--name <name> | Name of the network log |
54.30. network log show
Display network log details
Usage:
openstack network log show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network-log>
openstack network log show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<network-log>
Value | Summary |
---|---|
<network-log> | Network log to show (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.31. network loggable resources list
List supported loggable resources
Usage:
openstack network loggable resources 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]
openstack network loggable resources 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.32. network meter create
Create network meter
Usage:
openstack network meter create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--project <project>] [--project-domain <project-domain>] [--share | --no-share] <name>
openstack network meter create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description <description>]
[--project <project>]
[--project-domain <project-domain>]
[--share | --no-share]
<name>
Value | Summary |
---|---|
<name> | Name of meter |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Create description for meter |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--share | Share meter between projects |
--no-share | Do not share meter between projects |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.33. network meter delete
Delete network meter
Usage:
openstack network meter delete [-h] <meter> [<meter> ...]
openstack network meter delete [-h] <meter> [<meter> ...]
Value | Summary |
---|---|
<meter> | Meter to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.34. network meter list
List network meters
Usage:
openstack network meter 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]
openstack network meter 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.35. network meter rule create
Create a new meter rule
Usage:
openstack network meter rule create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--project <project>] [--project-domain <project-domain>] [--exclude | --include] [--ingress | --egress] --remote-ip-prefix <remote-ip-prefix> <meter>
openstack network meter rule create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--project <project>]
[--project-domain <project-domain>]
[--exclude | --include]
[--ingress | --egress]
--remote-ip-prefix
<remote-ip-prefix>
<meter>
Value | Summary |
---|---|
<meter> | Label to associate with this metering rule (name or ID) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--exclude | Exclude remote ip prefix from traffic count |
--include | Include remote ip prefix from traffic count (default) |
--ingress | Apply rule to incoming network traffic (default) |
--egress | Apply rule to outgoing network traffic |
--remote-ip-prefix <remote-ip-prefix> | The remote ip prefix to associate with this rule |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.36. network meter rule delete
Delete meter rule(s)
Usage:
openstack network meter rule delete [-h] <meter-rule-id> [<meter-rule-id> ...]
openstack network meter rule delete [-h]
<meter-rule-id>
[<meter-rule-id> ...]
Value | Summary |
---|---|
<meter-rule-id> | Meter rule to delete (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.37. network meter rule list
List meter rules
Usage:
openstack network meter 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]
openstack network meter 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.38. network meter rule show
Display meter rules details
Usage:
openstack network meter rule show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <meter-rule-id>
openstack network meter rule show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<meter-rule-id>
Value | Summary |
---|---|
<meter-rule-id> | Meter rule (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.39. network meter show
Show network meter
Usage:
openstack network meter show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <meter>
openstack network meter show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<meter>
Value | Summary |
---|---|
<meter> | Meter to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.40. network onboard subnets
Onboard network subnets into a subnet pool
Usage:
openstack network onboard subnets [-h] <network> <subnetpool>
openstack network onboard subnets [-h] <network> <subnetpool>
Value | Summary |
---|---|
<network> | Onboard all subnets associated with this network |
<subnetpool> | Target subnet pool for onboarding subnets |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.41. network qos policy create
Create a QoS policy
Usage:
openstack network qos policy create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--share | --no-share] [--project <project>] [--project-domain <project-domain>] [--default | --no-default] <name>
openstack network qos policy create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--description <description>]
[--share | --no-share]
[--project <project>]
[--project-domain <project-domain>]
[--default | --no-default]
<name>
Value | Summary |
---|---|
<name> | Name of qos policy to create |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of the qos policy |
--share | Make the qos policy accessible by other projects |
--no-share | Make the qos policy not accessible by other projects (default) |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--default | Set this as a default network qos policy |
--no-default | Set this as a non-default network qos policy |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.42. network qos policy delete
Delete Qos Policy(s)
Usage:
openstack network qos policy delete [-h] <qos-policy> [<qos-policy> ...]
openstack network qos policy delete [-h]
<qos-policy> [<qos-policy> ...]
Value | Summary |
---|---|
<qos-policy> | Qos policy(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.43. network qos policy list
List QoS policies
Usage:
openstack network qos policy 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] [--project <project>] [--project-domain <project-domain>] [--share | --no-share]
openstack network qos policy 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]
[--project <project>]
[--project-domain <project-domain>]
[--share | --no-share]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | List qos policies according to their project (name or ID) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--share | List qos policies shared between projects |
--no-share | List qos policies not shared between projects |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.44. network qos policy set
Set QoS policy properties
Usage:
openstack network qos policy set [-h] [--name <name>] [--description <description>] [--share | --no-share] [--default | --no-default] <qos-policy>
openstack network qos policy set [-h] [--name <name>]
[--description <description>]
[--share | --no-share]
[--default | --no-default]
<qos-policy>
Value | Summary |
---|---|
<qos-policy> | Qos policy to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set qos policy name |
--description <description> | Description of the qos policy |
--share | Make the qos policy accessible by other projects |
--no-share | Make the qos policy not accessible by other projects |
--default | Set this as a default network qos policy |
--no-default | Set this as a non-default network qos policy |
54.45. network qos policy show
Display QoS policy details
Usage:
openstack network qos policy show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <qos-policy>
openstack network qos policy show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<qos-policy>
Value | Summary |
---|---|
<qos-policy> | Qos policy to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.46. network qos rule create
Create new Network QoS rule
Usage:
openstack network qos rule create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type <type>] [--max-kbps <max-kbps>] [--max-burst-kbits <max-burst-kbits>] [--dscp-mark <dscp-mark>] [--min-kbps <min-kbps>] [--ingress | --egress] <qos-policy>
openstack network qos rule create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--type <type>]
[--max-kbps <max-kbps>]
[--max-burst-kbits <max-burst-kbits>]
[--dscp-mark <dscp-mark>]
[--min-kbps <min-kbps>]
[--ingress | --egress]
<qos-policy>
Value | Summary |
---|---|
<qos-policy> | Qos policy that contains the rule (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | Qos rule type (minimum-bandwidth, dscp-marking, bandwidth-limit) |
--max-kbps <max-kbps> | Maximum bandwidth in kbps |
--max-burst-kbits <max-burst-kbits> | Maximum burst in kilobits, 0 or not specified means automatic, which is 80% of the bandwidth limit, which works for typical TCP traffic. For details check the QoS user workflow. |
--dscp-mark <dscp-mark> | Dscp mark: value can be 0, even numbers from 8-56, excluding 42, 44, 50, 52, and 54 |
--min-kbps <min-kbps> | Minimum guaranteed bandwidth in kbps |
--ingress | Ingress traffic direction from the project point of view |
--egress | Egress traffic direction from the project point of view |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.47. network qos rule delete
Delete Network QoS rule
Usage:
openstack network qos rule delete [-h] <qos-policy> <rule-id>
openstack network qos rule delete [-h] <qos-policy> <rule-id>
Value | Summary |
---|---|
<qos-policy> | Qos policy that contains the rule (name or id) |
<rule-id> | Network qos rule to delete (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.48. network qos rule list
List Network QoS rules
Usage:
openstack network qos 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] <qos-policy>
openstack network qos 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]
<qos-policy>
Value | Summary |
---|---|
<qos-policy> | Qos policy that contains the rule (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.49. network qos rule set
Set Network QoS rule properties
Usage:
openstack network qos rule set [-h] [--max-kbps <max-kbps>] [--max-burst-kbits <max-burst-kbits>] [--dscp-mark <dscp-mark>] [--min-kbps <min-kbps>] [--ingress | --egress] <qos-policy> <rule-id>
openstack network qos rule set [-h] [--max-kbps <max-kbps>]
[--max-burst-kbits <max-burst-kbits>]
[--dscp-mark <dscp-mark>]
[--min-kbps <min-kbps>]
[--ingress | --egress]
<qos-policy> <rule-id>
Value | Summary |
---|---|
<qos-policy> | Qos policy that contains the rule (name or id) |
<rule-id> | Network qos rule to delete (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--max-kbps <max-kbps> | Maximum bandwidth in kbps |
--max-burst-kbits <max-burst-kbits> | Maximum burst in kilobits, 0 or not specified means automatic, which is 80% of the bandwidth limit, which works for typical TCP traffic. For details check the QoS user workflow. |
--dscp-mark <dscp-mark> | Dscp mark: value can be 0, even numbers from 8-56, excluding 42, 44, 50, 52, and 54 |
--min-kbps <min-kbps> | Minimum guaranteed bandwidth in kbps |
--ingress | Ingress traffic direction from the project point of view |
--egress | Egress traffic direction from the project point of view |
54.50. network qos rule show
Display Network QoS rule details
Usage:
openstack network qos rule show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <qos-policy> <rule-id>
openstack network qos rule show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<qos-policy> <rule-id>
Value | Summary |
---|---|
<qos-policy> | Qos policy that contains the rule (name or id) |
<rule-id> | Network qos rule to delete (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.51. network qos rule type list
List QoS rule types
Usage:
openstack network qos rule type 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]
openstack network qos rule type 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.52. network qos rule type show
Show details about supported QoS rule type
Usage:
openstack network qos rule type show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <qos-rule-type-name>
openstack network qos rule type show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<qos-rule-type-name>
Value | Summary |
---|---|
<qos-rule-type-name> | Name of qos rule type |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.53. network rbac create
Create network RBAC policy
Usage:
openstack network rbac create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --type <type> --action <action> (--target-project <target-project> | --target-all-projects) [--target-project-domain <target-project-domain>] [--project <project>] [--project-domain <project-domain>] <rbac-object>
openstack network rbac create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX] [--max-width <integer>]
[--fit-width] [--print-empty] --type
<type> --action <action>
(--target-project <target-project> | --target-all-projects)
[--target-project-domain <target-project-domain>]
[--project <project>]
[--project-domain <project-domain>]
<rbac-object>
Value | Summary |
---|---|
<rbac-object> | The object to which this rbac policy affects (name or ID) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | Type of the object that rbac policy affects ("qos_policy" or "network") |
--action <action> | Action for the rbac policy ("access_as_external" or "access_as_shared") |
--target-project <target-project> | The project to which the rbac policy will be enforced (name or ID) |
--target-all-projects | Allow creating rbac policy for all projects. |
--target-project-domain <target-project-domain> | Domain the target project belongs to (name or id). This can be used in case collisions between project names exist. |
--project <project> | The owner project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.54. network rbac delete
Delete network RBAC policy(s)
Usage:
openstack network rbac delete [-h] <rbac-policy> [<rbac-policy> ...]
openstack network rbac delete [-h] <rbac-policy> [<rbac-policy> ...]
Value | Summary |
---|---|
<rbac-policy> | Rbac policy(s) to delete (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.55. network rbac list
List network RBAC policies
Usage:
openstack network rbac 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>] [--action <action>] [--long]
openstack network rbac 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>]
[--action <action>] [--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | List network rbac policies according to given object type ("qos_policy" or "network") |
--action <action> | List network rbac policies according to given action ("access_as_external" or "access_as_shared") |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.56. network rbac set
Set network RBAC policy properties
Usage:
openstack network rbac set [-h] [--target-project <target-project>] [--target-project-domain <target-project-domain>] <rbac-policy>
openstack network rbac set [-h] [--target-project <target-project>]
[--target-project-domain <target-project-domain>]
<rbac-policy>
Value | Summary |
---|---|
<rbac-policy> | Rbac policy to be modified (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--target-project <target-project> | The project to which the rbac policy will be enforced (name or ID) |
--target-project-domain <target-project-domain> | Domain the target project belongs to (name or id). This can be used in case collisions between project names exist. |
54.57. network rbac show
Display network RBAC policy details
Usage:
openstack network rbac show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <rbac-policy>
openstack network rbac show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<rbac-policy>
Value | Summary |
---|---|
<rbac-policy> | Rbac policy (id only) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.58. network segment create
Create new network segment
Usage:
openstack network segment create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--physical-network <physical-network>] [--segment <segment>] --network <network> --network-type <network-type> <name>
openstack network segment create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description <description>]
[--physical-network <physical-network>]
[--segment <segment>] --network
<network> --network-type
<network-type>
<name>
Value | Summary |
---|---|
<name> | New network segment name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Network segment description |
--physical-network <physical-network> | Physical network name of this network segment |
--segment <segment> | Segment identifier for this network segment which is based on the network type, VLAN ID for vlan network type and tunnel ID for geneve, gre and vxlan network types |
--network <network> | Network this network segment belongs to (name or id) |
--network-type <network-type> | Network type of this network segment (flat, geneve, gre, local, vlan or vxlan) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.59. network segment delete
Delete network segment(s)
Usage:
openstack network segment delete [-h] <network-segment> [<network-segment> ...]
openstack network segment delete [-h]
<network-segment>
[<network-segment> ...]
Value | Summary |
---|---|
<network-segment> | Network segment(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.60. network segment list
List network segments
Usage:
openstack network segment 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] [--network <network>]
openstack network segment 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]
[--network <network>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
--network <network> | List network segments that belong to this network (name or ID) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.61. network segment range create
Create new network segment range
Usage:
openstack network segment range create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--private | --shared] [--project <project>] [--project-domain <project-domain>] --network-type <network-type> [--physical-network <physical-network-name>] --minimum <minimum-segmentation-id> --maximum <maximum-segmentation-id> <name>
openstack network segment range create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--private | --shared]
[--project <project>]
[--project-domain <project-domain>]
--network-type <network-type>
[--physical-network <physical-network-name>]
--minimum
<minimum-segmentation-id>
--maximum
<maximum-segmentation-id>
<name>
Value | Summary |
---|---|
<name> | Name of new network segment range |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--private | Network segment range is assigned specifically to the project |
--shared | Network segment range is shared with other projects |
--project <project> | Network segment range owner (name or id). optional when the segment range is shared |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--network-type <network-type> | Network type of this network segment range (geneve, gre, vlan or vxlan) |
--physical-network <physical-network-name> | Physical network name of this network segment range |
--minimum <minimum-segmentation-id> | Minimum segment identifier for this network segment range which is based on the network type, VLAN ID for vlan network type and tunnel ID for geneve, gre and vxlan network types |
--maximum <maximum-segmentation-id> | Maximum segment identifier for this network segment range which is based on the network type, VLAN ID for vlan network type and tunnel ID for geneve, gre and vxlan network types |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.62. network segment range delete
Delete network segment range(s)
Usage:
openstack network segment range delete [-h] <network-segment-range> [<network-segment-range> ...]
openstack network segment range delete [-h]
<network-segment-range>
[<network-segment-range> ...]
Value | Summary |
---|---|
<network-segment-range> | Network segment range(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.63. network segment range list
List network segment ranges
Usage:
openstack network segment range 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] [--used | --unused] [--available | --unavailable]
openstack network segment range 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] [--used | --unused]
[--available | --unavailable]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
--used | List network segment ranges that have segments in use |
--unused | List network segment ranges that have segments not in use |
--available | List network segment ranges that have available segments |
--unavailable | List network segment ranges without available segments |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.64. network segment range set
Set network segment range properties
Usage:
openstack network segment range set [-h] [--name <name>] [--minimum <minimum-segmentation-id>] [--maximum <maximum-segmentation-id>] <network-segment-range>
openstack network segment range set [-h] [--name <name>]
[--minimum <minimum-segmentation-id>]
[--maximum <maximum-segmentation-id>]
<network-segment-range>
Value | Summary |
---|---|
<network-segment-range> | Network segment range to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set network segment name |
--minimum <minimum-segmentation-id> | Set network segment range minimum segment identifier |
--maximum <maximum-segmentation-id> | Set network segment range maximum segment identifier |
54.65. network segment range show
Display network segment range details
Usage:
openstack network segment range show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network-segment-range>
openstack network segment range show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<network-segment-range>
Value | Summary |
---|---|
<network-segment-range> | Network segment range to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.66. network segment set
Set network segment properties
Usage:
openstack network segment set [-h] [--description <description>] [--name <name>] <network-segment>
openstack network segment set [-h] [--description <description>]
[--name <name>]
<network-segment>
Value | Summary |
---|---|
<network-segment> | Network segment to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Set network segment description |
--name <name> | Set network segment name |
54.67. network segment show
Display network segment details
Usage:
openstack network segment show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network-segment>
openstack network segment show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<network-segment>
Value | Summary |
---|---|
<network-segment> | Network segment to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.68. network service provider list
List Service Providers
Usage:
openstack network service provider 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]
openstack network service provider 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.69. network set
Set network properties
Usage:
openstack network set [-h] [--name <name>] [--enable | --disable] [--share | --no-share] [--description <description] [--mtu <mtu] [--enable-port-security | --disable-port-security] [--external | --internal] [--default | --no-default] [--qos-policy <qos-policy> | --no-qos-policy] [--tag <tag>] [--no-tag] [--provider-network-type <provider-network-type>] [--provider-physical-network <provider-physical-network>] [--provider-segment <provider-segment>] [--dns-domain <dns-domain>] <network>
openstack network set [-h] [--name <name>] [--enable | --disable]
[--share | --no-share]
[--description <description] [--mtu <mtu]
[--enable-port-security | --disable-port-security]
[--external | --internal]
[--default | --no-default]
[--qos-policy <qos-policy> | --no-qos-policy]
[--tag <tag>] [--no-tag]
[--provider-network-type <provider-network-type>]
[--provider-physical-network <provider-physical-network>]
[--provider-segment <provider-segment>]
[--dns-domain <dns-domain>]
<network>
Value | Summary |
---|---|
<network> | Network to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set network name |
--enable | Enable network |
--disable | Disable network |
--share | Share the network between projects |
--no-share | Do not share the network between projects |
--description <description | Set network description |
--mtu <mtu | Set network mtu |
--enable-port-security | Enable port security by default for ports created on this network |
--disable-port-security | Disable port security by default for ports created on this network |
--external | Set this network as an external network (external-net extension required) |
--internal | Set this network as an internal network |
--default | Set the network as the default external network |
--no-default | Do not use the network as the default external network |
--qos-policy <qos-policy> | Qos policy to attach to this network (name or id) |
--no-qos-policy | Remove the qos policy attached to this network |
--tag <tag> | Tag to be added to the network (repeat option to set multiple tags) |
--no-tag | Clear tags associated with the network. specify both --tag and --no-tag to overwrite current tags |
--provider-network-type <provider-network-type> | The physical mechanism by which the virtual network is implemented. For example: flat, geneve, gre, local, vlan, vxlan. |
--provider-physical-network <provider-physical-network> | Name of the physical network over which the virtual network is implemented |
--provider-segment <provider-segment> | Vlan id for vlan networks or tunnel id for GENEVE/GRE/VXLAN networks |
--dns-domain <dns-domain> | Set dns domain for this network (requires dns integration extension) |
54.70. network show
Show network details
Usage:
openstack network show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <network>
openstack network show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<network>
Value | Summary |
---|---|
<network> | Network to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.71. network subport list
List all subports for a given network trunk
Usage:
openstack network subport 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] --trunk <trunk>
openstack network subport 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] --trunk
<trunk>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--trunk <trunk> | List subports belonging to this trunk (name or id) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.72. network trunk create
Create a network trunk for a given project
Usage:
openstack network trunk create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] --parent-port <parent-port> [--subport <port=,segmentation-type=,segmentation-id=>] [--enable | --disable] [--project <project>] [--project-domain <project-domain>] <name>
openstack network trunk create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description <description>]
--parent-port <parent-port>
[--subport <port=,segmentation-type=,segmentation-id=>]
[--enable | --disable]
[--project <project>]
[--project-domain <project-domain>]
<name>
Value | Summary |
---|---|
<name> | Name of the trunk to create |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | A description of the trunk |
--parent-port <parent-port> | Parent port belonging to this trunk (name or id) |
--subport <port=,segmentation-type=,segmentation-id⇒ | Subport to add. subport is of form port=<name or ID>,segmentation-type=,segmentation-ID= (--subport) option can be repeated |
--enable | Enable trunk (default) |
--disable | Disable trunk |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.73. network trunk delete
Delete a given network trunk
Usage:
openstack network trunk delete [-h] <trunk> [<trunk> ...]
openstack network trunk delete [-h] <trunk> [<trunk> ...]
Value | Summary |
---|---|
<trunk> | Trunk(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
54.74. network trunk list
List all network trunks
Usage:
openstack network trunk 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]
openstack network trunk 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.75. network trunk set
Set network trunk properties
Usage:
openstack network trunk set [-h] [--name <name>] [--description <description>] [--subport <port=,segmentation-type=,segmentation-id=>] [--enable | --disable] <trunk>
openstack network trunk set [-h] [--name <name>]
[--description <description>]
[--subport <port=,segmentation-type=,segmentation-id=>]
[--enable | --disable]
<trunk>
Value | Summary |
---|---|
<trunk> | Trunk to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set trunk name |
--description <description> | A description of the trunk |
--subport <port=,segmentation-type=,segmentation-id⇒ | Subport to add. subport is of form port=<name or ID>,segmentation-type=,segmentation-ID=(--subport) option can be repeated |
--enable | Enable trunk |
--disable | Disable trunk |
54.76. network trunk show
Show information of a given network trunk
Usage:
openstack network trunk show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <trunk>
openstack network trunk show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<trunk>
Value | Summary |
---|---|
<trunk> | Trunk to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
54.77. network trunk unset
Unset subports from a given network trunk
Usage:
openstack network trunk unset [-h] --subport <subport> <trunk>
openstack network trunk unset [-h] --subport <subport> <trunk>
Value | Summary |
---|---|
<trunk> | Unset subports from this trunk (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--subport <subport> | Subport to delete (name or id of the port) (--subport) option can be repeated |
54.78. network unset
Unset network properties
Usage:
openstack network unset [-h] [--tag <tag> | --all-tag] <network>
openstack network unset [-h] [--tag <tag> | --all-tag] <network>
Value | Summary |
---|---|
<network> | Network to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--tag <tag> | Tag to be removed from the network (repeat option to remove multiple tags) |
--all-tag | Clear all tags associated with the network |
Chapter 55. object
This chapter describes the commands under the object
command.
55.1. object create
Upload object to container
Usage:
openstack object 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] [--name <name>] <container> <filename> [<filename> ...]
openstack object 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] [--name <name>]
<container> <filename> [<filename> ...]
Value | Summary |
---|---|
<container> | Container for new object |
<filename> | Local filename(s) to upload |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Upload a file and rename it. can only be used when uploading a single object |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
55.2. object delete
Delete object from container
Usage:
openstack object delete [-h] <container> <object> [<object> ...]
openstack object delete [-h] <container> <object> [<object> ...]
Value | Summary |
---|---|
<container> | Delete object(s) from <container> |
<object> | Object(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
55.3. object list
List objects
Usage:
openstack object 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] [--prefix <prefix>] [--delimiter <delimiter>] [--marker <marker>] [--end-marker <end-marker>] [--limit <num-objects>] [--long] [--all] <container>
openstack object 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] [--prefix <prefix>]
[--delimiter <delimiter>] [--marker <marker>]
[--end-marker <end-marker>]
[--limit <num-objects>] [--long] [--all]
<container>
Value | Summary |
---|---|
<container> | Container to list |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--prefix <prefix> | Filter list using <prefix> |
--delimiter <delimiter> | Roll up items with <delimiter> |
--marker <marker> | Anchor for paging |
--end-marker <end-marker> | End anchor for paging |
--limit <num-objects> | Limit the number of objects returned |
--long | List additional fields in output |
--all | List all objects in container (default is 10000) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
55.4. object save
Save object locally
Usage:
openstack object save [-h] [--file <filename>] <container> <object>
openstack object save [-h] [--file <filename>] <container> <object>
Value | Summary |
---|---|
<container> | Download <object> from <container> |
<object> | Object to save |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--file <filename> | Destination filename (defaults to object name); using - as the filename will print the file to stdout |
55.5. object set
Set object properties
Usage:
openstack object set [-h] --property <key=value> <container> <object>
openstack object set [-h] --property <key=value> <container> <object>
Value | Summary |
---|---|
<container> | Modify <object> from <container> |
<object> | Object to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key=value> | Set a property on this object (repeat option to set multiple properties) |
55.6. object show
Display object details
Usage:
openstack object show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <container> <object>
openstack object show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<container> <object>
Value | Summary |
---|---|
<container> | Display <object> from <container> |
<object> | Object to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
55.7. object store account set
Set account properties
Usage:
openstack object store account set [-h] --property <key=value>
openstack object store account set [-h] --property <key=value>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key=value> | Set a property on this account (repeat option to set multiple properties) |
55.8. object store account show
Display account details
Usage:
openstack object store account show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack object store account show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
55.9. object store account unset
Unset account properties
Usage:
openstack object store account unset [-h] --property <key>
openstack object store account unset [-h] --property <key>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key> | Property to remove from account (repeat option to remove multiple properties) |
55.10. object unset
Unset object properties
Usage:
openstack object unset [-h] --property <key> <container> <object>
openstack object unset [-h] --property <key> <container> <object>
Value | Summary |
---|---|
<container> | Modify <object> from <container> |
<object> | Object to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key> | Property to remove from object (repeat option to remove multiple properties) |
Chapter 56. orchestration
This chapter describes the commands under the orchestration
command.
56.1. orchestration build info
Retrieve build information.
Usage:
openstack orchestration build info [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
openstack orchestration build info [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
56.2. orchestration resource type list
List resource types.
Usage:
openstack orchestration resource type 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] [--filter <key=value>] [--long]
openstack orchestration resource type 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]
[--filter <key=value>]
[--long]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--filter <key=value> | Filter parameters to apply on returned resource types. This can be specified multiple times. It can be any of name, version or support_status |
--long | Show resource types with corresponding description of each resource type. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
56.3. orchestration resource type show
Show details and optionally generate a template for a resource type.
Usage:
openstack orchestration resource type show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--template-type <template-type>] [--long] <resource-type>
openstack orchestration resource type show [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--template-type <template-type>]
[--long]
<resource-type>
Value | Summary |
---|---|
<resource-type> | Resource type to show details for |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--template-type <template-type> | Optional template type to generate, hot or cfn |
--long | Show resource type with corresponding description. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to yaml |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
56.4. orchestration service list
List the Heat engines.
Usage:
openstack orchestration service 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]
openstack orchestration service 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
56.5. orchestration template function list
List the available functions.
Usage:
openstack orchestration template function 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] [--with_conditions] <template-version>
openstack orchestration template function 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]
[--with_conditions]
<template-version>
Value | Summary |
---|---|
<template-version> | Template version to get the functions for |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--with_conditions | Show condition functions for template. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
56.6. orchestration template validate
Validate a template
Usage:
openstack orchestration template validate [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [-e <environment>] [--show-nested] [--parameter <key=value>] [--ignore-errors <error1,error2,...>] -t <template>
openstack orchestration template validate [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
[-e <environment>]
[--show-nested]
[--parameter <key=value>]
[--ignore-errors <error1,error2,...>]
-t <template>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-e <environment>, --environment <environment> | Path to the environment. can be specified multiple times |
--show-nested | Resolve parameters from nested templates as well |
--parameter <key=value> | Parameter values used to create the stack. this can be specified multiple times |
--ignore-errors <error1,error2,…> | List of heat errors to ignore |
-t <template>, --template <template> | Path to the template |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to yaml |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
56.7. orchestration template version list
List the available template versions.
Usage:
openstack orchestration template version 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]
openstack orchestration template version 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 57. overcloud
This chapter describes the commands under the overcloud
command.
57.1. overcloud admin authorize
Deploy the ssh keys needed by Mistral.
Usage:
openstack overcloud admin authorize [-h] [--stack STACK] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
openstack overcloud admin authorize [-h] [--stack STACK]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
57.2. overcloud config download
Download Overcloud Config
Usage:
openstack overcloud config download [-h] [--name NAME] [--config-dir CONFIG_DIR] [--config-type CONFIG_TYPE] [--no-preserve-config]
openstack overcloud config download [-h] [--name NAME]
[--config-dir CONFIG_DIR]
[--config-type CONFIG_TYPE]
[--no-preserve-config]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME | The name of the plan, which is used for the object storage container, workflow environment and orchestration stack names. |
--config-dir CONFIG_DIR | The directory where the configuration files will be pushed |
--config-type CONFIG_TYPE | Type of object config to be extract from the deployment, defaults to all keys available |
--no-preserve-config | If specified, will delete and recreate the --config- dir if it already exists. Default is to use the existing dir location and overwrite files. Files in --config-dir not from the stack will be preserved by default. |
57.3. overcloud container image build
Build overcloud container images with kolla-build.
Usage:
openstack overcloud container image build [-h] [--config-file <yaml config file>] --kolla-config-file <config file> [--list-images] [--list-dependencies] [--exclude <container-name>] [--use-buildah]
openstack overcloud container image build [-h]
[--config-file <yaml config file>]
--kolla-config-file <config
file> [--list-images]
[--list-dependencies]
[--exclude <container-name>]
[--use-buildah]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--config-file <yaml config file> | Yaml config file specifying the images to build. may be specified multiple times. Order is preserved, and later files will override some options in previous files. Other options will append. If not specified, the default set of containers will be built. |
--kolla-config-file <config file> | Path to a kolla config file to use. multiple config files can be specified, with values in later files taking precedence. By default, tripleo kolla conf file /usr/share/tripleo-common/container- images/tripleo_kolla_config_overrides.conf is added. |
--list-images | Show the images which would be built instead of building them. |
--list-dependencies | Show the image build dependencies instead of building them. |
--exclude <container-name> | Name of a container to match against the list of containers to be built to skip. Can be specified multiple times. |
--use-buildah | Use buildah instead of docker to build the images with Kolla. |
57.4. overcloud container image prepare
Generate files defining the images, tags and registry.
Usage:
openstack overcloud container image prepare [-h] [--template-file <yaml template file>] [--pull-source <location>] [--push-destination <location>] [--tag <tag>] [--tag-from-label <image label>] [--namespace <namespace>] [--prefix <prefix>] [--suffix <suffix>] [--set <variable=value>] [--exclude <regex>] [--include <regex>] [--output-images-file <file path>] [--environment-file <file path>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--output-env-file <file path>] [--roles-file ROLES_FILE] [--modify-role MODIFY_ROLE] [--modify-vars MODIFY_VARS]
openstack overcloud container image prepare [-h]
[--template-file <yaml template file>]
[--pull-source <location>]
[--push-destination <location>]
[--tag <tag>]
[--tag-from-label <image label>]
[--namespace <namespace>]
[--prefix <prefix>]
[--suffix <suffix>]
[--set <variable=value>]
[--exclude <regex>]
[--include <regex>]
[--output-images-file <file path>]
[--environment-file <file path>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--output-env-file <file path>]
[--roles-file ROLES_FILE]
[--modify-role MODIFY_ROLE]
[--modify-vars MODIFY_VARS]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--template-file <yaml template file> | Yaml template file which the images config file will be built from. Default: /usr/share/tripleo-common/container- images/overcloud_containers.yaml.j2 |
--pull-source <location> | Location of image registry to pull images from. (DEPRECATED. Include the registry in --namespace) |
--push-destination <location> | Location of image registry to push images to. if specified, a push_destination will be set for every image entry. |
--tag <tag> | Override the default tag substitution. if --tag-from- label is specified, start discovery with this tag. Default: 15.0 |
--tag-from-label <image label> | Use the value of the specified label(s) to discover the tag. Labels can be combined in a template format, for example: {version}-{release} |
--namespace <namespace> | Override the default namespace substitution. Default: registry.redhat.io/rhosp15-rhel8 |
--prefix <prefix> | Override the default name prefix substitution. Default: openstack- |
--suffix <suffix> | Override the default name suffix substitution. Default: |
--set <variable=value> | Set the value of a variable in the template, even if it has no dedicated argument such as "--suffix". |
--exclude <regex> | Pattern to match against resulting imagename entries to exclude from the final output. Can be specified multiple times. |
--include <regex> | Pattern to match against resulting imagename entries to include in final output. Can be specified multiple times, entries not matching any --include will be excluded. --exclude is ignored if --include is used. |
--output-images-file <file path> | File to write resulting image entries to, as well as stdout. Any existing file will be overwritten. |
--environment-file <file path>, -e <file path> | Environment files specifying which services are containerized. Entries will be filtered to only contain images used by containerized services. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the update command. Entries will be filtered to only contain images used by containerized services. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--output-env-file <file path> | File to write heat environment file which specifies all image parameters. Any existing file will be overwritten. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the t-h-t templates directory used for deployment. May be an absolute path or the path relative to the templates dir. |
--modify-role MODIFY_ROLE | Name of ansible role to run between every image upload pull and push. |
--modify-vars MODIFY_VARS | Ansible variable file containing variables to use when invoking the role --modify-role. |
57.5. overcloud container image tag discover
Discover the versioned tag for an image.
Usage:
openstack overcloud container image tag discover [-h] --image <container image> [--tag-from-label <image label>]
openstack overcloud container image tag discover [-h] --image
<container image>
[--tag-from-label <image label>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--image <container image> | Fully qualified name of the image to discover the tag for (Including registry and stable tag). |
--tag-from-label <image label> | Use the value of the specified label(s) to discover the tag. Labels can be combined in a template format, for example: {version}-{release} |
57.6. overcloud container image upload
Push overcloud container images to registries.
Usage:
openstack overcloud container image upload [-h] --config-file <yaml config file> [--cleanup <full, partial, none>]
openstack overcloud container image upload [-h] --config-file <yaml
config file>
[--cleanup <full, partial, none>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--config-file <yaml config file> | Yaml config file specifying the image build. may be specified multiple times. Order is preserved, and later files will override some options in previous files. Other options will append. |
--cleanup <full, partial, none> | Cleanup behavior for local images left after upload. The default full will attempt to delete all local images. partial will leave images required for deployment on this host. none will do no cleanup. |
57.7. overcloud credentials
Create the overcloudrc files
Usage:
openstack overcloud credentials [-h] [--directory [DIRECTORY]] plan
openstack overcloud credentials [-h] [--directory [DIRECTORY]] plan
Value | Summary |
---|---|
plan | The name of the plan you want to create rc files for. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--directory [DIRECTORY] | The directory to create the rc files. defaults to the current directory. |
57.8. overcloud delete
Delete overcloud stack and plan
Usage:
openstack overcloud delete [-h] [-y] [stack]
openstack overcloud delete [-h] [-y] [stack]
Value | Summary |
---|---|
stack | Name or id of heat stack to delete(default=env: OVERCLOUD_STACK_NAME) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-y, --yes | Skip yes/no prompt (assume yes). |
57.9. overcloud deploy
Deploy Overcloud
Usage:
openstack overcloud deploy [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
openstack overcloud deploy [--templates [TEMPLATES]] [--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup] [--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations] [--dry-run]
[--run-validations] [--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier] [--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG] [--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server] [--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.10. overcloud execute
Execute a Heat software config on the servers.
Usage:
openstack overcloud execute [-h] [-s SERVER_NAME] [-g GROUP] file_in
openstack overcloud execute [-h] [-s SERVER_NAME] [-g GROUP] file_in
Value | Summary |
---|---|
file_in | None |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-s SERVER_NAME, --server_name SERVER_NAME | Nova server_name or partial name to match. |
-g GROUP, --group GROUP | Heat software config "group" type. defaults to "script". |
57.11. overcloud external-update run
Run external minor update Ansible playbook This will run the external minor update Ansible playbook, executing tasks from the undercloud. The update playbooks are made available after completion of the overcloud update prepare command.
Usage:
openstack overcloud external-update run [-h] [--static-inventory STATIC_INVENTORY] [--ssh-user SSH_USER] [--tags TAGS] [--skip-tags SKIP_TAGS] [--stack STACK] [-e EXTRA_VARS]
openstack overcloud external-update run [-h]
[--static-inventory STATIC_INVENTORY]
[--ssh-user SSH_USER]
[--tags TAGS]
[--skip-tags SKIP_TAGS]
[--stack STACK] [-e EXTRA_VARS]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--static-inventory STATIC_INVENTORY | Path to an existing ansible inventory to use. if not specified, one will be generated in ~/tripleo-ansible- inventory.yaml |
--ssh-user SSH_USER | Deprecated: only tripleo-admin should be used as ssh user. |
--tags TAGS | A string specifying the tag or comma separated list of tags to be passed as --tags to ansible-playbook. |
--skip-tags SKIP_TAGS | A string specifying the tag or comma separated list of tags to be passed as --skip-tags to ansible-playbook. |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
-e EXTRA_VARS, --extra-vars EXTRA_VARS | Set additional variables as key=value or yaml/json |
57.12. overcloud external-upgrade run
Run external major upgrade Ansible playbook This will run the external major upgrade Ansible playbook, executing tasks from the undercloud. The upgrade playbooks are made available after completion of the overcloud upgrade prepare command.
Usage:
openstack overcloud external-upgrade run [-h] [--static-inventory STATIC_INVENTORY] [--ssh-user SSH_USER] [--tags TAGS] [--skip-tags SKIP_TAGS] [--stack STACK] [-e EXTRA_VARS]
openstack overcloud external-upgrade run [-h]
[--static-inventory STATIC_INVENTORY]
[--ssh-user SSH_USER]
[--tags TAGS]
[--skip-tags SKIP_TAGS]
[--stack STACK]
[-e EXTRA_VARS]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--static-inventory STATIC_INVENTORY | Path to an existing ansible inventory to use. if not specified, one will be generated in ~/tripleo-ansible- inventory.yaml |
--ssh-user SSH_USER | Deprecated: only tripleo-admin should be used as ssh user. |
--tags TAGS | A string specifying the tag or comma separated list of tags to be passed as --tags to ansible-playbook. |
--skip-tags SKIP_TAGS | A string specifying the tag or comma separated list of tags to be passed as --skip-tags to ansible-playbook. |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
-e EXTRA_VARS, --extra-vars EXTRA_VARS | Set additional variables as key=value or yaml/json |
57.13. overcloud failures
Get deployment failures
Usage:
openstack overcloud failures [-h] [--plan PLAN]
openstack overcloud failures [-h] [--plan PLAN]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--plan PLAN, --stack PLAN | Name of the stack/plan. (default: overcloud) |
57.14. overcloud ffwd-upgrade converge
Converge the fast-forward upgrade on Overcloud Nodes This is the last step for completion of a fast forward upgrade. The main task is updating the plan and stack to unblock future stack updates. For the ffwd upgrade workflow we have set and used the config-download Software/Structured Deployment for the OS::TripleO and OS::Heat resources. This unsets those back to their default values.
Usage:
openstack overcloud ffwd-upgrade converge [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER] [--yes]
openstack overcloud ffwd-upgrade converge [--templates [TEMPLATES]]
[--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup]
[--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations]
[--dry-run]
[--run-validations]
[--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier]
[--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG]
[--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server]
[--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
[--yes]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
--yes | Use --yes to skip the confirmation required before any ffwd-upgrade operation. Use this with caution! |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.15. overcloud ffwd-upgrade prepare
Run heat stack update for overcloud nodes to refresh heat stack outputs. The heat stack outputs are what we use later on to generate ansible playbooks which deliver the ffwd upgrade workflow. This is used as the first step for a fast forward upgrade of your overcloud.
Usage:
openstack overcloud ffwd-upgrade prepare [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER] [--yes]
openstack overcloud ffwd-upgrade prepare [--templates [TEMPLATES]]
[--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup]
[--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations]
[--dry-run]
[--run-validations]
[--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier]
[--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG]
[--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server]
[--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
[--yes]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
--yes | Use --yes to skip the confirmation required before any ffwd-upgrade operation. Use this with caution! |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.16. overcloud ffwd-upgrade run
Run fast forward upgrade ansible playbooks on Overcloud nodes This will run the fast_forward_upgrade_playbook.yaml ansible playbook. This playbook was generated when you ran the ffwd-upgrade prepare command. Running 'ffwd- upgrade run ' is the second step in the ffwd upgrade workflow.
Usage:
openstack overcloud ffwd-upgrade run [-h] [--yes] [--static-inventory STATIC_INVENTORY] [--ssh-user SSH_USER] [--stack STACK]
openstack overcloud ffwd-upgrade run [-h] [--yes]
[--static-inventory STATIC_INVENTORY]
[--ssh-user SSH_USER]
[--stack STACK]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--yes | Use --yes to skip the confirmation required before any ffwd-upgrade operation. Use this with caution! |
--static-inventory STATIC_INVENTORY | Path to an existing ansible inventory to use. if not specified, one will be generated in ~/tripleo-ansible- inventory.yaml |
--ssh-user SSH_USER | Deprecated: only tripleo-admin should be used as ssh user. |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
57.17. overcloud generate fencing
Generate fencing parameters
Usage:
openstack overcloud generate fencing [-h] [-a FENCE_ACTION] [--delay DELAY] [--ipmi-lanplus] [--ipmi-no-lanplus] [--ipmi-cipher IPMI_CIPHER] [--ipmi-level IPMI_LEVEL] [--output OUTPUT] instackenv
openstack overcloud generate fencing [-h] [-a FENCE_ACTION]
[--delay DELAY] [--ipmi-lanplus]
[--ipmi-no-lanplus]
[--ipmi-cipher IPMI_CIPHER]
[--ipmi-level IPMI_LEVEL]
[--output OUTPUT]
instackenv
Value | Summary |
---|---|
instackenv | None |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-a FENCE_ACTION, --action FENCE_ACTION | Deprecated: this option is ignored. |
--delay DELAY | Wait delay seconds before fencing is started |
--ipmi-lanplus | Deprecated: this is the default. |
--ipmi-no-lanplus | Do not use lanplus. defaults to: false |
--ipmi-cipher IPMI_CIPHER | Ciphersuite to use (same as ipmitool -c parameter. |
--ipmi-level IPMI_LEVEL | Privilegel level on ipmi device. valid levels: callback, user, operator, administrator. |
--output OUTPUT | Write parameters to a file |
57.18. overcloud image build
Build images for the overcloud
Usage:
openstack overcloud image build [-h] [--config-file <yaml config file>] [--image-name <image name>] [--no-skip] [--output-directory OUTPUT_DIRECTORY]
openstack overcloud image build [-h] [--config-file <yaml config file>]
[--image-name <image name>] [--no-skip]
[--output-directory OUTPUT_DIRECTORY]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--config-file <yaml config file> | Yaml config file specifying the image build. may be specified multiple times. Order is preserved, and later files will override some options in previous files. Other options will append. |
--image-name <image name> | Name of image to build. may be specified multiple times. If unspecified, will build all images in given YAML files. |
--no-skip | Skip build if cached image exists. |
--output-directory OUTPUT_DIRECTORY | Output directory for images. defaults to $TRIPLEO_ROOT,or current directory if unset. |
57.19. overcloud image upload
Create overcloud glance images from existing image files.
Usage:
openstack overcloud image upload [-h] [--image-path IMAGE_PATH] [--os-image-name OS_IMAGE_NAME] [--ironic-python-agent-name IPA_NAME] [--http-boot HTTP_BOOT] [--update-existing] [--whole-disk] [--architecture ARCHITECTURE] [--platform PLATFORM] [--image-type {os,ironic-python-agent}] [--progress]
openstack overcloud image upload [-h] [--image-path IMAGE_PATH]
[--os-image-name OS_IMAGE_NAME]
[--ironic-python-agent-name IPA_NAME]
[--http-boot HTTP_BOOT]
[--update-existing] [--whole-disk]
[--architecture ARCHITECTURE]
[--platform PLATFORM]
[--image-type {os,ironic-python-agent}]
[--progress]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--image-path IMAGE_PATH | Path to directory containing image files |
--os-image-name OS_IMAGE_NAME | Openstack disk image filename |
--ironic-python-agent-name IPA_NAME | Openstack ironic-python-agent (agent) image filename |
--http-boot HTTP_BOOT | Root directory for the introspection image |
--update-existing | Update images if already exist |
--whole-disk | When set, the overcloud-full image to be uploaded will be considered as a whole disk one |
--architecture ARCHITECTURE | Architecture type for these images, x86_64, i386 and ppc64le are common options. This option should match at least one arch value in instackenv.json |
--platform PLATFORM | Platform type for these images. platform is a sub- category of architecture. For example you may have generic images for x86_64 but offer images specific to SandyBridge (SNB). |
--image-type {os,ironic-python-agent} | If specified, allows to restrict the image type to upload (os for the overcloud image or ironic-python- agent for the ironic-python-agent one) |
--progress | Show progress bar for upload files action |
57.20. overcloud netenv validate
Validate the network environment file.
Usage:
openstack overcloud netenv validate [-h] [-f NETENV]
openstack overcloud netenv validate [-h] [-f NETENV]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-f NETENV, --file NETENV | Path to the network environment file |
57.21. overcloud node bios configure
Apply BIOS configuration on given nodes
Usage:
openstack overcloud node bios configure [-h] [--all-manageable] [--configuration <configuration>] [<node_uuid> [<node_uuid> ...]]
openstack overcloud node bios configure [-h] [--all-manageable]
[--configuration <configuration>]
[<node_uuid> [<node_uuid> ...]]
Value | Summary |
---|---|
<node_uuid> | Baremetal node uuids for the node(s) to configure bios |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-manageable | Configure bios for all nodes currently in manageable state |
--configuration <configuration> | Bios configuration (yaml/json string or file name). |
57.22. overcloud node bios reset
Reset BIOS configuration to factory default
Usage:
openstack overcloud node bios reset [-h] [--all-manageable] [<node_uuid> [<node_uuid> ...]]
openstack overcloud node bios reset [-h] [--all-manageable]
[<node_uuid> [<node_uuid> ...]]
Value | Summary |
---|---|
<node_uuid> | Baremetal node uuids for the node(s) to reset bios |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-manageable | Reset bios on all nodes currently in manageable state |
57.23. overcloud node clean
Run node(s) through cleaning.
Usage:
openstack overcloud node clean [-h] [--all-manageable] [--provide] [<node_uuid> [<node_uuid> ...]]
openstack overcloud node clean [-h] [--all-manageable] [--provide]
[<node_uuid> [<node_uuid> ...]]
Value | Summary |
---|---|
<node_uuid> | Baremetal node uuids for the node(s) to be cleaned |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-manageable | Clean all nodes currently in manageable state |
--provide | Provide (make available) the nodes once cleaned |
57.24. overcloud node configure
Configure Node boot options.
Usage:
openstack overcloud node configure [-h] [--all-manageable] [--deploy-kernel DEPLOY_KERNEL] [--deploy-ramdisk DEPLOY_RAMDISK] [--instance-boot-option {local,netboot}] [--root-device ROOT_DEVICE] [--root-device-minimum-size ROOT_DEVICE_MINIMUM_SIZE] [--overwrite-root-device-hints] [<node_uuid> [<node_uuid> ...]]
openstack overcloud node configure [-h] [--all-manageable]
[--deploy-kernel DEPLOY_KERNEL]
[--deploy-ramdisk DEPLOY_RAMDISK]
[--instance-boot-option {local,netboot}]
[--root-device ROOT_DEVICE]
[--root-device-minimum-size ROOT_DEVICE_MINIMUM_SIZE]
[--overwrite-root-device-hints]
[<node_uuid> [<node_uuid> ...]]
Value | Summary |
---|---|
<node_uuid> | Baremetal node uuids for the node(s) to be configured |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-manageable | Configure all nodes currently in manageable state |
--deploy-kernel DEPLOY_KERNEL | Image with deploy kernel. |
--deploy-ramdisk DEPLOY_RAMDISK | Image with deploy ramdisk. |
--instance-boot-option {local,netboot} | Whether to set instances for booting from local hard drive (local) or network (netboot). |
--root-device ROOT_DEVICE | Define the root device for nodes. can be either a list of device names (without /dev) to choose from or one of two strategies: largest or smallest. For it to work this command should be run after the introspection. |
--root-device-minimum-size ROOT_DEVICE_MINIMUM_SIZE | Minimum size (in gib) of the detected root device. Used with --root-device. |
--overwrite-root-device-hints | Whether to overwrite existing root device hints when --root-device is used. |
57.25. overcloud node delete
Delete overcloud nodes.
Usage:
openstack overcloud node delete [-h] [--stack STACK] [--templates [TEMPLATES]] [-e <HEAT ENVIRONMENT FILE>] [--timeout <TIMEOUT>] <node> [<node> ...]
openstack overcloud node delete [-h] [--stack STACK]
[--templates [TEMPLATES]]
[-e <HEAT ENVIRONMENT FILE>]
[--timeout <TIMEOUT>]
<node> [<node> ...]
Value | Summary |
---|---|
<node> | Node id(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--stack STACK | Name or id of heat stack to scale (default=env: OVERCLOUD_STACK_NAME) |
--templates [TEMPLATES] | The directory containing the heat templates to deploy. This argument is deprecated. The command now utilizes a deployment plan, which should be updated prior to running this command, should that be required. Otherwise this argument will be silently ignored. |
-e <HEAT ENVIRONMENT FILE>, --environment-file <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) This argument is deprecated. The command now utilizes a deployment plan, which should be updated prior to running this command, should that be required. Otherwise this argument will be silently ignored. |
--timeout <TIMEOUT> | Timeout in minutes to wait for the nodes to be deleted. Keep in mind that due to keystone session duration that timeout has an upper bound of 4 hours |
57.26. overcloud node discover
Discover overcloud nodes by polling their BMCs.
Usage:
openstack overcloud node discover [-h] (--ip <ips> | --range <range>) --credentials <key:value> [--port <ports>] [--introspect] [--run-validations] [--provide] [--no-deploy-image] [--instance-boot-option {local,netboot}]
openstack overcloud node discover [-h] (--ip <ips> | --range <range>)
--credentials <key:value>
[--port <ports>] [--introspect]
[--run-validations] [--provide]
[--no-deploy-image]
[--instance-boot-option {local,netboot}]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--ip <ips> | Ip address(es) to probe |
--range <range> | Ip range to probe |
--credentials <key:value> | Key/value pairs of possible credentials |
--port <ports> | Bmc port(s) to probe |
--introspect | Introspect the imported nodes |
--run-validations | Run the pre-deployment validations. these external validations are from the TripleO Validations project. |
--provide | Provide (make available) the nodes |
--no-deploy-image | Skip setting the deploy kernel and ramdisk. |
--instance-boot-option {local,netboot} | Whether to set instances for booting from local hard drive (local) or network (netboot). |
57.27. overcloud node import
Import baremetal nodes from a JSON, YAML or CSV file. The node status will be set to manageable by default.
Usage:
openstack overcloud node import [-h] [--introspect] [--run-validations] [--validate-only] [--provide] [--no-deploy-image] [--instance-boot-option {local,netboot}] env_file
openstack overcloud node import [-h] [--introspect] [--run-validations]
[--validate-only] [--provide]
[--no-deploy-image]
[--instance-boot-option {local,netboot}]
env_file
Value | Summary |
---|---|
env_file | None |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--introspect | Introspect the imported nodes |
--run-validations | Run the pre-deployment validations. these external validations are from the TripleO Validations project. |
--validate-only | Validate the env_file and then exit without actually importing the nodes. |
--provide | Provide (make available) the nodes |
--no-deploy-image | Skip setting the deploy kernel and ramdisk. |
--instance-boot-option {local,netboot} | Whether to set instances for booting from local hard drive (local) or network (netboot). |
57.28. overcloud node introspect
Introspect specified nodes or all nodes in manageable state.
Usage:
openstack overcloud node introspect [-h] [--all-manageable] [--provide] [--run-validations] [<node_uuid> [<node_uuid> ...]]
openstack overcloud node introspect [-h] [--all-manageable] [--provide]
[--run-validations]
[<node_uuid> [<node_uuid> ...]]
Value | Summary |
---|---|
<node_uuid> | Baremetal node uuids for the node(s) to be introspected |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-manageable | Introspect all nodes currently in manageable state |
--provide | Provide (make available) the nodes once introspected |
--run-validations | Run the pre-deployment validations. these external validations are from the TripleO Validations project. |
57.29. overcloud node provide
Mark nodes as available based on UUIDs or current manageable state.
Usage:
openstack overcloud node provide [-h] [--all-manageable] [<node_uuid> [<node_uuid> ...]]
openstack overcloud node provide [-h] [--all-manageable]
[<node_uuid> [<node_uuid> ...]]
Value | Summary |
---|---|
<node_uuid> | Baremetal node uuids for the node(s) to be provided |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-manageable | Provide all nodes currently in manageable state |
57.30. overcloud node provision
Provision a new node using Ironic.
Usage:
openstack overcloud node provision [-h] [-o OUTPUT] [--stack STACK] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] <baremetal_deployment.yaml>
openstack overcloud node provision [-h] [-o OUTPUT] [--stack STACK]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
<baremetal_deployment.yaml>
Value | Summary |
---|---|
<baremetal_deployment.yaml> | Configuration file describing the baremetal deployment |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-o OUTPUT, --output OUTPUT | The output environment file path |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to newly deployed nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Public key path for ssh access to newly deployed nodes |
57.31. overcloud parameters set
Set a parameters for a plan
Usage:
openstack overcloud parameters set [-h] name file_in
openstack overcloud parameters set [-h] name file_in
Value | Summary |
---|---|
name | The name of the plan, which is used for the swift container, Mistral environment and Heat stack names. |
file_in | None |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
57.32. overcloud plan create
Create a deployment plan
Usage:
openstack overcloud plan create [-h] [--templates TEMPLATES] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--disable-password-generation] [--source-url SOURCE_URL] name
openstack overcloud plan create [-h] [--templates TEMPLATES]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--disable-password-generation]
[--source-url SOURCE_URL]
name
Value | Summary |
---|---|
name | The name of the plan, which is used for the object storage container, workflow environment and orchestration stack names. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--templates TEMPLATES | The directory containing the heat templates to deploy. If this or --source_url isn’t provided, the templates packaged on the Undercloud will be used. |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--disable-password-generation | Disable password generation. |
--source-url SOURCE_URL | The url of a git repository containing the heat templates to deploy. If this or --templates isn’t provided, the templates packaged on the Undercloud will be used. |
57.33. overcloud plan delete
Delete an overcloud deployment plan. The plan will not be deleted if a stack exists with the same name.
Usage:
openstack overcloud plan delete [-h] <name> [<name> ...]
openstack overcloud plan delete [-h] <name> [<name> ...]
Value | Summary |
---|---|
<name> | Name of the plan(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
57.34. overcloud plan deploy
Deploy a deployment plan
Usage:
openstack overcloud plan deploy [-h] [--timeout <TIMEOUT>] [--run-validations] name
openstack overcloud plan deploy [-h] [--timeout <TIMEOUT>]
[--run-validations]
name
Value | Summary |
---|---|
name | The name of the plan to deploy. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--run-validations | Run the pre-deployment validations. these external validations are from the TripleO Validations project. |
57.35. overcloud plan export
Export a deployment plan
Usage:
openstack overcloud plan export [-h] [--output-file <output file>] [--force-overwrite] <name>
openstack overcloud plan export [-h] [--output-file <output file>]
[--force-overwrite]
<name>
Value | Summary |
---|---|
<name> | Name of the plan to export. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--output-file <output file>, -o <output file> | Name of the output file for export. it will default to "<name>.tar.gz". |
--force-overwrite, -f | Overwrite output file if it exists. |
57.36. overcloud plan list
List overcloud deployment plans.
Usage:
openstack overcloud plan 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]
openstack overcloud plan 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
57.37. overcloud profiles list
List overcloud node profiles
Usage:
openstack overcloud profiles 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] [--all] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
openstack overcloud profiles 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] [--all]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all | List all nodes, even those not available to nova. |
--control-scale CONTROL_SCALE | New number of control nodes. |
--compute-scale COMPUTE_SCALE | New number of compute nodes. |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
57.38. overcloud profiles match
Assign and validate profiles on nodes
Usage:
openstack overcloud profiles match [-h] [--dry-run] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
openstack overcloud profiles match [-h] [--dry-run]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--dry-run | Only run validations, but do not apply any changes. |
--control-scale CONTROL_SCALE | New number of control nodes. |
--compute-scale COMPUTE_SCALE | New number of compute nodes. |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes |
57.39. overcloud raid create
Create RAID on given nodes
Usage:
openstack overcloud raid create [-h] --node NODE configuration
openstack overcloud raid create [-h] --node NODE configuration
Value | Summary |
---|---|
configuration | Raid configuration (yaml/json string or file name). |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--node NODE | Nodes to create raid on (expected to be in manageable state). Can be specified multiple times. |
57.40. overcloud role list
List availables roles (DEPRECATED). Please use "openstack overcloud roles list" instead.
Usage:
openstack overcloud role list [-h] [--roles-path <roles directory>]
openstack overcloud role list [-h] [--roles-path <roles directory>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--roles-path <roles directory> | Filesystem path containing the role yaml files. by default this is /usr/share/openstack-tripleo-heat- templates/roles |
57.41. overcloud role show
Show information about a given role (DEPRECATED). Please use "openstack overcloud roles show" intead.
Usage:
openstack overcloud role show [-h] [--roles-path <roles directory>] <role>
openstack overcloud role show [-h] [--roles-path <roles directory>]
<role>
Value | Summary |
---|---|
<role> | Role to display more information about. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--roles-path <roles directory> | Filesystem path containing the role yaml files. by default this is /usr/share/openstack-tripleo-heat- templates/roles |
57.42. overcloud roles generate
Generate roles_data.yaml file
Usage:
openstack overcloud roles generate [-h] [--roles-path <roles directory>] [-o <output file>] [--skip-validate] <role> [<role> ...]
openstack overcloud roles generate [-h]
[--roles-path <roles directory>]
[-o <output file>] [--skip-validate]
<role> [<role> ...]
Value | Summary |
---|---|
<role> | List of roles to use to generate the roles_data.yaml file for the deployment. NOTE: Ordering is important if no role has the "primary" and "controller" tags. If no role is tagged then the first role listed will be considered the primary role. This usually is the controller role. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--roles-path <roles directory> | Filesystem path containing the role yaml files. by default this is /usr/share/openstack-tripleo-heat- templates/roles |
-o <output file>, --output-file <output file> | File to capture all output to. for example, roles_data.yaml |
--skip-validate | Skip role metadata type validation whengenerating the roles_data.yaml |
57.43. overcloud roles list
List the current and available roles in a given plan
Usage:
openstack overcloud roles 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] [--detail] [--current]
openstack overcloud roles 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] [--detail] [--current]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME | The name of the plan, which is used for the object storage container, workflow environment and orchestration stack names. |
--detail | Include details about each role |
--current | Only show the information for the roles currently enabled for the plan. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
57.44. overcloud roles show
Show details for a specific role, given a plan
Usage:
openstack overcloud roles show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name NAME] <role>
openstack overcloud roles show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--name NAME]
<role>
Value | Summary |
---|---|
<role> | Name of the role to look up. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME | The name of the plan, which is used for the object storage container, workflow environment and orchestration stack names. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
57.45. overcloud status
Get deployment status
Usage:
openstack overcloud status [-h] [--plan PLAN]
openstack overcloud status [-h] [--plan PLAN]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--plan PLAN, --stack PLAN | Name of the stack/plan. (default: overcloud) |
57.46. overcloud support report collect
Run sosreport on selected servers.
Usage:
openstack overcloud support report collect [-h] [-c CONTAINER] [-o DESTINATION] [--skip-container-delete] [-t TIMEOUT] [-n CONCURRENCY] [--collect-only | --download-only] server_name
openstack overcloud support report collect [-h] [-c CONTAINER]
[-o DESTINATION]
[--skip-container-delete]
[-t TIMEOUT]
[-n CONCURRENCY]
[--collect-only | --download-only]
server_name
Value | Summary |
---|---|
server_name | Nova server_name or partial name to match. for example "controller" will match all controllers for an environment. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-c CONTAINER, --container CONTAINER | Swift container to store logs to |
-o DESTINATION, --output DESTINATION | Output directory for the report |
--skip-container-delete | Do not delete the container after the files have been downloaded. Ignored if --collect-only or --download- only is provided. |
-t TIMEOUT, --timeout TIMEOUT | Maximum time to wait for the log collection and container deletion workflows to finish. |
-n CONCURRENCY, --concurrency CONCURRENCY | Number of parallel log collection and object deletion tasks to run. |
--collect-only | Skip log downloads, only collect logs and put in the container |
--download-only | Skip generation, only download from the provided container |
57.47. overcloud update converge
Converge the update on Overcloud nodes. This restores the plan and stack so that normal deployment workflow is back in place.
Usage:
openstack overcloud update converge [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
openstack overcloud update converge [--templates [TEMPLATES]]
[--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup] [--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations]
[--dry-run] [--run-validations]
[--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier]
[--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG] [--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server]
[--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.48. overcloud update prepare
Run heat stack update for overcloud nodes to refresh heat stack outputs. The heat stack outputs are what we use later on to generate ansible playbooks which deliver the minor update workflow. This is used as the first step for a minor update of your overcloud.
Usage:
openstack overcloud update prepare [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
openstack overcloud update prepare [--templates [TEMPLATES]]
[--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup] [--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations] [--dry-run]
[--run-validations]
[--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier]
[--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG] [--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server]
[--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.49. overcloud update run
Run minor update ansible playbooks on Overcloud nodes
Usage:
openstack overcloud update run [-h] (--nodes NODES | --roles ROLES | --limit LIMIT) [--playbook PLAYBOOK] [--ssh-user SSH_USER] [--static-inventory STATIC_INVENTORY] [--stack STACK]
openstack overcloud update run [-h]
(--nodes NODES | --roles ROLES | --limit LIMIT)
[--playbook PLAYBOOK]
[--ssh-user SSH_USER]
[--static-inventory STATIC_INVENTORY]
[--stack STACK]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--nodes NODES | Deprecated: this option will be remove in the future release Use the limit option instead.A string that identifies a single node or comma-separated list of nodes to be upgraded in parallel in this upgrade run invocation. For example: --nodes "compute-0, compute-1, compute-5". NOTE: Using this parameter with nodes of controlplane roles (e.g. "--nodes controller-1") is NOT supported and WILL end badly unless you include ALL nodes of that role as a comma separated string. You should instead use the --roles parameter for controlplane roles and specify the role name. |
--roles ROLES | Deprecated: this option will be remove in the future release Use the limit option instead.A string that identifies the role or comma-separated list ofroles to be upgraded in this upgrade run invocation. NOTE: nodes of specified role(s) are upgraded in parallel. This is REQUIRED for controlplane roles. For non controlplane roles (e.g., "Compute"), you may consider instead using the --nodes argument to limit the upgrade to a specific node or list (comma separated string) of nodes. |
--limit LIMIT | A string that identifies a single node or comma- separated list of nodes to be upgraded in parallel in this upgrade run invocation. For example: --limit "compute-0, compute-1, compute-5". |
--playbook PLAYBOOK | Ansible playbook to use for the minor update. defaults to the special value all which causes all the update playbooks to be executed. That is the update_steps_playbook.yaml and then thedeploy_steps_playbook.yaml. Set this to each of those playbooks in consecutive invocations of this command if you prefer to run them manually. Note: make sure to run both those playbooks so that all services are updated and running with the target version configuration. |
--ssh-user SSH_USER | Deprecated: only tripleo-admin should be used as ssh user. |
--static-inventory STATIC_INVENTORY | Path to an existing ansible inventory to use. if not specified, one will be generated in ~/tripleo-ansible- inventory.yaml |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
57.50. overcloud upgrade converge
Major upgrade converge - reset Heat resources in the stored plan This is the last step for completion of a overcloud major upgrade. The main task is updating the plan and stack to unblock future stack updates. For the major upgrade workflow we have set specific values for some stack Heat resources. This unsets those back to their default values.
Usage:
openstack overcloud upgrade converge [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
openstack overcloud upgrade converge [--templates [TEMPLATES]]
[--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup]
[--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations]
[--dry-run] [--run-validations]
[--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier]
[--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG] [--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server]
[--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.51. overcloud upgrade prepare
Run heat stack update for overcloud nodes to refresh heat stack outputs. The heat stack outputs are what we use later on to generate ansible playbooks which deliver the major upgrade workflow. This is used as the first step for a major upgrade of your overcloud.
Usage:
openstack overcloud upgrade prepare [--templates [TEMPLATES]] [--stack STACK] [--timeout <TIMEOUT>] [--control-scale CONTROL_SCALE] [--compute-scale COMPUTE_SCALE] [--ceph-storage-scale CEPH_STORAGE_SCALE] [--block-storage-scale BLOCK_STORAGE_SCALE] [--swift-storage-scale SWIFT_STORAGE_SCALE] [--control-flavor CONTROL_FLAVOR] [--compute-flavor COMPUTE_FLAVOR] [--ceph-storage-flavor CEPH_STORAGE_FLAVOR] [--block-storage-flavor BLOCK_STORAGE_FLAVOR] [--swift-storage-flavor SWIFT_STORAGE_FLAVOR] [--libvirt-type {kvm,qemu}] [--ntp-server NTP_SERVER] [--no-proxy NO_PROXY] [--overcloud-ssh-user OVERCLOUD_SSH_USER] [--overcloud-ssh-key OVERCLOUD_SSH_KEY] [--overcloud-ssh-network OVERCLOUD_SSH_NETWORK] [--environment-file <HEAT ENVIRONMENT FILE>] [--environment-directory <HEAT ENVIRONMENT DIRECTORY>] [--roles-file ROLES_FILE] [--networks-file NETWORKS_FILE] [--plan-environment-file PLAN_ENVIRONMENT_FILE] [--no-cleanup] [--update-plan-only] [--validation-errors-nonfatal] [--validation-warnings-fatal] [--disable-validations] [--inflight-validations] [--dry-run] [--run-validations] [--skip-postconfig] [--force-postconfig] [--skip-deploy-identifier] [--rhel-reg] [--reg-method {satellite,portal}] [--reg-org REG_ORG] [--reg-force] [--reg-sat-url REG_SAT_URL] [--reg-activation-key REG_ACTIVATION_KEY] [--answers-file ANSWERS_FILE] [--disable-password-generation] [--deployed-server] [--config-download] [--no-config-download] [--config-download-only] [--output-dir OUTPUT_DIR] [--override-ansible-cfg OVERRIDE_ANSIBLE_CFG] [--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT] [--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
openstack overcloud upgrade prepare [--templates [TEMPLATES]]
[--stack STACK]
[--timeout <TIMEOUT>]
[--control-scale CONTROL_SCALE]
[--compute-scale COMPUTE_SCALE]
[--ceph-storage-scale CEPH_STORAGE_SCALE]
[--block-storage-scale BLOCK_STORAGE_SCALE]
[--swift-storage-scale SWIFT_STORAGE_SCALE]
[--control-flavor CONTROL_FLAVOR]
[--compute-flavor COMPUTE_FLAVOR]
[--ceph-storage-flavor CEPH_STORAGE_FLAVOR]
[--block-storage-flavor BLOCK_STORAGE_FLAVOR]
[--swift-storage-flavor SWIFT_STORAGE_FLAVOR]
[--libvirt-type {kvm,qemu}]
[--ntp-server NTP_SERVER]
[--no-proxy NO_PROXY]
[--overcloud-ssh-user OVERCLOUD_SSH_USER]
[--overcloud-ssh-key OVERCLOUD_SSH_KEY]
[--overcloud-ssh-network OVERCLOUD_SSH_NETWORK]
[--environment-file <HEAT ENVIRONMENT FILE>]
[--environment-directory <HEAT ENVIRONMENT DIRECTORY>]
[--roles-file ROLES_FILE]
[--networks-file NETWORKS_FILE]
[--plan-environment-file PLAN_ENVIRONMENT_FILE]
[--no-cleanup] [--update-plan-only]
[--validation-errors-nonfatal]
[--validation-warnings-fatal]
[--disable-validations]
[--inflight-validations]
[--dry-run] [--run-validations]
[--skip-postconfig]
[--force-postconfig]
[--skip-deploy-identifier]
[--rhel-reg]
[--reg-method {satellite,portal}]
[--reg-org REG_ORG] [--reg-force]
[--reg-sat-url REG_SAT_URL]
[--reg-activation-key REG_ACTIVATION_KEY]
[--answers-file ANSWERS_FILE]
[--disable-password-generation]
[--deployed-server]
[--config-download]
[--no-config-download]
[--config-download-only]
[--output-dir OUTPUT_DIR]
[--override-ansible-cfg OVERRIDE_ANSIBLE_CFG]
[--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT]
[--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER]
Value | Summary |
---|---|
--templates [TEMPLATES] | The directory containing the heat templates to deploy |
--stack STACK | Stack name to create or update |
--timeout <TIMEOUT>, -t <TIMEOUT> | Deployment timeout in minutes. |
--control-scale CONTROL_SCALE | New number of control nodes. (deprecated. use an environment file and set the parameter ControllerCount. It will be removed after the "P" release.) |
--compute-scale COMPUTE_SCALE | New number of compute nodes. (deprecated. use an environment file and set the parameter ComputeCount. It will be removed after the "P" release.) |
--ceph-storage-scale CEPH_STORAGE_SCALE | New number of ceph storage nodes. (deprecated. use an environment file and set the parameter CephStorageCount. It will be removed after the "P" release.) |
--block-storage-scale BLOCK_STORAGE_SCALE | New number of cinder storage nodes. (deprecated. use an environment file and set the parameter BlockStorageCount. It will be removed after the "P" release.) |
--swift-storage-scale SWIFT_STORAGE_SCALE | New number of swift storage nodes. (deprecated. use an environment file and set the parameter ObjectStorageCount. It will be removed after the "P" release.) |
--control-flavor CONTROL_FLAVOR | Nova flavor to use for control nodes. (deprecated. use an environment file and set the parameter OvercloudControlFlavor. It will be removed after the "P" release.) |
--compute-flavor COMPUTE_FLAVOR | Nova flavor to use for compute nodes. (deprecated. use an environment file and set the parameter OvercloudComputeFlavor. It will be removed after the "P" release.) |
--ceph-storage-flavor CEPH_STORAGE_FLAVOR | Nova flavor to use for ceph storage nodes. (DEPRECATED. Use an environment file and set the parameter OvercloudCephStorageFlavor. It will be removed after the "P" release.) |
--block-storage-flavor BLOCK_STORAGE_FLAVOR | Nova flavor to use for cinder storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudBlockStorageFlavor. It will be removed after the "P" release.) |
--swift-storage-flavor SWIFT_STORAGE_FLAVOR | Nova flavor to use for swift storage nodes (DEPRECATED. Use an environment file and set the parameter OvercloudSwiftStorageFlavor. It will be removed after the "P" release.) |
--libvirt-type {kvm,qemu} | Libvirt domain type. |
--ntp-server NTP_SERVER | The ntp for overcloud nodes. |
--no-proxy NO_PROXY | A comma separated list of hosts that should not be proxied. |
--overcloud-ssh-user OVERCLOUD_SSH_USER | User for ssh access to overcloud nodes |
--overcloud-ssh-key OVERCLOUD_SSH_KEY | Key path for ssh access to overcloud nodes. |
--overcloud-ssh-network OVERCLOUD_SSH_NETWORK | Network name to use for ssh access to overcloud nodes. |
--environment-file <HEAT ENVIRONMENT FILE>, -e <HEAT ENVIRONMENT FILE> | Environment files to be passed to the heat stack- create or heat stack-update command. (Can be specified more than once.) |
--environment-directory <HEAT ENVIRONMENT DIRECTORY> | Environment file directories that are automatically added to the heat stack-create or heat stack-update commands. Can be specified more than once. Files in directories are loaded in ascending sort order. |
--roles-file ROLES_FILE, -r ROLES_FILE | Roles file, overrides the default roles_data.yaml in the --templates directory. May be an absolute path or the path relative to --templates |
--networks-file NETWORKS_FILE, -n NETWORKS_FILE | Networks file, overrides the default network_data.yaml in the --templates directory |
--plan-environment-file PLAN_ENVIRONMENT_FILE, -p PLAN_ENVIRONMENT_FILE | Plan environment file, overrides the default plan- environment.yaml in the --templates directory |
--no-cleanup | Don’t cleanup temporary files, just log their location |
--update-plan-only | Only update the plan. do not perform the actual deployment. NOTE: Will move to a discrete command in a future release. |
--validation-errors-nonfatal | Allow the deployment to continue in spite of validation errors. Note that attempting deployment while errors exist is likely to fail. |
--validation-warnings-fatal | Exit if there are warnings from the configuration pre- checks. |
--disable-validations | Deprecated. disable the pre-deployment validations entirely. These validations are the built-in pre- deployment validations. To enable external validations from tripleo-validations, use the --run-validations flag. These validations are now run via the external validations in tripleo-validations. |
--inflight-validations | Activate in-flight validations during the deploy. in- flight validations provide a robust way to ensure deployed services are running right after their activation. Defaults to False. |
--dry-run | Only run validations, but do not apply any changes. |
--run-validations | Run external validations from the tripleo-validations project. |
--skip-postconfig | Skip the overcloud post-deployment configuration. |
--force-postconfig | Force the overcloud post-deployment configuration. |
--skip-deploy-identifier | Skip generation of a unique identifier for the DeployIdentifier parameter. The software configuration deployment steps will only be triggered if there is an actual change to the configuration. This option should be used with Caution, and only if there is confidence that the software configuration does not need to be run, such as when scaling out certain roles. |
--answers-file ANSWERS_FILE | Path to a yaml file with arguments and parameters. |
--disable-password-generation | Disable password generation. |
--deployed-server | Use pre-provisioned overcloud nodes. removes baremetal,compute and image services requirements from theundercloud node. Must only be used with the-- disable-validations. |
--config-download | Run deployment via config-download mechanism. this is now the default, and this CLI options may be removed in the future. |
--no-config-download, --stack-only | Disable the config-download workflow and only create the stack and associated OpenStack resources. No software configuration will be applied. |
--config-download-only | Disable the stack create/update, and only run the config-download workflow to apply the software configuration. |
--output-dir OUTPUT_DIR | Directory to use for saved output when using --config- download. The directory must be writeable by the mistral user. When not specified, the default server side value will be used (/var/lib/mistral/<execution id>. |
--override-ansible-cfg OVERRIDE_ANSIBLE_CFG | Path to ansible configuration file. the configuration in the file will override any configuration used by config-download by default. |
--config-download-timeout CONFIG_DOWNLOAD_TIMEOUT | Timeout (in minutes) to use for config-download steps. If unset, will default to however much time is leftover from the --timeout parameter after the stack operation. |
--deployment-python-interpreter DEPLOYMENT_PYTHON_INTERPRETER | The path to python interpreter to use for the deployment actions. This may need to be used if deploying on a python2 host from a python3 system or vice versa. |
Value | Summary |
---|---|
--rhel-reg | Register overcloud nodes to the customer portal or a satellite. |
--reg-method {satellite,portal} | Rhel registration method to use for the overcloud nodes. |
--reg-org REG_ORG | Organization key to use for registration. |
--reg-force | Register the system even if it is already registered. |
--reg-sat-url REG_SAT_URL | Satellite server to register overcloud nodes. |
--reg-activation-key REG_ACTIVATION_KEY | Activation key to use for registration. |
57.52. overcloud upgrade run
Run major upgrade ansible playbooks on Overcloud nodes This will run the major upgrade ansible playbooks on the overcloud. By default all playbooks are executed, that is the upgrade_steps_playbook.yaml then the deploy_steps_playbook.yaml and then the post_upgrade_steps_playbook.yaml. The upgrade playbooks are made available after completion of the overcloud upgrade prepare command. This overcloud upgrade run command is the second step in the major upgrade workflow.
Usage:
openstack overcloud upgrade run [-h] (--nodes NODES | --roles ROLES | --limit LIMIT) [--playbook PLAYBOOK] [--static-inventory STATIC_INVENTORY] [--ssh-user SSH_USER] [--tags TAGS] [--skip-tags SKIP_TAGS] [--stack STACK]
openstack overcloud upgrade run [-h]
(--nodes NODES | --roles ROLES | --limit LIMIT)
[--playbook PLAYBOOK]
[--static-inventory STATIC_INVENTORY]
[--ssh-user SSH_USER] [--tags TAGS]
[--skip-tags SKIP_TAGS] [--stack STACK]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--nodes NODES | Deprecated: this option will be remove in the future release Use the limit option instead.A string that identifies a single node or comma-separated list of nodes to be upgraded in parallel in this upgrade run invocation. For example: --nodes "compute-0, compute-1, compute-5". NOTE: Using this parameter with nodes of controlplane roles (e.g. "--nodes controller-1") is NOT supported and WILL end badly unless you include ALL nodes of that role as a comma separated string. You should instead use the --roles parameter for controlplane roles and specify the role name. |
--roles ROLES | Deprecated: this option will be remove in the future release Use the limit option instead.A string that identifies the role or comma-separated list ofroles to be upgraded in this upgrade run invocation. NOTE: nodes of specified role(s) are upgraded in parallel. This is REQUIRED for controlplane roles. For non controlplane roles (e.g., "Compute"), you may consider instead using the --nodes argument to limit the upgrade to a specific node or list (comma separated string) of nodes. |
--limit LIMIT | A string that identifies a single node or comma- separatedlist of nodes to be upgraded in parallel in this upgrade run invocation. For example: --limit "compute-0, compute-1, compute-5". |
--playbook PLAYBOOK | Ansible playbook to use for the major upgrade. Defaults to the special value all which causes all the upgrade playbooks to run. That is the upgrade_steps_playbook.yaml then deploy_steps_playbook.yaml and then post_upgrade_steps_playbook.yaml. Set this to each of those playbooks in consecutive invocations of this command if you prefer to run them manually. Note: you will have to run all of those playbooks so that all services are upgraded and running with the target version configuration. |
--static-inventory STATIC_INVENTORY | Path to an existing ansible inventory to use. if not specified, one will be generated in ~/tripleo-ansible- inventory.yaml |
--ssh-user SSH_USER | Deprecated: only tripleo-admin should be used as ssh user. |
--tags TAGS | A string specifying the tag or comma separated list of tags to be passed as --tags to ansible-playbook. |
--skip-tags SKIP_TAGS | A string specifying the tag or comma separated list of tags to be passed as --skip-tags to ansible-playbook. The currently supported values are validation and pre-upgrade. In particular validation is useful if you must re-run following a failed upgrade and some services cannot be started. |
--stack STACK | Name or id of heat stack (default=env: OVERCLOUD_STACK_NAME) |
Chapter 58. policy
This chapter describes the commands under the policy
command.
58.1. policy create
Create new policy
Usage:
openstack policy create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--type <type>] <filename>
openstack policy create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--type <type>]
<filename>
Value | Summary |
---|---|
<filename> | New serialized policy rules file |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | New mime type of the policy rules file (defaults to application/json) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
58.2. policy delete
Delete policy(s)
Usage:
openstack policy delete [-h] <policy> [<policy> ...]
openstack policy delete [-h] <policy> [<policy> ...]
Value | Summary |
---|---|
<policy> | Policy(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
58.3. policy list
List policies
Usage:
openstack policy 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]
openstack policy 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]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--long | List additional fields in output |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
58.4. policy set
Set policy properties
Usage:
openstack policy set [-h] [--type <type>] [--rules <filename>] <policy>
openstack policy set [-h] [--type <type>] [--rules <filename>] <policy>
Value | Summary |
---|---|
<policy> | Policy to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--type <type> | New mime type of the policy rules file |
--rules <filename> | New serialized policy rules file |
58.5. policy show
Display policy details
Usage:
openstack policy show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <policy>
openstack policy show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<policy>
Value | Summary |
---|---|
<policy> | Policy to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 59. port
This chapter describes the commands under the port
command.
59.1. port create
Create a new port
Usage:
openstack port create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --network <network> [--description <description>] [--device <device-id>] [--mac-address <mac-address>] [--device-owner <device-owner>] [--vnic-type <vnic-type>] [--host <host-id>] [--dns-domain dns-domain] [--dns-name <dns-name>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address> | --no-fixed-ip] [--binding-profile <binding-profile>] [--enable | --disable] [--enable-uplink-status-propagation | --disable-uplink-status-propagation] [--project <project>] [--project-domain <project-domain>] [--security-group <security-group> | --no-security-group] [--qos-policy <qos-policy>] [--enable-port-security | --disable-port-security] [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]] [--tag <tag> | --no-tag] <name>
openstack port create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --network <network>
[--description <description>]
[--device <device-id>]
[--mac-address <mac-address>]
[--device-owner <device-owner>]
[--vnic-type <vnic-type>] [--host <host-id>]
[--dns-domain dns-domain] [--dns-name <dns-name>]
[--fixed-ip subnet=<subnet>,ip-address=<ip-address> | --no-fixed-ip]
[--binding-profile <binding-profile>]
[--enable | --disable]
[--enable-uplink-status-propagation | --disable-uplink-status-propagation]
[--project <project>]
[--project-domain <project-domain>]
[--security-group <security-group> | --no-security-group]
[--qos-policy <qos-policy>]
[--enable-port-security | --disable-port-security]
[--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]]
[--tag <tag> | --no-tag]
<name>
Value | Summary |
---|---|
<name> | Name of this port |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--network <network> | Network this port belongs to (name or id) |
--description <description> | Description of this port |
--device <device-id> | Port device id |
--mac-address <mac-address> | Mac address of this port (admin only) |
--device-owner <device-owner> | Device owner of this port. this is the entity that uses the port (for example, network:dhcp). |
--vnic-type <vnic-type> | Vnic type for this port (direct |
direct-physical | macvtap |
normal | baremetal |
virtio-forwarder, default: normal) | --host <host-id> |
Allocate port on host <host-id> (id only) | --dns-domain dns-domain |
Set dns domain to this port (requires dns_domain extension for ports) | --dns-name <dns-name> |
Set dns name for this port (requires dns integration extension) | --fixed-ip subnet=<subnet>,ip-address=<ip-address> |
Desired ip and/or subnet for this port (name or id): subnet=<subnet>,ip-address=<ip-address> (repeat option to set multiple fixed IP addresses) | --no-fixed-ip |
No ip or subnet for this port. | --binding-profile <binding-profile> |
Custom data to be passed as binding:profile. data may be passed as <key>=<value> or JSON. (repeat option to set multiple binding:profile data) | --enable |
Enable port (default) | --disable |
Disable port | --enable-uplink-status-propagation |
Enable uplink status propagate | --disable-uplink-status-propagation |
Disable uplink status propagate (default) | --project <project> |
Owner’s project (name or id) | --project-domain <project-domain> |
Domain the project belongs to (name or id). this can be used in case collisions between project names exist. | --security-group <security-group> |
Security group to associate with this port (name or ID) (repeat option to set multiple security groups) | --no-security-group |
Associate no security groups with this port | --qos-policy <qos-policy> |
Attach qos policy to this port (name or id) | --enable-port-security |
Enable port security for this port (default) | --disable-port-security |
Disable port security for this port | --allowed-address ip-address=<ip-address>[,mac-address=<mac-address>] |
Add allowed-address pair associated with this port: ip-address=<ip-address>[,mac-address=<mac-address>] (repeat option to set multiple allowed-address pairs) | --tag <tag> |
Tag to be added to the port (repeat option to set multiple tags) | --no-tag |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
59.2. port delete
Delete port(s)
Usage:
openstack port delete [-h] <port> [<port> ...]
openstack port delete [-h] <port> [<port> ...]
Value | Summary |
---|---|
<port> | Port(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
59.3. port list
List ports
Usage:
openstack port 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] [--device-owner <device-owner>] [--network <network>] [--router <router> | --server <server> | --device-id <device-id>] [--mac-address <mac-address>] [--long] [--project <project>] [--project-domain <project-domain>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>] [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
openstack port 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]
[--device-owner <device-owner>]
[--network <network>]
[--router <router> | --server <server> | --device-id <device-id>]
[--mac-address <mac-address>] [--long]
[--project <project>]
[--project-domain <project-domain>]
[--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring>]
[--tags <tag>[,<tag>,...]]
[--any-tags <tag>[,<tag>,...]]
[--not-tags <tag>[,<tag>,...]]
[--not-any-tags <tag>[,<tag>,...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--device-owner <device-owner> | List only ports with the specified device owner. this is the entity that uses the port (for example, network:dhcp). |
--network <network> | List only ports connected to this network (name or id) |
--router <router> | List only ports attached to this router (name or id) |
--server <server> | List only ports attached to this server (name or id) |
--device-id <device-id> | List only ports with the specified device id |
--mac-address <mac-address> | List only ports with this mac address |
--long | List additional fields in output |
--project <project> | List ports according to their project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--fixed-ip subnet=<subnet>,ip-address=<ip-address>,ip-substring=<ip-substring> | Desired ip and/or subnet for filtering ports (name or ID): subnet=<subnet>,ip-address=<ip-address>,ip- substring=<ip-substring> (repeat option to set multiple fixed IP addresses) |
--tags <tag>[,<tag>,…] | List ports which have all given tag(s) (comma- separated list of tags) |
--any-tags <tag>[,<tag>,…] | List ports which have any given tag(s) (comma- separated list of tags) |
--not-tags <tag>[,<tag>,…] | Exclude ports which have all given tag(s) (comma- separated list of tags) |
--not-any-tags <tag>[,<tag>,…] | Exclude ports which have any given tag(s) (comma- separated list of tags) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
59.4. port set
Set port properties
Usage:
openstack port set [-h] [--description <description>] [--device <device-id>] [--mac-address <mac-address>] [--device-owner <device-owner>] [--vnic-type <vnic-type>] [--host <host-id>] [--dns-domain dns-domain] [--dns-name <dns-name>] [--enable | --disable] [--name <name>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>] [--no-fixed-ip] [--binding-profile <binding-profile>] [--no-binding-profile] [--qos-policy <qos-policy>] [--security-group <security-group>] [--no-security-group] [--enable-port-security | --disable-port-security] [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]] [--no-allowed-address] [--data-plane-status <status>] [--tag <tag>] [--no-tag] <port>
openstack port set [-h] [--description <description>]
[--device <device-id>] [--mac-address <mac-address>]
[--device-owner <device-owner>]
[--vnic-type <vnic-type>] [--host <host-id>]
[--dns-domain dns-domain] [--dns-name <dns-name>]
[--enable | --disable] [--name <name>]
[--fixed-ip subnet=<subnet>,ip-address=<ip-address>]
[--no-fixed-ip]
[--binding-profile <binding-profile>]
[--no-binding-profile] [--qos-policy <qos-policy>]
[--security-group <security-group>]
[--no-security-group]
[--enable-port-security | --disable-port-security]
[--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]]
[--no-allowed-address]
[--data-plane-status <status>] [--tag <tag>]
[--no-tag]
<port>
Value | Summary |
---|---|
<port> | Port to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of this port |
--device <device-id> | Port device id |
--mac-address <mac-address> | Mac address of this port (admin only) |
--device-owner <device-owner> | Device owner of this port. this is the entity that uses the port (for example, network:dhcp). |
--vnic-type <vnic-type> | Vnic type for this port (direct |
direct-physical | macvtap |
normal | baremetal |
virtio-forwarder, default: normal) | --host <host-id> |
Allocate port on host <host-id> (id only) | --dns-domain dns-domain |
Set dns domain to this port (requires dns_domain extension for ports) | --dns-name <dns-name> |
Set dns name for this port (requires dns integration extension) | --enable |
Enable port | --disable |
Disable port | --name <name> |
Set port name | --fixed-ip subnet=<subnet>,ip-address=<ip-address> |
Desired ip and/or subnet for this port (name or id): subnet=<subnet>,ip-address=<ip-address> (repeat option to set multiple fixed IP addresses) | --no-fixed-ip |
Clear existing information of fixed ip addresses.Specify both --fixed-ip and --no-fixed-ip to overwrite the current fixed IP addresses. | --binding-profile <binding-profile> |
Custom data to be passed as binding:profile. data may be passed as <key>=<value> or JSON. (repeat option to set multiple binding:profile data) | --no-binding-profile |
Clear existing information of binding:profile. specify both --binding-profile and --no-binding-profile to overwrite the current binding:profile information. | --qos-policy <qos-policy> |
Attach qos policy to this port (name or id) | --security-group <security-group> |
Security group to associate with this port (name or ID) (repeat option to set multiple security groups) | --no-security-group |
Clear existing security groups associated with this port | --enable-port-security |
Enable port security for this port | --disable-port-security |
Disable port security for this port | --allowed-address ip-address=<ip-address>[,mac-address=<mac-address>] |
Add allowed-address pair associated with this port: ip-address=<ip-address>[,mac-address=<mac-address>] (repeat option to set multiple allowed-address pairs) | --no-allowed-address |
Clear existing allowed-address pairs associated with this port. (Specify both --allowed-address and --no- allowed-address to overwrite the current allowed- address pairs) | --data-plane-status <status> |
Set data plane status of this port (active | down). Unset it to None with the port unset command (requires data plane status extension) |
--tag <tag> | Tag to be added to the port (repeat option to set multiple tags) |
--no-tag | Clear tags associated with the port. specify both --tag and --no-tag to overwrite current tags |
59.5. port show
Display port details
Usage:
openstack port show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <port>
openstack port show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<port>
Value | Summary |
---|---|
<port> | Port to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
59.6. port unset
Unset port properties
Usage:
openstack port unset [-h] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>] [--binding-profile <binding-profile-key>] [--security-group <security-group>] [--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]] [--qos-policy] [--data-plane-status] [--tag <tag> | --all-tag] <port>
openstack port unset [-h]
[--fixed-ip subnet=<subnet>,ip-address=<ip-address>]
[--binding-profile <binding-profile-key>]
[--security-group <security-group>]
[--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>]]
[--qos-policy] [--data-plane-status]
[--tag <tag> | --all-tag]
<port>
Value | Summary |
---|---|
<port> | Port to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--fixed-ip subnet=<subnet>,ip-address=<ip-address> | Desired ip and/or subnet which should be removed from this port (name or ID): subnet=<subnet>,ip- address=<ip-address> (repeat option to unset multiple fixed IP addresses) |
--binding-profile <binding-profile-key> | Desired key which should be removed from binding:profile (repeat option to unset multiple binding:profile data) |
--security-group <security-group> | Security group which should be removed this port (name or ID) (repeat option to unset multiple security groups) |
--allowed-address ip-address=<ip-address>[,mac-address=<mac-address>] | Desired allowed-address pair which should be removed from this port: ip-address=<ip-address>[,mac- address=<mac-address>] (repeat option to unset multiple allowed-address pairs) |
--qos-policy | Remove the qos policy attached to the port |
--data-plane-status | Clear existing information of data plane status |
--tag <tag> | Tag to be removed from the port (repeat option to remove multiple tags) |
--all-tag | Clear all tags associated with the port |
Chapter 60. project
This chapter describes the commands under the project
command.
60.1. project create
Create new project
Usage:
openstack project create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--domain <domain>] [--parent <project>] [--description <description>] [--enable | --disable] [--property <key=value>] [--or-show] [--tag <tag>] <project-name>
openstack project create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--domain <domain>]
[--parent <project>]
[--description <description>]
[--enable | --disable]
[--property <key=value>] [--or-show]
[--tag <tag>]
<project-name>
Value | Summary |
---|---|
<project-name> | New project name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain owning the project (name or id) |
--parent <project> | Parent of the project (name or id) |
--description <description> | Project description |
--enable | Enable project |
--disable | Disable project |
--property <key=value> | Add a property to <name> (repeat option to set multiple properties) |
--or-show | Return existing project |
--tag <tag> | Tag to be added to the project (repeat option to set multiple tags) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
60.2. project delete
Delete project(s)
Usage:
openstack project delete [-h] [--domain <domain>] <project> [<project> ...]
openstack project delete [-h] [--domain <domain>]
<project> [<project> ...]
Value | Summary |
---|---|
<project> | Project(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain owning <project> (name or id) |
60.3. project list
List projects
Usage:
openstack project 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] [--domain <domain>] [--user <user>] [--my-projects] [--long] [--sort <key>[:<direction>]] [--tags <tag>[,<tag>,...]] [--tags-any <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-tags-any <tag>[,<tag>,...]]
openstack project 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] [--domain <domain>]
[--user <user>] [--my-projects] [--long]
[--sort <key>[:<direction>]]
[--tags <tag>[,<tag>,...]]
[--tags-any <tag>[,<tag>,...]]
[--not-tags <tag>[,<tag>,...]]
[--not-tags-any <tag>[,<tag>,...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Filter projects by <domain> (name or id) |
--user <user> | Filter projects by <user> (name or id) |
--my-projects | List projects for the authenticated user. supersedes other filters. |
--long | List additional fields in output |
--sort <key>[:<direction>] | Sort output by selected keys and directions (asc or desc) (default: asc), repeat this option to specify multiple keys and directions. |
--tags <tag>[,<tag>,…] | List projects which have all given tag(s) (comma- separated list of tags) |
--tags-any <tag>[,<tag>,…] | List projects which have any given tag(s) (comma- separated list of tags) |
--not-tags <tag>[,<tag>,…] | Exclude projects which have all given tag(s) (comma- separated list of tags) |
--not-tags-any <tag>[,<tag>,…] | Exclude projects which have any given tag(s) (comma- separated list of tags) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
60.4. project purge
Clean resources associated with a project
Usage:
openstack project purge [-h] [--dry-run] [--keep-project] (--auth-project | --project <project>) [--project-domain <project-domain>]
openstack project purge [-h] [--dry-run] [--keep-project]
(--auth-project | --project <project>)
[--project-domain <project-domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--dry-run | List a project’s resources |
--keep-project | Clean project resources, but don’t delete the project |
--auth-project | Delete resources of the project used to authenticate |
--project <project> | Project to clean (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
60.5. project set
Set project properties
Usage:
openstack project set [-h] [--name <name>] [--domain <domain>] [--description <description>] [--enable | --disable] [--property <key=value>] [--tag <tag>] [--clear-tags] [--remove-tag <tag>] <project>
openstack project set [-h] [--name <name>] [--domain <domain>]
[--description <description>]
[--enable | --disable] [--property <key=value>]
[--tag <tag>] [--clear-tags] [--remove-tag <tag>]
<project>
Value | Summary |
---|---|
<project> | Project to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set project name |
--domain <domain> | Domain owning <project> (name or id) |
--description <description> | Set project description |
--enable | Enable project |
--disable | Disable project |
--property <key=value> | Set a property on <project> (repeat option to set multiple properties) |
--tag <tag> | Tag to be added to the project (repeat option to set multiple tags) |
--clear-tags | Clear tags associated with the project. specify both --tag and --clear-tags to overwrite current tags |
--remove-tag <tag> | Tag to be deleted from the project (repeat option to delete multiple tags) |
60.6. project show
Display project details
Usage:
openstack project show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--domain <domain>] [--parents] [--children] <project>
openstack project show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--domain <domain>] [--parents]
[--children]
<project>
Value | Summary |
---|---|
<project> | Project to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain owning <project> (name or id) |
--parents | Show the project’s parents as a list |
--children | Show project’s subtree (children) as a list |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 61. ptr
This chapter describes the commands under the ptr
command.
61.1. ptr record list
List floatingip ptr records
Usage:
openstack ptr record 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] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID]
openstack ptr record 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] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
61.2. ptr record set
Set floatingip ptr record
Usage:
openstack ptr record set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description DESCRIPTION | --no-description] [--ttl TTL | --no-ttl] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] floatingip_id ptrdname
openstack ptr record set [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description DESCRIPTION | --no-description]
[--ttl TTL | --no-ttl] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
floatingip_id ptrdname
Value | Summary |
---|---|
floatingip_id | Floating ip id in format region:floatingip_id |
ptrdname | Ptrd name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description DESCRIPTION | Description |
--no-description—ttl TTL | Ttl |
--no-ttl—all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
61.3. ptr record show
Show floatingip ptr record details
Usage:
openstack ptr record show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] floatingip_id
openstack ptr record show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
floatingip_id
Value | Summary |
---|---|
floatingip_id | Floating ip id in format region:floatingip_id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
61.4. ptr record unset
Unset floatingip ptr record
Usage:
openstack ptr record unset [-h] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] floatingip_id
openstack ptr record unset [-h] [--all-projects] [--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
floatingip_id
Value | Summary |
---|---|
floatingip_id | Floating ip id in format region:floatingip_id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Chapter 62. quota
This chapter describes the commands under the quota
command.
62.1. quota list
List quotas for all projects with non-default quota values or list detailed quota informations for requested project
Usage:
openstack quota 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] [--project <project>] [--detail] (--compute | --volume | --network)
openstack quota 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]
[--project <project>] [--detail]
(--compute | --volume | --network)
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--project <project> | List quotas for this project <project> (name or id) |
--detail | Show details about quotas usage |
--compute | List compute quota |
--volume | List volume quota |
--network | List network quota |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
62.2. quota set
Set quotas for project or class
Usage:
openstack quota set [-h] [--class] [--cores <cores>] [--fixed-ips <fixed-ips>] [--injected-file-size <injected-file-size>] [--injected-path-size <injected-path-size>] [--injected-files <injected-files>] [--instances <instances>] [--key-pairs <key-pairs>] [--properties <properties>] [--ram <ram>] [--server-groups <server-groups>] [--server-group-members <server-group-members>] [--backups <backups>] [--backup-gigabytes <backup-gigabytes>] [--gigabytes <gigabytes>] [--per-volume-gigabytes <per-volume-gigabytes>] [--snapshots <snapshots>] [--volumes <volumes>] [--floating-ips <floating-ips>] [--secgroup-rules <secgroup-rules>] [--secgroups <secgroups>] [--networks <networks>] [--subnets <subnets>] [--ports <ports>] [--routers <routers>] [--rbac-policies <rbac-policies>] [--vips <vips>] [--subnetpools <subnetpools>] [--health-monitors <health-monitors>] [--l7policies <l7policies>] [--volume-type <volume-type>] <project/class>
openstack quota set [-h] [--class] [--cores <cores>]
[--fixed-ips <fixed-ips>]
[--injected-file-size <injected-file-size>]
[--injected-path-size <injected-path-size>]
[--injected-files <injected-files>]
[--instances <instances>] [--key-pairs <key-pairs>]
[--properties <properties>] [--ram <ram>]
[--server-groups <server-groups>]
[--server-group-members <server-group-members>]
[--backups <backups>]
[--backup-gigabytes <backup-gigabytes>]
[--gigabytes <gigabytes>]
[--per-volume-gigabytes <per-volume-gigabytes>]
[--snapshots <snapshots>] [--volumes <volumes>]
[--floating-ips <floating-ips>]
[--secgroup-rules <secgroup-rules>]
[--secgroups <secgroups>] [--networks <networks>]
[--subnets <subnets>] [--ports <ports>]
[--routers <routers>]
[--rbac-policies <rbac-policies>] [--vips <vips>]
[--subnetpools <subnetpools>]
[--health-monitors <health-monitors>]
[--l7policies <l7policies>]
[--volume-type <volume-type>]
<project/class>
Value | Summary |
---|---|
<project/class> | Set quotas for this project or class (name/id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--class | Set quotas for <class> |
--cores <cores> | New value for the cores quota |
--fixed-ips <fixed-ips> | New value for the fixed-ips quota |
--injected-file-size <injected-file-size> | New value for the injected-file-size quota |
--injected-path-size <injected-path-size> | New value for the injected-path-size quota |
--injected-files <injected-files> | New value for the injected-files quota |
--instances <instances> | New value for the instances quota |
--key-pairs <key-pairs> | New value for the key-pairs quota |
--properties <properties> | New value for the properties quota |
--ram <ram> | New value for the ram quota |
--server-groups <server-groups> | New value for the server-groups quota |
--server-group-members <server-group-members> | New value for the server-group-members quota |
--backups <backups> | New value for the backups quota |
--backup-gigabytes <backup-gigabytes> | New value for the backup-gigabytes quota |
--gigabytes <gigabytes> | New value for the gigabytes quota |
--per-volume-gigabytes <per-volume-gigabytes> | New value for the per-volume-gigabytes quota |
--snapshots <snapshots> | New value for the snapshots quota |
--volumes <volumes> | New value for the volumes quota |
--floating-ips <floating-ips> | New value for the floating-ips quota |
--secgroup-rules <secgroup-rules> | New value for the secgroup-rules quota |
--secgroups <secgroups> | New value for the secgroups quota |
--networks <networks> | New value for the networks quota |
--subnets <subnets> | New value for the subnets quota |
--ports <ports> | New value for the ports quota |
--routers <routers> | New value for the routers quota |
--rbac-policies <rbac-policies> | New value for the rbac-policies quota |
--vips <vips> | New value for the vips quota |
--subnetpools <subnetpools> | New value for the subnetpools quota |
--health-monitors <health-monitors> | New value for the health-monitors quota |
--l7policies <l7policies> | New value for the l7policies quota |
--volume-type <volume-type> | Set quotas for a specific <volume-type> |
62.3. quota show
Show quotas for project or class. Specify ``--os-compute-api-version 2.50`` or higher to see ``server-groups`` and ``server-group-members`` output for a given quota class.
Usage:
openstack quota show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--class | --default] [<project/class>]
openstack quota show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--class | --default]
[<project/class>]
Value | Summary |
---|---|
<project/class> | Show quotas for this project or class (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--class | Show quotas for <class> |
--default | Show default quotas for <project> |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 63. recordset
This chapter describes the commands under the recordset
command.
63.1. recordset create
Create new recordset
Usage:
openstack recordset create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --record RECORD --type TYPE [--ttl TTL] [--description DESCRIPTION] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] zone_id name
openstack recordset create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --record RECORD --type TYPE
[--ttl TTL] [--description DESCRIPTION]
[--all-projects] [--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
zone_id name
Value | Summary |
---|---|
zone_id | Zone id |
name | Recordset name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--record RECORD | Recordset record, repeat if necessary |
--type TYPE | Recordset type |
--ttl TTL | Time to live (seconds) |
--description DESCRIPTION | Description |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
63.2. recordset delete
Delete recordset
Usage:
openstack recordset delete [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] zone_id id
openstack recordset delete [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
zone_id id
Value | Summary |
---|---|
zone_id | Zone id |
id | Recordset id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
63.3. recordset list
List recordsets
Usage:
openstack recordset 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] [--type TYPE] [--data DATA] [--ttl TTL] [--description DESCRIPTION] [--status STATUS] [--action ACTION] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] zone_id
openstack recordset 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]
[--type TYPE] [--data DATA] [--ttl TTL]
[--description DESCRIPTION] [--status STATUS]
[--action ACTION] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
zone_id
Value | Summary |
---|---|
zone_id | Zone id. to list all recordsets specify all |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME | Recordset name |
--type TYPE | Recordset type |
--data DATA | Recordset record data |
--ttl TTL | Time to live (seconds) |
--description DESCRIPTION | Description |
--status STATUS | Recordset status |
--action ACTION | Recordset action |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
63.4. recordset set
Set recordset properties
Usage:
openstack recordset set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--record RECORD] [--description DESCRIPTION | --no-description] [--ttl TTL | --no-ttl] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] zone_id id
openstack recordset set [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--record RECORD]
[--description DESCRIPTION | --no-description]
[--ttl TTL | --no-ttl] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
zone_id id
Value | Summary |
---|---|
zone_id | Zone id |
id | Recordset id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--record RECORD | Recordset record, repeat if necessary |
--description DESCRIPTION | Description |
--no-description—ttl TTL | Ttl |
--no-ttl—all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
63.5. recordset show
Show recordset details
Usage:
openstack recordset show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--all-projects] [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID] zone_id id
openstack recordset show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--all-projects]
[--edit-managed]
[--sudo-project-id SUDO_PROJECT_ID]
zone_id id
Value | Summary |
---|---|
zone_id | Zone id |
id | Recordset id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--all-projects | Show results from all projects. default: false |
--edit-managed | Edit resources marked as managed. default: false |
--sudo-project-id SUDO_PROJECT_ID | Project id to impersonate for this command. default: None |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 64. region
This chapter describes the commands under the region
command.
64.1. region create
Create new region
Usage:
openstack region create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--parent-region <region-id>] [--description <description>] <region-id>
openstack region create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--parent-region <region-id>]
[--description <description>]
<region-id>
Value | Summary |
---|---|
<region-id> | New region id |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--parent-region <region-id> | Parent region id |
--description <description> | New region description |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
64.2. region delete
Delete region(s)
Usage:
openstack region delete [-h] <region-id> [<region-id> ...]
openstack region delete [-h] <region-id> [<region-id> ...]
Value | Summary |
---|---|
<region-id> | Region id(s) to delete |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
64.3. region list
List regions
Usage:
openstack region 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] [--parent-region <region-id>]
openstack region 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]
[--parent-region <region-id>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--parent-region <region-id> | Filter by parent region id |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
64.4. region set
Set region properties
Usage:
openstack region set [-h] [--parent-region <region-id>] [--description <description>] <region-id>
openstack region set [-h] [--parent-region <region-id>]
[--description <description>]
<region-id>
Value | Summary |
---|---|
<region-id> | Region to modify |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--parent-region <region-id> | New parent region id |
--description <description> | New region description |
64.5. region show
Display region details
Usage:
openstack region show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <region-id>
openstack region show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<region-id>
Value | Summary |
---|---|
<region-id> | Region to display |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 65. registered
This chapter describes the commands under the registered
command.
65.1. registered limit create
Create a registered limit
Usage:
openstack registered limit create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--description <description>] [--region <region>] --service <service> --default-limit <default-limit> <resource-name>
openstack registered limit create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--description <description>]
[--region <region>] --service
<service> --default-limit
<default-limit>
<resource-name>
Value | Summary |
---|---|
<resource-name> | The name of the resource to limit |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--description <description> | Description of the registered limit |
--region <region> | Region for the registered limit to affect |
--service <service> | Service responsible for the resource to limit (required) |
--default-limit <default-limit> | The default limit for the resources to assume (required) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
65.2. registered limit delete
Delete a registered limit
Usage:
openstack registered limit delete [-h] <registered-limit-id> [<registered-limit-id> ...]
openstack registered limit delete [-h]
<registered-limit-id>
[<registered-limit-id> ...]
Value | Summary |
---|---|
<registered-limit-id> | Registered limit to delete (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
65.3. registered limit list
List registered limits
Usage:
openstack registered limit 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] [--service <service>] [--resource-name <resource-name>] [--region <region>]
openstack registered limit 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]
[--service <service>]
[--resource-name <resource-name>]
[--region <region>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--service <service> | Service responsible for the resource to limit |
--resource-name <resource-name> | The name of the resource to limit |
--region <region> | Region for the limit to affect. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
65.4. registered limit set
Update information about a registered limit
Usage:
openstack registered limit set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--service <service>] [--resource-name <resource-name>] [--default-limit <default-limit>] [--description <description>] [--region <region>] <registered-limit-id>
openstack registered limit set [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--service <service>]
[--resource-name <resource-name>]
[--default-limit <default-limit>]
[--description <description>]
[--region <region>]
<registered-limit-id>
Value | Summary |
---|---|
<registered-limit-id> | Registered limit to update (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--service <service> | Service to be updated responsible for the resource to limit. Either --service, --resource-name or --region must be different than existing value otherwise it will be duplicate entry |
--resource-name <resource-name> | Resource to be updated responsible for the resource to limit. Either --service, --resource-name or --region must be different than existing value otherwise it will be duplicate entry |
--default-limit <default-limit> | The default limit for the resources to assume |
--description <description> | Description to update of the registered limit |
--region <region> | Region for the registered limit to affect. either --service, --resource-name or --region must be different than existing value otherwise it will be duplicate entry |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
65.5. registered limit show
Display registered limit details
Usage:
openstack registered limit show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <registered-limit-id>
openstack registered limit show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<registered-limit-id>
Value | Summary |
---|---|
<registered-limit-id> | Registered limit to display (id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 66. request
This chapter describes the commands under the request
command.
66.1. request token authorize
Authorize a request token
Usage:
openstack request token authorize [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] --request-key <request-key> --role <role>
openstack request token authorize [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] --request-key
<request-key> --role <role>
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--request-key <request-key> | Request token to authorize (id only) (required) |
--role <role> | Roles to authorize (name or id) (repeat option to set multiple values) (required) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
66.2. request token create
Create a request token
Usage:
openstack request 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> --project <project> [--domain <domain>]
openstack request 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> --project <project>
[--domain <domain>]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--consumer-key <consumer-key> | Consumer key (required) |
--consumer-secret <consumer-secret> | Consumer secret (required) |
--project <project> | Project that consumer wants to access (name or id) (required) |
--domain <domain> | Domain owning <project> (name or id) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 67. resource
This chapter describes the commands under the resource
command.
67.1. resource member create
Shares a resource to another tenant.
Usage:
openstack resource member create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] resource_id resource_type member_id
openstack resource member create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
resource_id resource_type member_id
Value | Summary |
---|---|
resource_id | Resource id to be shared. |
resource_type | Resource type. |
member_id | Project id to whom the resource is shared to. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
67.2. resource member delete
Delete a resource sharing relationship.
Usage:
openstack resource member delete [-h] resource resource_type member_id
openstack resource member delete [-h] resource resource_type member_id
Value | Summary |
---|---|
resource | Resource id to be shared. |
resource_type | Resource type. |
member_id | Project id to whom the resource is shared to. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
67.3. resource member list
List all members.
Usage:
openstack resource member 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] resource_id resource_type
openstack resource member 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]
resource_id resource_type
Value | Summary |
---|---|
resource_id | Resource id to be shared. |
resource_type | Resource type. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--marker [MARKER] | The last execution uuid of the previous page, displays list of executions after "marker". |
--limit [LIMIT] | Maximum number of entries to return in a single result. |
--sort_keys [SORT_KEYS] | Comma-separated list of sort keys to sort results by. Default: created_at. Example: mistral execution-list --sort_keys=id,description |
--sort_dirs [SORT_DIRS] | Comma-separated list of sort directions. default: asc. Example: mistral execution-list --sort_keys=id,description --sort_dirs=asc,desc |
--filter FILTERS | Filters. can be repeated. |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
67.4. resource member show
Show specific member information.
Usage:
openstack resource member show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [-m MEMBER_ID] resource resource_type
openstack resource member show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [-m MEMBER_ID]
resource resource_type
Value | Summary |
---|---|
resource | Resource id to be shared. |
resource_type | Resource type. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-m MEMBER_ID, --member-id MEMBER_ID | Project id to whom the resource is shared to. no need to provide this param if you are the resource member. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
67.5. resource member update
Update resource sharing status.
Usage:
openstack resource member update [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [-m MEMBER_ID] [-s {pending,accepted,rejected}] resource_id resource_type
openstack resource member update [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [-m MEMBER_ID]
[-s {pending,accepted,rejected}]
resource_id resource_type
Value | Summary |
---|---|
resource_id | Resource id to be shared. |
resource_type | Resource type. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
-m MEMBER_ID, --member-id MEMBER_ID | Project id to whom the resource is shared to. no need to provide this param if you are the resource member. |
-s {pending,accepted,rejected}, --status {pending,accepted,rejected} | Status of the sharing. |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 68. role
This chapter describes the commands under the role
command.
68.1. role add
Adds a role assignment to a user or group on the system, a domain, or a project
Usage:
openstack role add [-h] [--system <system> | --domain <domain> | --project <project>] [--user <user> | --group <group>] [--group-domain <group-domain>] [--project-domain <project-domain>] [--user-domain <user-domain>] [--inherited] [--role-domain <role-domain>] <role>
openstack role add [-h]
[--system <system> | --domain <domain> | --project <project>]
[--user <user> | --group <group>]
[--group-domain <group-domain>]
[--project-domain <project-domain>]
[--user-domain <user-domain>] [--inherited]
[--role-domain <role-domain>]
<role>
Value | Summary |
---|---|
<role> | Role to add to <user> (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--system <system> | Include <system> (all) |
--domain <domain> | Include <domain> (name or id) |
--project <project> | Include <project> (name or id) |
--user <user> | Include <user> (name or id) |
--group <group> | Include <group> (name or id) |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--inherited | Specifies if the role grant is inheritable to the sub projects |
--role-domain <role-domain> | Domain the role belongs to (name or id). this must be specified when the name of a domain specific role is used. |
68.2. role assignment list
List role assignments
Usage:
openstack role assignment 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] [--effective] [--role <role>] [--role-domain <role-domain>] [--names] [--user <user>] [--user-domain <user-domain>] [--group <group>] [--group-domain <group-domain>] [--domain <domain> | --project <project> | --system <system>] [--project-domain <project-domain>] [--inherited] [--auth-user] [--auth-project]
openstack role assignment 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]
[--effective] [--role <role>]
[--role-domain <role-domain>] [--names]
[--user <user>]
[--user-domain <user-domain>]
[--group <group>]
[--group-domain <group-domain>]
[--domain <domain> | --project <project> | --system <system>]
[--project-domain <project-domain>]
[--inherited] [--auth-user]
[--auth-project]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--effective | Returns only effective role assignments |
--role <role> | Role to filter (name or id) |
--role-domain <role-domain> | Domain the role belongs to (name or id). this must be specified when the name of a domain specific role is used. |
--names | Display names instead of ids |
--user <user> | User to filter (name or id) |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--group <group> | Group to filter (name or id) |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--domain <domain> | Domain to filter (name or id) |
--project <project> | Project to filter (name or id) |
--system <system> | Filter based on system role assignments |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--inherited | Specifies if the role grant is inheritable to the sub projects |
--auth-user | Only list assignments for the authenticated user |
--auth-project | Only list assignments for the project to which the authenticated user’s token is scoped |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
68.3. role create
Create new role
Usage:
openstack role create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--domain <domain>] [--or-show] <role-name>
openstack role create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--domain <domain>] [--or-show]
<role-name>
Value | Summary |
---|---|
<role-name> | New role name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain the role belongs to (name or id) |
--or-show | Return existing role |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
68.4. role delete
Delete role(s)
Usage:
openstack role delete [-h] [--domain <domain>] <role> [<role> ...]
openstack role delete [-h] [--domain <domain>] <role> [<role> ...]
Value | Summary |
---|---|
<role> | Role(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain the role belongs to (name or id) |
68.5. role list
List roles
Usage:
openstack role 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] [--system <system> | --domain <domain> | --project <project>] [--user <user> | --group <group>] [--group-domain <group-domain>] [--project-domain <project-domain>] [--user-domain <user-domain>] [--inherited]
openstack role 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]
[--system <system> | --domain <domain> | --project <project>]
[--user <user> | --group <group>]
[--group-domain <group-domain>]
[--project-domain <project-domain>]
[--user-domain <user-domain>] [--inherited]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--system <system> | Include <system> (all) |
--domain <domain> | Include <domain> (name or id) |
--project <project> | Include <project> (name or id) |
--user <user> | Include <user> (name or id) |
--group <group> | Include <group> (name or id) |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--inherited | Specifies if the role grant is inheritable to the sub projects |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
68.6. role remove
Removes a role assignment from system/domain/project : user/group
Usage:
openstack role remove [-h] [--system <system> | --domain <domain> | --project <project>] [--user <user> | --group <group>] [--group-domain <group-domain>] [--project-domain <project-domain>] [--user-domain <user-domain>] [--inherited] [--role-domain <role-domain>] <role>
openstack role remove [-h]
[--system <system> | --domain <domain> | --project <project>]
[--user <user> | --group <group>]
[--group-domain <group-domain>]
[--project-domain <project-domain>]
[--user-domain <user-domain>] [--inherited]
[--role-domain <role-domain>]
<role>
Value | Summary |
---|---|
<role> | Role to remove (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--system <system> | Include <system> (all) |
--domain <domain> | Include <domain> (name or id) |
--project <project> | Include <project> (name or id) |
--user <user> | Include <user> (name or id) |
--group <group> | Include <group> (name or id) |
--group-domain <group-domain> | Domain the group belongs to (name or id). this can be used in case collisions between group names exist. |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
--inherited | Specifies if the role grant is inheritable to the sub projects |
--role-domain <role-domain> | Domain the role belongs to (name or id). this must be specified when the name of a domain specific role is used. |
68.7. role set
Set role properties
Usage:
openstack role set [-h] [--domain <domain>] [--name <name>] <role>
openstack role set [-h] [--domain <domain>] [--name <name>] <role>
Value | Summary |
---|---|
<role> | Role to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain the role belongs to (name or id) |
--name <name> | Set role name |
68.8. role show
Display role details
Usage:
openstack role show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--domain <domain>] <role>
openstack role show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--domain <domain>]
<role>
Value | Summary |
---|---|
<role> | Role to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--domain <domain> | Domain the role belongs to (name or id) |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
Chapter 69. router
This chapter describes the commands under the router
command.
69.1. router add port
Add a port to a router
Usage:
openstack router add port [-h] <router> <port>
openstack router add port [-h] <router> <port>
Value | Summary |
---|---|
<router> | Router to which port will be added (name or id) |
<port> | Port to be added (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
69.2. router add subnet
Add a subnet to a router
Usage:
openstack router add subnet [-h] <router> <subnet>
openstack router add subnet [-h] <router> <subnet>
Value | Summary |
---|---|
<router> | Router to which subnet will be added (name or id) |
<subnet> | Subnet to be added (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
69.3. router create
Create a new router
Usage:
openstack router create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--enable | --disable] [--distributed | --centralized] [--ha | --no-ha] [--description <description>] [--project <project>] [--project-domain <project-domain>] [--availability-zone-hint <availability-zone>] [--tag <tag> | --no-tag] <name>
openstack router create [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--enable | --disable]
[--distributed | --centralized]
[--ha | --no-ha] [--description <description>]
[--project <project>]
[--project-domain <project-domain>]
[--availability-zone-hint <availability-zone>]
[--tag <tag> | --no-tag]
<name>
Value | Summary |
---|---|
<name> | New router name |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--enable | Enable router (default) |
--disable | Disable router |
--distributed | Create a distributed router |
--centralized | Create a centralized router |
--ha | Create a highly available router |
--no-ha | Create a legacy router |
--description <description> | Set router description |
--project <project> | Owner’s project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--availability-zone-hint <availability-zone> | Availability zone in which to create this router (Router Availability Zone extension required, repeat option to set multiple availability zones) |
--tag <tag> | Tag to be added to the router (repeat option to set multiple tags) |
--no-tag | No tags associated with the router |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
69.4. router delete
Delete router(s)
Usage:
openstack router delete [-h] <router> [<router> ...]
openstack router delete [-h] <router> [<router> ...]
Value | Summary |
---|---|
<router> | Router(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
69.5. router list
List routers
Usage:
openstack router 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>] [--enable | --disable] [--long] [--project <project>] [--project-domain <project-domain>] [--agent <agent-id>] [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
openstack router 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>]
[--enable | --disable] [--long]
[--project <project>]
[--project-domain <project-domain>]
[--agent <agent-id>] [--tags <tag>[,<tag>,...]]
[--any-tags <tag>[,<tag>,...]]
[--not-tags <tag>[,<tag>,...]]
[--not-any-tags <tag>[,<tag>,...]]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | List routers according to their name |
--enable | List enabled routers |
--disable | List disabled routers |
--long | List additional fields in output |
--project <project> | List routers according to their project (name or id) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--agent <agent-id> | List routers hosted by an agent (id only) |
--tags <tag>[,<tag>,…] | List routers which have all given tag(s) (comma- separated list of tags) |
--any-tags <tag>[,<tag>,…] | List routers which have any given tag(s) (comma- separated list of tags) |
--not-tags <tag>[,<tag>,…] | Exclude routers which have all given tag(s) (comma- separated list of tags) |
--not-any-tags <tag>[,<tag>,…] | Exclude routers which have any given tag(s) (comma- separated list of tags) |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
69.6. router remove port
Remove a port from a router
Usage:
openstack router remove port [-h] <router> <port>
openstack router remove port [-h] <router> <port>
Value | Summary |
---|---|
<router> | Router from which port will be removed (name or id) |
<port> | Port to be removed and deleted (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
69.7. router remove subnet
Remove a subnet from a router
Usage:
openstack router remove subnet [-h] <router> <subnet>
openstack router remove subnet [-h] <router> <subnet>
Value | Summary |
---|---|
<router> | Router from which the subnet will be removed (name or id) |
<subnet> | Subnet to be removed (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
69.8. router set
Set router properties
Usage:
openstack router set [-h] [--name <name>] [--description <description>] [--enable | --disable] [--distributed | --centralized] [--route destination=<subnet>,gateway=<ip-address>] [--no-route] [--ha | --no-ha] [--external-gateway <network>] [--fixed-ip subnet=<subnet>,ip-address=<ip-address>] [--enable-snat | --disable-snat] [--qos-policy <qos-policy> | --no-qos-policy] [--tag <tag>] [--no-tag] <router>
openstack router set [-h] [--name <name>] [--description <description>]
[--enable | --disable]
[--distributed | --centralized]
[--route destination=<subnet>,gateway=<ip-address>]
[--no-route] [--ha | --no-ha]
[--external-gateway <network>]
[--fixed-ip subnet=<subnet>,ip-address=<ip-address>]
[--enable-snat | --disable-snat]
[--qos-policy <qos-policy> | --no-qos-policy]
[--tag <tag>] [--no-tag]
<router>
Value | Summary |
---|---|
<router> | Router to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name <name> | Set router name |
--description <description> | Set router description |
--enable | Enable router |
--disable | Disable router |
--distributed | Set router to distributed mode (disabled router only) |
--centralized | Set router to centralized mode (disabled router only) |
--route destination=<subnet>,gateway=<ip-address> | Routes associated with the router destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to set multiple routes) |
--no-route | Clear routes associated with the router. specify both --route and --no-route to overwrite current value of route. |
--ha | Set the router as highly available (disabled router only) |
--no-ha | Clear high availability attribute of the router (disabled router only) |
--external-gateway <network> | External network used as router’s gateway (name or id) |
--fixed-ip subnet=<subnet>,ip-address=<ip-address> | Desired ip and/or subnet (name or id) on external gateway: subnet=<subnet>,ip-address=<ip-address> (repeat option to set multiple fixed IP addresses) |
--enable-snat | Enable source nat on external gateway |
--disable-snat | Disable source nat on external gateway |
--qos-policy <qos-policy> | Attach qos policy to router gateway ips |
--no-qos-policy | Remove qos policy from router gateway ips |
--tag <tag> | Tag to be added to the router (repeat option to set multiple tags) |
--no-tag | Clear tags associated with the router. specify both --tag and --no-tag to overwrite current tags |
69.9. router show
Display router details
Usage:
openstack router show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <router>
openstack router show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<router>
Value | Summary |
---|---|
<router> | Router to display (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
69.10. router unset
Unset router properties
Usage:
openstack router unset [-h] [--route destination=<subnet>,gateway=<ip-address>] [--external-gateway] [--qos-policy] [--tag <tag> | --all-tag] <router>
openstack router unset [-h]
[--route destination=<subnet>,gateway=<ip-address>]
[--external-gateway] [--qos-policy]
[--tag <tag> | --all-tag]
<router>
Value | Summary |
---|---|
<router> | Router to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--route destination=<subnet>,gateway=<ip-address> | Routes to be removed from the router destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to unset multiple routes) |
--external-gateway | Remove external gateway information from the router |
--qos-policy | Remove qos policy from router gateway ips |
--tag <tag> | Tag to be removed from the router (repeat option to remove multiple tags) |
--all-tag | Clear all tags associated with the router |
Chapter 70. secret
This chapter describes the commands under the secret
command.
70.1. secret container create
Store a container in Barbican.
Usage:
openstack secret container create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--name NAME] [--type TYPE] [--secret SECRET]
openstack secret container create [-h]
[-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty] [--name NAME]
[--type TYPE] [--secret SECRET]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--name NAME, -n NAME | A human-friendly name. |
--type TYPE | Type of container to create (default: generic). |
--secret SECRET, -s SECRET | One secret to store in a container (can be set multiple times). Example: --secret "private_key=https://url.test/v1/secrets/1-2-3-4" |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
70.2. secret container delete
Delete a container by providing its href.
Usage:
openstack secret container delete [-h] URI
openstack secret container delete [-h] URI
Value | Summary |
---|---|
URI | The uri reference for the container |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
70.3. secret container get
Retrieve a container by providing its URI.
Usage:
openstack secret container get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] URI
openstack secret container get [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
URI
Value | Summary |
---|---|
URI | The uri reference for the container. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
70.4. secret container list
List containers.
Usage:
openstack secret container 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] [--offset OFFSET] [--name NAME] [--type TYPE]
openstack secret container 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] [--offset OFFSET]
[--name NAME] [--type TYPE]
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--limit LIMIT, -l LIMIT | Specify the limit to the number of items to list per page (default: 10; maximum: 100) |
--offset OFFSET, -o OFFSET | Specify the page offset (default: 0) |
--name NAME, -n NAME | Specify the container name (default: none) |
--type TYPE, -t TYPE | Specify the type filter for the list (default: none). |
Value | Summary |
---|---|
output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
--sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
70.5. secret delete
Delete a secret by providing its URI.
Usage:
openstack secret delete [-h] URI
openstack secret delete [-h] URI
Value | Summary |
---|---|
URI | The uri reference for the secret |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
70.6. secret get
Retrieve a secret by providing its URI.
Usage:
openstack secret get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--decrypt | --payload | --file <filename>] [--payload_content_type PAYLOAD_CONTENT_TYPE] URI
openstack secret get [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--noindent] [--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
[--decrypt | --payload | --file <filename>]
[--payload_content_type PAYLOAD_CONTENT_TYPE]
URI
Value | Summary |
---|---|
URI | The uri reference for the secret. |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--decrypt, -d | If specified, retrieve the unencrypted secret data. |
--payload, -p | If specified, retrieve the unencrypted secret data. |
--file <filename>, -F <filename> | If specified, save the payload to a new file with the given filename. |
--payload_content_type PAYLOAD_CONTENT_TYPE, -t PAYLOAD_CONTENT_TYPE | The content type of the decrypted secret (default: text/plain). |
Value | Summary |
---|---|
output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table |
-c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
Value | Summary |
---|---|
--max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. |
--fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable |
--print-empty | Print empty table if there is no data to show. |
70.7. secret list
List secrets.
Usage: