このコンテンツは選択した言語では利用できません。

Command Line Interface Reference


Red Hat OpenStack Platform 14

Command-line clients for Red Hat OpenStack Platform

OpenStack Documentation Team

Abstract

A reference to the commands available to the unified OpenStack command-line client.

Preface

A reference to the commands available to the unified OpenStack command-line client.

Chapter 1. The OpenStack Client

The openstack client is a common OpenStack command-line interface (CLI).

1.1. openstack

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-network-api-version <network-api-version>]
               [--os-image-api-version <image-api-version>]
               [--os-volume-api-version <volume-api-version>]
               [--os-identity-api-version <identity-api-version>]
               [--os-object-api-version <object-api-version>]
               [--os-metrics-api-version <metrics-api-version>]
               [--os-key-manager-api-version <key-manager-api-version>]
               [--os-dns-api-version <dns-api-version>]
               [--os-orchestration-api-version <orchestration-api-version>]
               [--os-queues-api-version <queues-api-version>]
               [--os-workflow-api-version <workflow-api-version>]
               [--os-database-api-version <database-api-version>]
               [--os-alarming-api-version <alarming-api-version>]
               [--inspector-api-version INSPECTOR_API_VERSION]
               [--inspector-url INSPECTOR_URL]
               [--os-container-infra-api-version <container-infra-api-version>]
               [--os-loadbalancer-api-version <loadbalancer-api-version>]
               [--os-data-processing-api-version <data-processing-api-version>]
               [--os-data-processing-url OS_DATA_PROCESSING_URL]
               [--os-baremetal-api-version <baremetal-api-version>]
               [--os-auth-type <auth-type>]
               [--os-project-domain-id <auth-project-domain-id>]
               [--os-protocol <auth-protocol>]
               [--os-project-name <auth-project-name>]
               [--os-trust-id <auth-trust-id>]
               [--os-consumer-key <auth-consumer-key>]
               [--os-domain-name <auth-domain-name>]
               [--os-access-secret <auth-access-secret>]
               [--os-user-domain-id <auth-user-domain-id>]
               [--os-access-token-type <auth-access-token-type>]
               [--os-code <auth-code>]
               [--os-application-credential-name <auth-application-credential-name>]
               [--os-identity-provider-url <auth-identity-provider-url>]
               [--os-aodh-endpoint <auth-aodh-endpoint>]
               [--os-service-provider-endpoint <auth-service-provider-endpoint>]
               [--os-access-token <auth-access-token>]
               [--os-domain-id <auth-domain-id>]
               [--os-user-domain-name <auth-user-domain-name>]
               [--os-openid-scope <auth-openid-scope>]
               [--os-user-id <auth-user-id>]
               [--os-application-credential-secret <auth-application-credential-secret>]
               [--os-identity-provider <auth-identity-provider>]
               [--os-username <auth-username>]
               [--os-auth-url <auth-auth-url>]
               [--os-client-secret <auth-client-secret>]
               [--os-access-token-endpoint <auth-access-token-endpoint>]
               [--os-default-domain-id <auth-default-domain-id>]
               [--os-discovery-endpoint <auth-discovery-endpoint>]
               [--os-client-id <auth-client-id>]
               [--os-default-domain-name <auth-default-domain-name>]
               [--os-project-domain-name <auth-project-domain-name>]
               [--os-service-provider-entity-id <auth-service-provider-entity-id>]
               [--os-access-key <auth-access-key>]
               [--os-password <auth-password>]
               [--os-redirect-uri <auth-redirect-uri>]
               [--os-endpoint <auth-endpoint>] [--os-roles <auth-roles>]
               [--os-url <auth-url>]
               [--os-consumer-secret <auth-consumer-secret>]
               [--os-token <auth-token>]
               [--os-application-credential-id <auth-application-credential-id>]
               [--os-passcode <auth-passcode>]
               [--os-system-scope <auth-system-scope>]
               [--os-project-id <auth-project-id>] [--os-user <auth-user>]

Command-line interface to the OpenStack APIs

Expand
Table 1.1. Optional Arguments
ValueSummary

--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]. (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-network-api-version <network-api-version>

Network API version, default=2.0 (Env: OS_NETWORK_API_VERSION)

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

Image API version, default=2 (Env: OS_IMAGE_API_VERSION)

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

Volume API version, default=2 (Env: OS_VOLUME_API_VERSION)

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

Identity API version, default=3 (Env: OS_IDENTITY_API_VERSION)

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

Object API version, default=1 (Env: OS_OBJECT_API_VERSION)

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

Metrics API version, default=1 (Env: OS_METRICS_API_VERSION)

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

Barbican API version, default=1 (Env: OS_KEY_MANAGER_API_VERSION)

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

DNS API version, default=2 (Env: OS_DNS_API_VERSION)

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

Orchestration API version, default=1 (Env: OS_ORCHESTRATION_API_VERSION)

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

Queues API version, default=2 (Env: OS_QUEUES_API_VERSION)

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

Workflow API version, default=2 (Env: OS_WORKFLOW_API_VERSION)

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

Database API version, default=1 (Env: OS_DATABASE_API_VERSION)

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

Queues API version, default=2 (Env: OS_ALARMING_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-container-infra-api-version <container-infra-api-version>

Container-Infra API version, default=1 (Env: OS_CONTAINER_INFRA_API_VERSION)

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

OSC Plugin API version, default=2.0 (Env: OS_LOADBALANCER_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-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)

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

Select an authentication type. Available types: v2token, v3adfspassword, admin_token, v2password, v3password, v3tokenlessauth, v3token, v3oauth1, v3oidcauthcode, v3samlpassword, token_endpoint, v1password, v3totp, aodh-noauth, v3oidcclientcredentials, gnocchi-basic, gnocchi- noauth, password, none, v3oidcaccesstoken, v3oidcpassword, token, v3applicationcredential, noauth. Default: selected based on --os-username/--os- token (Env: OS_AUTH_TYPE)

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

With v3adfspassword: Domain ID containing project With v3password: Domain ID containing project With v3tokenlessauth: Domain ID containing project With v3token: Domain ID containing project With v3oidcauthcode: Domain ID containing project With v3samlpassword: Domain ID containing project With v3totp: Domain ID containing project With v3oidcclientcredentials: Domain ID containing project With password: Domain ID containing project With v3oidcaccesstoken: Domain ID containing project With v3oidcpassword: Domain ID containing project With token: Domain ID containing project With v3applicationcredential: Domain ID containing project (Env: OS_PROJECT_DOMAIN_ID)

--os-protocol <auth-protocol>

With v3adfspassword: Protocol for federated plugin With v3oidcauthcode: Protocol for federated plugin With v3samlpassword: Protocol for federated plugin With v3oidcclientcredentials: Protocol for federated plugin With v3oidcaccesstoken: Protocol for federated plugin With v3oidcpassword: Protocol for federated plugin (Env: OS_PROTOCOL)

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

With v3adfspassword: Project name to scope to With v3password: Project name to scope to With v3tokenlessauth: Project name to scope to With v3token: Project name to scope to With v3oidcauthcode: Project name to scope to With v3samlpassword: Project name to scope to With v1password: Swift account to use With v3totp: Project name to scope to With v3oidcclientcredentials: Project name to scope to With password: Project name to scope to With v3oidcaccesstoken: Project name to scope to With v3oidcpassword: Project name to scope to With token: Project name to scope to With v3applicationcredential: Project name to scope to (Env: OS_PROJECT_NAME)

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

With v2token: Trust ID With v3adfspassword: Trust ID With v2password: Trust ID With v3password: Trust ID With v3token: Trust ID With v3oidcauthcode: Trust ID With v3samlpassword: Trust ID With v3totp: Trust ID With v3oidcclientcredentials: Trust ID With password: Trust ID With v3oidcaccesstoken: Trust ID With v3oidcpassword: Trust ID With token: Trust ID With v3applicationcredential: Trust ID (Env: OS_TRUST_ID)

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

With v3oauth1: OAuth Consumer ID/Key (Env: OS_CONSUMER_KEY)

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

With v3adfspassword: Domain name to scope to With v3password: Domain name to scope to With v3tokenlessauth: Domain name to scope to With v3token: Domain name to scope to With v3oidcauthcode: Domain name to scope to With v3samlpassword: Domain name to scope to With v3totp: Domain name to scope to With v3oidcclientcredentials: Domain name to scope to With password: Domain name to scope to With v3oidcaccesstoken: Domain name to scope to With v3oidcpassword: Domain name to scope to With token: Domain name to scope to With v3applicationcredential: Domain name to scope to (Env: OS_DOMAIN_NAME)

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

With v3oauth1: OAuth Access Secret (Env: OS_ACCESS_SECRET)

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

With v3password: User’s domain id With v3totp: User’s domain id With password: User’s domain id With v3applicationcredential: User’s domain id (Env: OS_USER_DOMAIN_ID)

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

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" 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 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" (Env: OS_ACCESS_TOKEN_TYPE)

--os-code <auth-code>

With v3oidcauthcode: OAuth 2.0 Authorization Code (Env: OS_CODE)

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

With v3applicationcredential: Application credential name (Env: OS_APPLICATION_CREDENTIAL_NAME)

--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-aodh-endpoint <auth-aodh-endpoint>

With aodh-noauth: Aodh endpoint (Env: OS_AODH_ENDPOINT)

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

With v3adfspassword: Service Provider’s Endpoint (Env: OS_SERVICE_PROVIDER_ENDPOINT)

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

With v3oidcaccesstoken: OAuth 2.0 Access Token (Env: OS_ACCESS_TOKEN)

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

With v3adfspassword: Domain ID to scope to With v3password: Domain ID to scope to With v3tokenlessauth: Domain ID to scope to With v3token: Domain ID to scope to With v3oidcauthcode: Domain ID to scope to With v3samlpassword: Domain ID to scope to With v3totp: Domain ID to scope to With v3oidcclientcredentials: Domain ID to scope to With password: Domain ID to scope to With v3oidcaccesstoken: Domain ID to scope to With v3oidcpassword: Domain ID to scope to With token: Domain ID to scope to With v3applicationcredential: Domain ID to scope to (Env: OS_DOMAIN_ID)

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

With v3password: User’s domain name With v3totp: User’s domain name With password: User’s domain name With v3applicationcredential: User’s domain name (Env: OS_USER_DOMAIN_NAME)

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

With v3oidcauthcode: 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 v3oidcpassword: 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-user-id <auth-user-id>

With v2password: User ID to login with With v3password: User ID With v3totp: User ID With aodh- noauth: User ID With gnocchi-noauth: User ID With password: User id With v3applicationcredential: User ID With noauth: User ID (Env: OS_USER_ID)

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

With v3applicationcredential: Application credential auth secret (Env: OS_APPLICATION_CREDENTIAL_SECRET)

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

With v3adfspassword: Identity Provider’s name With v3oidcauthcode: Identity Provider’s name With v3samlpassword: Identity Provider’s name With v3oidcclientcredentials: Identity Provider’s name With v3oidcaccesstoken: Identity Provider’s name With v3oidcpassword: Identity Provider’s name (Env: OS_IDENTITY_PROVIDER)

--os-username <auth-username>

With v3adfspassword: Username With v2password: Username to login with With v3password: Username With v3samlpassword: Username With v1password: Username to login with With v3totp: Username With password: Username With v3oidcpassword: Username With v3applicationcredential: Username (Env: OS_USERNAME)

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

With v2token: Authentication URL With v3adfspassword: Authentication URL With v2password: Authentication URL With v3password: Authentication URL With v3tokenlessauth: Authentication URL With v3token: Authentication URL With v3oauth1: Authentication URL With v3oidcauthcode: Authentication URL With v3samlpassword: Authentication URL With v1password: Authentication URL With v3totp: Authentication URL With v3oidcclientcredentials: Authentication URL With password: Authentication URL With v3oidcaccesstoken: Authentication URL With v3oidcpassword: Authentication URL With token: Authentication URL With v3applicationcredential: Authentication URL (Env: OS_AUTH_URL)

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

With v3oidcauthcode: OAuth 2.0 Client Secret With v3oidcclientcredentials: OAuth 2.0 Client Secret With v3oidcpassword: OAuth 2.0 Client Secret (Env: OS_CLIENT_SECRET)

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

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. 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 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. (Env: OS_ACCESS_TOKEN_ENDPOINT)

--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-discovery-endpoint <auth-discovery-endpoint>

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 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 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 (Env: OS_DISCOVERY_ENDPOINT)

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

With v3oidcauthcode: OAuth 2.0 Client ID With v3oidcclientcredentials: OAuth 2.0 Client ID With v3oidcpassword: OAuth 2.0 Client ID (Env: OS_CLIENT_ID)

--os-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-project-domain-name <auth-project-domain-name>

With v3adfspassword: Domain name containing project With v3password: Domain name containing project With v3tokenlessauth: Domain name containing project With v3token: Domain name containing project With v3oidcauthcode: Domain name containing project With v3samlpassword: Domain name containing project With v3totp: Domain name containing project With v3oidcclientcredentials: Domain name containing project With password: Domain name containing project With v3oidcaccesstoken: Domain name containing project With v3oidcpassword: Domain name containing project With token: Domain name containing project With v3applicationcredential: Domain name containing project (Env: OS_PROJECT_DOMAIN_NAME)

--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-access-key <auth-access-key>

With v3oauth1: OAuth Access Key (Env: OS_ACCESS_KEY)

--os-password <auth-password>

With v3adfspassword: Password With v2password: Password to use With v3password: User’s password With v3samlpassword: Password With v1password: Password to use With password: User’s password With v3oidcpassword: Password (Env: OS_PASSWORD)

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

With v3oidcauthcode: OpenID Connect Redirect URL (Env: OS_REDIRECT_URI)

--os-endpoint <auth-endpoint>

With admin_token: The endpoint that will always be used With gnocchi-basic: Gnocchi endpoint With gnocchi-noauth: Gnocchi endpoint With none: The endpoint that will always be used With noauth: Cinder endpoint (Env: OS_ENDPOINT)

--os-roles <auth-roles>

With aodh-noauth: Roles With gnocchi-noauth: Roles (Env: OS_ROLES)

--os-url <auth-url>

With token_endpoint: specific service endpoint to use (Env: OS_URL)

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

With v3oauth1: OAuth Consumer Secret (Env: OS_CONSUMER_SECRET)

--os-token <auth-token>

With v2token: Token With admin_token: The token that will always be used With v3token: Token to authenticate with With token_endpoint: Authentication token to use With token: Token to authenticate with (Env: OS_TOKEN)

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

With v3applicationcredential: Application credential ID (Env: OS_APPLICATION_CREDENTIAL_ID)

--os-passcode <auth-passcode>

With v3totp: User’s TOTP passcode (Env: OS_PASSCODE)

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

With v3adfspassword: Scope for system operations With v3password: Scope for system operations With v3token: Scope for system operations With v3oidcauthcode: Scope for system operations With v3samlpassword: Scope for system operations With v3totp: Scope for system operations With v3oidcclientcredentials: Scope for system operations With password: Scope for system operations With v3oidcaccesstoken: Scope for system operations With v3oidcpassword: Scope for system operations With token: Scope for system operations With v3applicationcredential: Scope for system operations (Env: OS_SYSTEM_SCOPE)

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

With v3adfspassword: Project ID to scope to With v3password: Project ID to scope to With v3tokenlessauth: Project ID to scope to With v3token: Project ID to scope to With v3oidcauthcode: Project ID to scope to With v3samlpassword: Project ID to scope to With v3totp: Project ID to scope to With aodh- noauth: Project ID With v3oidcclientcredentials: Project ID to scope to With gnocchi-noauth: Project ID With password: Project ID to scope to With v3oidcaccesstoken: Project ID to scope to With v3oidcpassword: Project ID to scope to With token: Project ID to scope to With v3applicationcredential: Project ID to scope to With noauth: Project ID (Env: OS_PROJECT_ID)

--os-user <auth-user>

With gnocchi-basic: User (Env: OS_USER)

Chapter 2. acl

This chapter describes the commands under the acl command.

2.1. acl delete

Usage:

openstack acl delete [-h] URI

Delete ACLs for a secret or container as identified by its href.

Expand
Table 2.1. Positional Arguments
ValueSummary

URI

The uri reference for the secret or container.

Expand
Table 2.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-barbicanclient plugin.

2.2. acl get

Usage:

openstack acl get [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                       [--max-width <integer>] [--fit-width] [--print-empty]
                       [--noindent] [--quote {all,minimal,none,nonnumeric}]
                       [--sort-column SORT_COLUMN]
                       URI

Retrieve ACLs for a secret or container by providing its href.

Expand
Table 2.3. Positional Arguments
ValueSummary

URI

The uri reference for the secret or container.

Expand
Table 2.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 2.5. Output Formatters
ValueSummary

-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

Expand
Table 2.6. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 2.7. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 2.8. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

2.3. acl submit

Usage:

openstack acl submit [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                          [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}]
                          [--sort-column SORT_COLUMN] [--user [USERS]]
                          [--project-access | --no-project-access]
                          [--operation-type {read}]
                          URI

Submit ACL on a secret or container as identified by its href.

Expand
Table 2.9. Positional Arguments
ValueSummary

URI

The uri reference for the secret or container.

Expand
Table 2.10. Optional Arguments
ValueSummary

-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

Expand
Table 2.11. Output Formatters
ValueSummary

-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

Expand
Table 2.12. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 2.13. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 2.14. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

2.4. acl user add

Usage:

openstack acl user add [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--user [USERS]]
                            [--project-access | --no-project-access]
                            [--operation-type {read}]
                            URI

Add ACL users to a secret or container as identified by its href.

Expand
Table 2.15. Positional Arguments
ValueSummary

URI

The uri reference for the secret or container.

Expand
Table 2.16. Optional Arguments
ValueSummary

-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

Expand
Table 2.17. Output Formatters
ValueSummary

-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

Expand
Table 2.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 2.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 2.20. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

2.5. acl user remove

Usage:

openstack acl user remove [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN] [--user [USERS]]
                               [--project-access | --no-project-access]
                               [--operation-type {read}]
                               URI

Remove ACL users from a secret or container as identified by its href.

Expand
Table 2.21. Positional Arguments
ValueSummary

URI

The uri reference for the secret or container.

Expand
Table 2.22. Optional Arguments
ValueSummary

-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

Expand
Table 2.23. Output Formatters
ValueSummary

-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

Expand
Table 2.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 2.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 2.26. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

Chapter 3. action

This chapter describes the commands under the action command.

3.1. action definition create

Usage:

openstack action definition create [-h]

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

Create new action.

Expand
Table 3.1. Positional Arguments
ValueSummary

definition

Action definition file

Expand
Table 3.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--public

With this flag action will be marked as "public".

Expand
Table 3.3. Output Formatters
ValueSummary

-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

Expand
Table 3.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

3.2. action definition definition show

Usage:

openstack action definition definition show [-h] name

Show action definition.

Expand
Table 3.7. Positional Arguments
ValueSummary

name

Action name

Expand
Table 3.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

3.3. action definition delete

Usage:

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

Delete action.

Expand
Table 3.9. Positional Arguments
ValueSummary

action

Name or id of action(s).

Expand
Table 3.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

3.4. action definition list

Usage:

openstack action definition list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--filter FILTERS]

List all actions.

Expand
Table 3.11. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--filter FILTERS

Filters. can be repeated.

Expand
Table 3.12. Output Formatters
ValueSummary

-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

Expand
Table 3.13. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.14. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.15. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

3.5. action definition show

Usage:

openstack action definition show [-h]

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

Show specific action.

Expand
Table 3.16. Positional Arguments
ValueSummary

action

Action (name or id)

Expand
Table 3.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 3.18. Output Formatters
ValueSummary

-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

Expand
Table 3.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

3.6. action definition update

Usage:

openstack action definition update [-h]

                                        [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--sort-column SORT_COLUMN]
                                        [--id ID] [--public]
                                        definition

Update action.

Expand
Table 3.22. Positional Arguments
ValueSummary

definition

Action definition file

Expand
Table 3.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--id ID

Action id.

--public

With this flag action will be marked as "public".

Expand
Table 3.24. Output Formatters
ValueSummary

-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

Expand
Table 3.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.27. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

3.7. action execution delete

Usage:

openstack action execution delete [-h]

                                       action_execution
                                       [action_execution ...]

Delete action execution.

Expand
Table 3.28. Positional Arguments
ValueSummary

action_execution

Id of action execution identifier(s).

Expand
Table 3.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

3.8. action execution input show

Usage:

openstack action execution input show [-h] id

Show Action execution input data.

Expand
Table 3.30. Positional Arguments
ValueSummary

id

Action execution id.

Expand
Table 3.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

3.9. action execution list

Usage:

openstack action execution list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     [--limit [LIMIT]]
                                     [task_execution_id]

List all Action executions.

Expand
Table 3.32. Positional Arguments
ValueSummary

task_execution_id

Task execution id.

Expand
Table 3.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit [LIMIT]

Maximum number of action-executions to return in a single result. limit is set to 100 by default. Use

--limit -1 to fetch the full result set.

 
Expand
Table 3.34. Output Formatters
ValueSummary

-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

Expand
Table 3.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.37. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

3.10. action execution output show

Usage:

openstack action execution output show [-h] id

Show Action execution output data.

Expand
Table 3.38. Positional Arguments
ValueSummary

id

Action execution id.

Expand
Table 3.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

3.11. action execution run

Usage:

openstack action execution run [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX] [-s]
                                    [--run-sync] [-t TARGET]
                                    name [input]

Create new Action execution or just run specific action.

Expand
Table 3.40. Positional Arguments
ValueSummary

name

Action name to execute.

input

Action input.

Expand
Table 3.41. Optional Arguments
ValueSummary

-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.

Expand
Table 3.42. Output Formatters
ValueSummary

-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

Expand
Table 3.43. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.44. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.45. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

3.12. action execution show

Usage:

openstack action execution show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     action_execution

Show specific Action execution.

Expand
Table 3.46. Positional Arguments
ValueSummary

action_execution

Action execution id.

Expand
Table 3.47. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 3.48. Output Formatters
ValueSummary

-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

Expand
Table 3.49. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.50. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.51. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

3.13. action execution update

Usage:

openstack action execution update [-h]

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

Update specific Action execution.

Expand
Table 3.52. Positional Arguments
ValueSummary

id

Action execution id.

Expand
Table 3.53. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

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

Action execution state

--output OUTPUT

Action execution output

Expand
Table 3.54. Output Formatters
ValueSummary

-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

Expand
Table 3.55. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 3.56. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 3.57. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 4. address

This chapter describes the commands under the address command.

4.1. address scope create

Usage:

openstack address scope create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--ip-version {4,6}]
                                    [--project <project>]
                                    [--project-domain <project-domain>]
                                    [--share | --no-share]
                                    <name>

Create a new Address Scope

Expand
Table 4.1. Positional Arguments
ValueSummary

<name>

New address scope name

Expand
Table 4.2. Optional Arguments
ValueSummary

-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)

Expand
Table 4.3. Output Formatters
ValueSummary

-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

Expand
Table 4.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 4.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 4.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

4.2. address scope delete

Usage:

openstack address scope delete [-h]

                                    <address-scope> [<address-scope> ...]

Delete address scope(s)

Expand
Table 4.7. Positional Arguments
ValueSummary

<address-scope>

Address scope(s) to delete (name or id)

Expand
Table 4.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

4.3. address scope list

Usage:

openstack address scope list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  [--name <name>]
                                  [--ip-version <ip-version>]
                                  [--project <project>]
                                  [--project-domain <project-domain>]
                                  [--share | --no-share]

List address scopes

Expand
Table 4.9. Optional Arguments
ValueSummary

-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

Expand
Table 4.10. Output Formatters
ValueSummary

-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

Expand
Table 4.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 4.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 4.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

4.4. address scope set

Usage:

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

                                 <address-scope>

Set address scope properties

Expand
Table 4.14. Positional Arguments
ValueSummary

<address-scope>

Address scope to modify (name or id)

Expand
Table 4.15. Optional Arguments
ValueSummary

-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

4.5. address scope show

Usage:

openstack address scope show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <address-scope>

Display address scope details

Expand
Table 4.16. Positional Arguments
ValueSummary

<address-scope>

Address scope to display (name or id)

Expand
Table 4.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 4.18. Output Formatters
ValueSummary

-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

Expand
Table 4.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 4.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 4.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 5. aggregate

This chapter describes the commands under the aggregate command.

5.1. aggregate add host

Usage:

openstack aggregate add host [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <aggregate> <host>

Add host to aggregate

Expand
Table 5.1. Positional Arguments
ValueSummary

<aggregate>

Aggregate (name or id)

<host>

Host to add to <aggregate>

Expand
Table 5.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 5.3. Output Formatters
ValueSummary

-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

Expand
Table 5.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 5.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 5.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

5.2. aggregate create

Usage:

openstack aggregate create [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                [--zone <availability-zone>]
                                [--property <key=value>]
                                <name>

Create a new aggregate

Expand
Table 5.7. Positional Arguments
ValueSummary

<name>

New aggregate name

Expand
Table 5.8. Optional Arguments
ValueSummary

-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)

Expand
Table 5.9. Output Formatters
ValueSummary

-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

Expand
Table 5.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 5.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 5.12. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

5.3. aggregate delete

Usage:

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

Delete existing aggregate(s)

Expand
Table 5.13. Positional Arguments
ValueSummary

<aggregate>

Aggregate(s) to delete (name or id)

Expand
Table 5.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

5.4. aggregate list

Usage:

openstack aggregate list [-h] [-f {csv,json,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--sort-column SORT_COLUMN] [--long]

List all aggregates

Expand
Table 5.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 5.16. Output Formatters
ValueSummary

-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

Expand
Table 5.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 5.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 5.19. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

5.5. aggregate remove host

Usage:

openstack aggregate remove host [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <aggregate> <host>

Remove host from aggregate

Expand
Table 5.20. Positional Arguments
ValueSummary

<aggregate>

Aggregate (name or id)

<host>

Host to remove from <aggregate>

Expand
Table 5.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 5.22. Output Formatters
ValueSummary

-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

Expand
Table 5.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 5.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 5.25. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

5.6. aggregate set

Usage:

openstack aggregate set [-h] [--name <name>]

                             [--zone <availability-zone>]
                             [--property <key=value>] [--no-property]
                             <aggregate>

Set aggregate properties

Expand
Table 5.26. Positional Arguments
ValueSummary

<aggregate>

Aggregate to modify (name or id)

Expand
Table 5.27. Optional Arguments
ValueSummary

-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)

5.7. aggregate show

Usage:

openstack aggregate show [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              <aggregate>

Display aggregate details

Expand
Table 5.28. Positional Arguments
ValueSummary

<aggregate>

Aggregate to display (name or id)

Expand
Table 5.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 5.30. Output Formatters
ValueSummary

-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

Expand
Table 5.31. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 5.32. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 5.33. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

5.8. aggregate unset

Usage:

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

Unset aggregate properties

Expand
Table 5.34. Positional Arguments
ValueSummary

<aggregate>

Aggregate to modify (name or id)

Expand
Table 5.35. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from aggregate (repeat option to remove multiple properties)

Chapter 6. alarm

This chapter describes the commands under the alarm command.

6.1. alarm create

Usage:

openstack alarm create [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] --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>]

Create an alarm

Expand
Table 6.1. Optional Arguments
ValueSummary

-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

Expand
Table 6.2. Output Formatters
ValueSummary

-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

Expand
Table 6.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 6.6. common alarm rules
ValueSummary

--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.

Expand
Table 6.7. event alarm
ValueSummary

--event-type <EVENT_TYPE>

Event type to evaluate against

Expand
Table 6.8. common gnocchi alarm rules
ValueSummary

--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

Expand
Table 6.9. gnocchi resource threshold alarm
ValueSummary

--resource-type <RESOURCE_TYPE>

The type of resource.

--resource-id <RESOURCE_ID>

The id of a resource.

Expand
Table 6.10. composite alarm
ValueSummary

--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]}]}.

This command is provided by the aodhclient plugin.

6.2. alarm delete

Usage:

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

Delete an alarm

Expand
Table 6.11. Positional Arguments
ValueSummary

<ALARM ID or NAME>

Id or name of an alarm.

Expand
Table 6.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <NAME>

Name of the alarm

This command is provided by the aodhclient plugin.

6.3. alarm list

Usage:

openstack alarm list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                          [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}]
                          [--sort-column SORT_COLUMN]
                          [--query QUERY | --filter <KEY1=VALUE1;KEY2=VALUE2...>]
                          [--limit <LIMIT>] [--marker <MARKER>]
                          [--sort <SORT_KEY:SORT_DIR>]

List alarms

Expand
Table 6.13. Optional Arguments
ValueSummary

-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

Expand
Table 6.14. Output Formatters
ValueSummary

-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

Expand
Table 6.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.17. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the aodhclient plugin.

6.4. alarm show

Usage:

openstack alarm show [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          [--name <NAME>]
                          [<ALARM ID or NAME>]

Show an alarm

Expand
Table 6.18. Positional Arguments
ValueSummary

<ALARM ID or NAME>

Id or name of an alarm.

Expand
Table 6.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <NAME>

Name of the alarm

Expand
Table 6.20. Output Formatters
ValueSummary

-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

Expand
Table 6.21. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.22. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.23. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the aodhclient plugin.

6.5. alarm state get

Usage:

openstack alarm state get [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] [--name <NAME>]
                               [<ALARM ID or NAME>]

Get state of an alarm

Expand
Table 6.24. Positional Arguments
ValueSummary

<ALARM ID or NAME>

Id or name of an alarm.

Expand
Table 6.25. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <NAME>

Name of the alarm

Expand
Table 6.26. Output Formatters
ValueSummary

-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

Expand
Table 6.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.29. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the aodhclient plugin.

6.6. alarm state set

Usage:

openstack alarm state set [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] [--name <NAME>] --state
                               <STATE>
                               [<ALARM ID or NAME>]

Set state of an alarm

Expand
Table 6.30. Positional Arguments
ValueSummary

<ALARM ID or NAME>

Id or name of an alarm.

Expand
Table 6.31. Optional Arguments
ValueSummary

-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']

Expand
Table 6.32. Output Formatters
ValueSummary

-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

Expand
Table 6.33. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.34. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.35. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the aodhclient plugin.

6.7. alarm update

Usage:

openstack alarm update [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--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>]

Update an alarm

Expand
Table 6.36. Positional Arguments
ValueSummary

<ALARM ID or NAME>

Id or name of an alarm.

Expand
Table 6.37. Optional Arguments
ValueSummary

-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

Expand
Table 6.38. Output Formatters
ValueSummary

-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

Expand
Table 6.39. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.40. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.41. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 6.42. common alarm rules
ValueSummary

--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.

Expand
Table 6.43. event alarm
ValueSummary

--event-type <EVENT_TYPE>

Event type to evaluate against

Expand
Table 6.44. common gnocchi alarm rules
ValueSummary

--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

Expand
Table 6.45. gnocchi resource threshold alarm
ValueSummary

--resource-type <RESOURCE_TYPE>

The type of resource.

--resource-id <RESOURCE_ID>

The id of a resource.

Expand
Table 6.46. composite alarm
ValueSummary

--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]}]}.

This command is provided by the aodhclient plugin.

6.9. alarm history show

Usage:

openstack alarm-history show [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  [--limit <LIMIT>] [--marker <MARKER>]
                                  [--sort <SORT_KEY:SORT_DIR>]
                                  alarm_id

Show history for an alarm

Expand
Table 6.52. Positional Arguments
ValueSummary

alarm_id

Id of an alarm

Expand
Table 6.53. Optional Arguments
ValueSummary

-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

Expand
Table 6.54. Output Formatters
ValueSummary

-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

Expand
Table 6.55. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 6.56. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 6.57. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the aodhclient plugin.

Chapter 7. alarming

This chapter describes the commands under the alarming command.

7.1. alarming capabilities list

Usage:

openstack alarming capabilities list [-h]

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

List capabilities of alarming service

Expand
Table 7.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 7.2. Output Formatters
ValueSummary

-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

Expand
Table 7.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 7.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 7.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the aodhclient plugin.

Chapter 8. availability

This chapter describes the commands under the availability command.

8.1. availability zone list

Usage:

openstack availability zone list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--compute] [--network] [--volume]
                                      [--long]

List availability zones and their status

Expand
Table 8.1. Optional Arguments
ValueSummary

-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

Expand
Table 8.2. Output Formatters
ValueSummary

-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

Expand
Table 8.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 8.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 8.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

Chapter 9. baremetal

This chapter describes the commands under the baremetal command.

9.1. baremetal chassis create

Usage:

openstack baremetal chassis create [-h]

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

Create a new chassis.

Expand
Table 9.1. Optional Arguments
ValueSummary

-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

Expand
Table 9.2. Output Formatters
ValueSummary

-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

Expand
Table 9.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.2. baremetal chassis delete

Usage:

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

Delete a chassis.

Expand
Table 9.6. Positional Arguments
ValueSummary

<chassis>

Uuids of chassis to delete

Expand
Table 9.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.3. baremetal chassis list

Usage:

openstack baremetal chassis list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--fields <field> [<field> ...]]
                                      [--limit <limit>] [--long]
                                      [--marker <chassis>]
                                      [--sort <key>[:<direction>]]

List the chassis.

Expand
Table 9.8. Optional Arguments
ValueSummary

-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.

Expand
Table 9.9. Output Formatters
ValueSummary

-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

Expand
Table 9.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.4. baremetal chassis set

Usage:

openstack baremetal chassis set [-h] [--description <description>]

                                     [--extra <key=value>]
                                     <chassis>

Set chassis properties.

Expand
Table 9.13. Positional Arguments
ValueSummary

<chassis>

Uuid of the chassis

Expand
Table 9.14. Optional Arguments
ValueSummary

-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)

This command is provided by the python-ironicclient plugin.

9.5. baremetal chassis show

Usage:

openstack baremetal chassis show [-h]

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

Show chassis details.

Expand
Table 9.15. Positional Arguments
ValueSummary

<chassis>

Uuid of the chassis

Expand
Table 9.16. Optional Arguments
ValueSummary

-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.

Expand
Table 9.17. Output Formatters
ValueSummary

-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

Expand
Table 9.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.20. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.6. baremetal chassis unset

Usage:

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

                                       <chassis>

Unset chassis properties.

Expand
Table 9.21. Positional Arguments
ValueSummary

<chassis>

Uuid of the chassis

Expand
Table 9.22. Optional Arguments
ValueSummary

-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)

This command is provided by the python-ironicclient plugin.

9.7. baremetal create

Usage:

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

Create resources from files

Expand
Table 9.23. Positional Arguments
ValueSummary

<file>

File (.yaml or .json) containing descriptions of the resources to create. Can be specified multiple times.

Expand
Table 9.24. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.8. baremetal driver list

Usage:

openstack baremetal driver list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     [--type <type>] [--long]

List the enabled drivers.

Expand
Table 9.25. Optional Arguments
ValueSummary

-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.

Expand
Table 9.26. Output Formatters
ValueSummary

-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

Expand
Table 9.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.29. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.9. baremetal driver passthru call

Usage:

openstack baremetal driver passthru call [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--arg <key=value>]
                                              [--http-method <http-method>]
                                              <driver> <method>

Call a vendor passthru method for a driver.

Expand
Table 9.30. Positional Arguments
ValueSummary

<driver>

Name of the driver.

<method>

Vendor passthru method to be called.

Expand
Table 9.31. Optional Arguments
ValueSummary

-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'.

Expand
Table 9.32. Output Formatters
ValueSummary

-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

Expand
Table 9.33. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.34. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.35. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.10. baremetal driver passthru list

Usage:

openstack baremetal driver passthru list [-h]

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

List available vendor passthru methods for a driver.

Expand
Table 9.36. Positional Arguments
ValueSummary

<driver>

Name of the driver.

Expand
Table 9.37. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.38. Output Formatters
ValueSummary

-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

Expand
Table 9.39. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.40. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.41. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.11. baremetal driver property list

Usage:

openstack baremetal driver property list [-h]

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

List the driver properties.

Expand
Table 9.42. Positional Arguments
ValueSummary

<driver>

Name of the driver.

Expand
Table 9.43. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.44. Output Formatters
ValueSummary

-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

Expand
Table 9.45. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.46. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.47. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.12. baremetal driver raid property list

Usage:

openstack baremetal driver raid property list [-h]

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

List a driver’s RAID logical disk properties.

Expand
Table 9.48. Positional Arguments
ValueSummary

<driver>

Name of the driver.

Expand
Table 9.49. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.50. Output Formatters
ValueSummary

-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

Expand
Table 9.51. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.52. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.53. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.13. baremetal driver show

Usage:

openstack baremetal driver show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <driver>

Show information about a driver.

Expand
Table 9.54. Positional Arguments
ValueSummary

<driver>

Name of the driver.

Expand
Table 9.55. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.56. Output Formatters
ValueSummary

-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

Expand
Table 9.57. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.58. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.59. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.14. baremetal introspection abort

Usage:

openstack baremetal introspection abort [-h] node

Abort running introspection for node.

Expand
Table 9.60. Positional Arguments
ValueSummary

node

Baremetal node uuid or name

Expand
Table 9.61. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironic-inspector-client plugin.

9.15. baremetal introspection data save

Usage:

openstack baremetal introspection data save [-h] [--file <filename>]

                                                 node

Save or display raw introspection data.

Expand
Table 9.62. Positional Arguments
ValueSummary

node

Baremetal node uuid or name

Expand
Table 9.63. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <filename>

Downloaded introspection data filename (default: stdout)

This command is provided by the python-ironic-inspector-client plugin.

9.16. baremetal introspection interface list

Usage:

openstack baremetal introspection interface list [-h]

                                                      [-f {csv,json,table,value,yaml}]
                                                      [-c COLUMN]
                                                      [--max-width <integer>]
                                                      [--fit-width]
                                                      [--print-empty]
                                                      [--noindent]
                                                      [--quote {all,minimal,none,nonnumeric}]
                                                      [--sort-column SORT_COLUMN]
                                                      [--vlan VLAN]
                                                      [--long | --fields <field> [<field> ...]]
                                                      node_ident

List interface data including attached switch port information.

Expand
Table 9.64. Positional Arguments
ValueSummary

node_ident

Baremetal node uuid or name

Expand
Table 9.65. Optional Arguments
ValueSummary

-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

Expand
Table 9.66. Output Formatters
ValueSummary

-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

Expand
Table 9.67. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.68. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.69. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironic-inspector-client plugin.

9.17. baremetal introspection interface show

Usage:

openstack baremetal introspection interface show [-h]

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

Show interface data including attached switch port information.

Expand
Table 9.70. Positional Arguments
ValueSummary

node_ident

Baremetal node uuid or name

interface

Interface name

Expand
Table 9.71. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

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

Display one or more fields.

Expand
Table 9.72. Output Formatters
ValueSummary

-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

Expand
Table 9.73. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.74. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.75. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironic-inspector-client plugin.

9.18. baremetal introspection list

Usage:

openstack baremetal introspection list [-h]

                                            [-f {csv,json,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent]
                                            [--quote {all,minimal,none,nonnumeric}]
                                            [--sort-column SORT_COLUMN]
                                            [--marker MARKER]
                                            [--limit LIMIT]

List introspection statuses

Expand
Table 9.76. Optional Arguments
ValueSummary

-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

Expand
Table 9.77. Output Formatters
ValueSummary

-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

Expand
Table 9.78. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.79. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.80. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironic-inspector-client plugin.

9.19. baremetal introspection reprocess

Usage:

openstack baremetal introspection reprocess [-h] node

Reprocess stored introspection data

Expand
Table 9.81. Positional Arguments
ValueSummary

node

Baremetal node uuid or name

Expand
Table 9.82. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironic-inspector-client plugin.

9.20. baremetal introspection rule delete

Usage:

openstack baremetal introspection rule delete [-h] uuid

Delete an introspection rule.

Expand
Table 9.83. Positional Arguments
ValueSummary

uuid

Rule uuid

Expand
Table 9.84. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironic-inspector-client plugin.

9.21. baremetal introspection rule import

Usage:

openstack baremetal introspection rule import [-h]

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

Import one or several introspection rules from a json file.

Expand
Table 9.85. Positional Arguments
ValueSummary

file

Json file to import, may contain one or several rules

Expand
Table 9.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.87. Output Formatters
ValueSummary

-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

Expand
Table 9.88. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.89. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.90. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironic-inspector-client plugin.

9.22. baremetal introspection rule list

Usage:

openstack baremetal introspection rule list [-h]

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

List all introspection rules.

Expand
Table 9.91. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.92. Output Formatters
ValueSummary

-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

Expand
Table 9.93. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.94. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.95. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironic-inspector-client plugin.

9.23. baremetal introspection rule purge

Usage:

openstack baremetal introspection rule purge [-h]

Drop all introspection rules.

Expand
Table 9.96. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironic-inspector-client plugin.

9.24. baremetal introspection rule show

Usage:

openstack baremetal introspection rule show [-h]

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

Show an introspection rule.

Expand
Table 9.97. Positional Arguments
ValueSummary

uuid

Rule uuid

Expand
Table 9.98. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.99. Output Formatters
ValueSummary

-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

Expand
Table 9.100. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.101. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.102. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironic-inspector-client plugin.

9.25. baremetal introspection start

Usage:

openstack baremetal introspection start [-h]

                                             [-f {csv,json,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent]
                                             [--quote {all,minimal,none,nonnumeric}]
                                             [--sort-column SORT_COLUMN]
                                             [--wait]
                                             node [node ...]

Start the introspection.

Expand
Table 9.103. Positional Arguments
ValueSummary

node

Baremetal node uuid(s) or name(s)

Expand
Table 9.104. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for introspection to finish; the result will be displayed in the end

Expand
Table 9.105. Output Formatters
ValueSummary

-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

Expand
Table 9.106. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.107. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.108. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironic-inspector-client plugin.

9.26. baremetal introspection status

Usage:

openstack baremetal introspection status [-h]

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

Get introspection status.

Expand
Table 9.109. Positional Arguments
ValueSummary

node

Baremetal node uuid or name

Expand
Table 9.110. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.111. Output Formatters
ValueSummary

-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

Expand
Table 9.112. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.113. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.114. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironic-inspector-client plugin.

9.27. baremetal node abort

Usage:

openstack baremetal node abort [-h] <node>

Set provision state of baremetal node to 'abort'

Expand
Table 9.115. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.116. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.28. baremetal node add trait

Usage:

openstack baremetal node add trait [-h] <node> <trait> [<trait> ...]

Add traits to a node.

Expand
Table 9.117. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<trait>

Trait(s) to add

Expand
Table 9.118. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.29. baremetal node adopt

Usage:

openstack baremetal node adopt [-h] [--wait [<time-out>]] <node>

Set provision state of baremetal node to 'adopt'

Expand
Table 9.119. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.120. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

9.30. baremetal node bios setting list

Usage:

openstack baremetal node bios setting list [-h]

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

List a node’s BIOS settings.

Expand
Table 9.121. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 9.122. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.123. Output Formatters
ValueSummary

-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

Expand
Table 9.124. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.125. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.126. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.31. baremetal node bios setting show

Usage:

openstack baremetal node bios setting show [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                <node> <setting name>

Show a specific BIOS setting for a node.

Expand
Table 9.127. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<setting name>

Setting name to show

Expand
Table 9.128. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.129. Output Formatters
ValueSummary

-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

Expand
Table 9.130. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.131. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.132. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.32. baremetal node boot device set

Usage:

openstack baremetal node boot device set [-h] [--persistent]

                                              <node> <device>

Set the boot device for a node

Expand
Table 9.133. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<device>

One of bios, cdrom, disk, pxe, safe, wanboot

Expand
Table 9.134. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--persistent

Make changes persistent for all future boots

This command is provided by the python-ironicclient plugin.

9.33. baremetal node boot device show

Usage:

openstack baremetal node boot device show [-h]

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

Show the boot device information for a node

Expand
Table 9.135. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 9.136. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--supported

Show the supported boot devices

Expand
Table 9.137. Output Formatters
ValueSummary

-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

Expand
Table 9.138. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.139. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.140. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.34. baremetal node clean

Usage:

openstack baremetal node clean [-h] [--wait [<time-out>]] --clean-steps

                                    <clean-steps>
                                    <node>

Set provision state of baremetal node to 'clean'

Expand
Table 9.141. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.142. Optional Arguments
ValueSummary

-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'.

This command is provided by the python-ironicclient plugin.

9.35. baremetal node console disable

Usage:

openstack baremetal node console disable [-h] <node>

Disable console access for a node

Expand
Table 9.143. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 9.144. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.36. baremetal node console enable

Usage:

openstack baremetal node console enable [-h] <node>

Enable console access for a node

Expand
Table 9.145. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 9.146. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.37. baremetal node console show

Usage:

openstack baremetal node console show [-h]

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

Show console information for a node

Expand
Table 9.147. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 9.148. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.149. Output Formatters
ValueSummary

-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

Expand
Table 9.150. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.151. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.152. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.38. baremetal node create

Usage:

openstack baremetal node create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--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>]

Register a new node with the baremetal service

Expand
Table 9.153. Optional Arguments
ValueSummary

-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

Expand
Table 9.154. Output Formatters
ValueSummary

-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

Expand
Table 9.155. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.156. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.157. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

9.39. baremetal node delete

Usage:

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

Unregister baremetal node(s)

Expand
Table 9.158. Positional Arguments
ValueSummary

<node>

Node(s) to delete (name or uuid)

Expand
Table 9.159. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.40. baremetal node deploy

Usage:

openstack baremetal node deploy [-h] [--wait [<time-out>]]

                                     [--config-drive <config-drive>]
                                     <node>

Set provision state of baremetal node to 'deploy'

Expand
Table 9.160. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.161. Optional Arguments
ValueSummary

-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. In case it’s a directory, a config drive will be generated from it.

This command is provided by the python-ironicclient plugin.

9.41. baremetal node inject nmi

Usage:

openstack baremetal node inject nmi [-h] <node>

Inject NMI to baremetal node

Expand
Table 9.162. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.163. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.42. baremetal node inspect

Usage:

openstack baremetal node inspect [-h] [--wait [<time-out>]] <node>

Set provision state of baremetal node to 'inspect'

Expand
Table 9.164. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.165. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

9.43. baremetal node list

Usage:

openstack baremetal node list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--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>]
                                   [--chassis <chassis UUID>]
                                   [--long | --fields <field> [<field> ...]]

List baremetal nodes

Expand
Table 9.166. Optional Arguments
ValueSummary

-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>

--chassis <chassis UUID>

Limit list to nodes of this chassis

--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.

Expand
Table 9.167. Output Formatters
ValueSummary

-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

Expand
Table 9.168. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.169. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.170. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.44. baremetal node maintenance set

Usage:

openstack baremetal node maintenance set [-h] [--reason <reason>]

                                              <node>

Set baremetal node to maintenance mode

Expand
Table 9.171. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.172. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--reason <reason>

Reason for setting maintenance mode.

This command is provided by the python-ironicclient plugin.

9.45. baremetal node maintenance unset

Usage:

openstack baremetal node maintenance unset [-h] <node>

Unset baremetal node from maintenance mode

Expand
Table 9.173. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.174. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

9.46. baremetal node manage

Usage:

openstack baremetal node manage [-h] [--wait [<time-out>]] <node>

Set provision state of baremetal node to 'manage'

Expand
Table 9.175. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.176. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

9.47. baremetal node passthru call

Usage:

openstack baremetal node passthru call [-h] [--arg <key=value>]

                                            [--http-method <http-method>]
                                            <node> <method>

Call a vendor passthu method for a node

Expand
Table 9.177. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<method>

Vendor passthru method to be executed

Expand
Table 9.178. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

9.48. baremetal node passthru list

Usage:

openstack baremetal node passthru list [-h]

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

List vendor passthru methods for a node

Expand
Table 9.179. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 9.180. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 9.181. Output Formatters
ValueSummary

-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

Expand
Table 9.182. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 9.183. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 9.184. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

9.49. baremetal node power off

Usage:

openstack baremetal node power off [-h]

                                        [--power-timeout <power-timeout>]
                                        [--soft]
                                        <node>

Power off a node

Expand
Table 9.185. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 9.186. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

Chapter 10. bgp

This chapter describes the commands under the bgp command.

10.1. bgp peer create

Usage:

openstack bgp peer create [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] --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>

Create a BGP peer

Expand
Table 10.1. Positional Arguments
ValueSummary

<name>

Name of the bgp peer to create

Expand
Table 10.2. Optional Arguments
ValueSummary

-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.

Expand
Table 10.3. Output Formatters
ValueSummary

-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

Expand
Table 10.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 10.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 10.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

Chapter 11. baremetal

This chapter describes the commands under the baremetal command.

11.1. baremetal node power on

Usage:

openstack baremetal node power on [-h]

                                       [--power-timeout <power-timeout>]
                                       <node>

Power on a node

Expand
Table 11.1. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.2. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.2. baremetal node provide

Usage:

openstack baremetal node provide [-h] [--wait [<time-out>]] <node>

Set provision state of baremetal node to 'provide'

Expand
Table 11.3. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.4. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.3. baremetal node reboot

Usage:

openstack baremetal node reboot [-h] [--soft]

                                     [--power-timeout <power-timeout>]
                                     <node>

Reboot baremetal node

Expand
Table 11.5. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.6. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.4. baremetal node rebuild

Usage:

openstack baremetal node rebuild [-h] [--wait [<time-out>]]

                                      [--config-drive <config-drive>]
                                      <node>

Set provision state of baremetal node to 'rebuild'

Expand
Table 11.7. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.8. Optional Arguments
ValueSummary

-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. In case it’s a directory, a config drive will be generated from it.

This command is provided by the python-ironicclient plugin.

11.5. baremetal node remove trait

Usage:

openstack baremetal node remove trait [-h] [--all]

                                           <node> [<trait> [<trait> ...]]

Remove trait(s) from a node.

Expand
Table 11.9. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<trait>

Trait(s) to remove

Expand
Table 11.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all

Remove all traits

This command is provided by the python-ironicclient plugin.

11.6. baremetal node rescue

Usage:

openstack baremetal node rescue [-h] [--wait [<time-out>]]

                                     --rescue-password <rescue-password>
                                     <node>

Set provision state of baremetal node to 'rescue'

Expand
Table 11.11. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.12. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.7. baremetal node set

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>]
                                  [--target-raid-config <target_raid_config>]
                                  [--property <key=value>]
                                  [--extra <key=value>]
                                  [--driver-info <key=value>]
                                  [--instance-info <key=value>]
                                  <node>

Set baremetal properties

Expand
Table 11.13. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.14. Optional Arguments
ValueSummary

-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

--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)

This command is provided by the python-ironicclient plugin.

11.8. baremetal node show

Usage:

openstack baremetal node show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--instance]
                                   [--fields <field> [<field> ...]]
                                   <node>

Show baremetal node details

Expand
Table 11.15. Positional Arguments
ValueSummary

<node>

Name or uuid of the node (or instance uuid if

--instance is specified)

 
Expand
Table 11.16. Optional Arguments
ValueSummary

-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.

Expand
Table 11.17. Output Formatters
ValueSummary

-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

Expand
Table 11.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.20. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.9. baremetal node trait list

Usage:

openstack baremetal node trait list [-h]

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

List a node’s traits.

Expand
Table 11.21. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 11.22. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 11.23. Output Formatters
ValueSummary

-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

Expand
Table 11.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.26. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.10. baremetal node undeploy

Usage:

openstack baremetal node undeploy [-h] [--wait [<time-out>]] <node>

Set provision state of baremetal node to 'deleted'

Expand
Table 11.27. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.28. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.11. baremetal node unrescue

Usage:

openstack baremetal node unrescue [-h] [--wait [<time-out>]] <node>

Set provision state of baremetal node to 'unrescue'

Expand
Table 11.29. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.30. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.12. baremetal node unset

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]
                                    <node>

Unset baremetal properties

Expand
Table 11.31. Positional Arguments
ValueSummary

<node>

Name or uuid of the node.

Expand
Table 11.32. Optional Arguments
ValueSummary

-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)

This command is provided by the python-ironicclient plugin.

11.13. baremetal node validate

Usage:

openstack baremetal node validate [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       <node>

Validate a node’s driver interfaces

Expand
Table 11.33. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 11.34. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 11.35. Output Formatters
ValueSummary

-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

Expand
Table 11.36. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.38. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.14. baremetal node vif attach

Usage:

openstack baremetal node vif attach [-h] [--vif-info <key=value>]

                                         <node> <vif-id>

Attach VIF to a given node

Expand
Table 11.39. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<vif-id>

Name or uuid of the vif to attach to a node.

Expand
Table 11.40. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.15. baremetal node vif detach

Usage:

openstack baremetal node vif detach [-h] <node> <vif-id>

Detach VIF from a given node

Expand
Table 11.41. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

<vif-id>

Name or uuid of the vif to detach from a node.

Expand
Table 11.42. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.16. baremetal node vif list

Usage:

openstack baremetal node vif list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       <node>

Show attached VIFs for a node

Expand
Table 11.43. Positional Arguments
ValueSummary

<node>

Name or uuid of the node

Expand
Table 11.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 11.45. Output Formatters
ValueSummary

-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

Expand
Table 11.46. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.48. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.17. baremetal port create

Usage:

openstack baremetal port create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX] --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>]
                                     <address>

Create a new port

Expand
Table 11.49. Positional Arguments
ValueSummary

<address>

Mac address for this port.

Expand
Table 11.50. Optional Arguments
ValueSummary

-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. 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', and 'port_id'. The keys 'switch_id' and 'port_id' are required. 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.

Expand
Table 11.51. Output Formatters
ValueSummary

-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

Expand
Table 11.52. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.53. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.54. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.18. baremetal port delete

Usage:

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

Delete port(s).

Expand
Table 11.55. Positional Arguments
ValueSummary

<port>

Uuid(s) of the port(s) to delete.

Expand
Table 11.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.19. baremetal port group create

Usage:

openstack baremetal port group create [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           --node <uuid>
                                           [--address <mac-address>]
                                           [--name NAME] [--uuid UUID]
                                           [--extra <key=value>]
                                           [--mode MODE]
                                           [--property <key=value>]
                                           [--support-standalone-ports | --unsupport-standalone-ports]

Create a new baremetal port group.

Expand
Table 11.57. Optional Arguments
ValueSummary

-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.

Expand
Table 11.58. Output Formatters
ValueSummary

-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

Expand
Table 11.59. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.60. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.61. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.20. baremetal port group delete

Usage:

openstack baremetal port group delete [-h]

                                           <port group> [<port group> ...]

Unregister baremetal port group(s).

Expand
Table 11.62. Positional Arguments
ValueSummary

<port group>

Port group(s) to delete (name or uuid).

Expand
Table 11.63. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.21. baremetal port group list

Usage:

openstack baremetal port group list [-h]

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

List baremetal port groups.

Expand
Table 11.64. Optional Arguments
ValueSummary

-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.

Expand
Table 11.65. Output Formatters
ValueSummary

-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

Expand
Table 11.66. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.67. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.68. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.22. baremetal port group set

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>

Set baremetal port group properties.

Expand
Table 11.69. Positional Arguments
ValueSummary

<port group>

Name or uuid of the port group.

Expand
Table 11.70. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.23. baremetal port group show

Usage:

openstack baremetal port group show [-h]

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

Show baremetal port group details.

Expand
Table 11.71. Positional Arguments
ValueSummary

<id>

Uuid or name of the port group (or mac address if

--address is specified).

 
Expand
Table 11.72. Optional Arguments
ValueSummary

-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.

Expand
Table 11.73. Output Formatters
ValueSummary

-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

Expand
Table 11.74. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.75. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.76. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.24. baremetal port group unset

Usage:

openstack baremetal port group unset [-h] [--name] [--address]

                                          [--extra <key>] [--property <key>]
                                          <port group>

Unset baremetal port group properties.

Expand
Table 11.77. Positional Arguments
ValueSummary

<port group>

Name or uuid of the port group.

Expand
Table 11.78. Optional Arguments
ValueSummary

-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).

This command is provided by the python-ironicclient plugin.

11.25. baremetal port list

Usage:

openstack baremetal port list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--address <mac-address>] [--node <node>]
                                   [--port-group <port group>]
                                   [--limit <limit>] [--marker <port>]
                                   [--sort <key>[:<direction>]]
                                   [--long | --fields <field> [<field> ...]]

List baremetal ports.

Expand
Table 11.79. Optional Arguments
ValueSummary

-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 Ironic 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.

Expand
Table 11.80. Output Formatters
ValueSummary

-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

Expand
Table 11.81. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.82. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.83. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.26. baremetal port set

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>]
                                  <port>

Set baremetal port properties.

Expand
Table 11.84. Positional Arguments
ValueSummary

<port>

Uuid of the port

Expand
Table 11.85. Optional Arguments
ValueSummary

-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', and 'port_id'. The keys 'switch_id' and 'port_id' are required. 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.

This command is provided by the python-ironicclient plugin.

11.27. baremetal port show

Usage:

openstack baremetal port show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--address]
                                   [--fields <field> [<field> ...]]
                                   <id>

Show baremetal port details.

Expand
Table 11.86. Positional Arguments
ValueSummary

<id>

Uuid of the port (or mac address if --address is specified).

Expand
Table 11.87. Optional Arguments
ValueSummary

-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.

Expand
Table 11.88. Output Formatters
ValueSummary

-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

Expand
Table 11.89. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.90. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.91. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.28. baremetal port unset

Usage:

openstack baremetal port unset [-h] [--extra <key>] [--port-group]

                                    [--physical-network]
                                    <port>

Unset baremetal port properties.

Expand
Table 11.92. Positional Arguments
ValueSummary

<port>

Uuid of the port.

Expand
Table 11.93. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.29. baremetal volume connector create

Usage:

openstack baremetal volume connector create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX] --node
                                                 <uuid> --type <type>
                                                 --connector-id <connector
                                                 id> [--uuid <uuid>]
                                                 [--extra <key=value>]

Create a new baremetal volume connector.

Expand
Table 11.94. Optional Arguments
ValueSummary

-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.

Expand
Table 11.95. Output Formatters
ValueSummary

-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

Expand
Table 11.96. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.97. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.98. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.30. baremetal volume connector delete

Usage:

openstack baremetal volume connector delete [-h]

                                                 <volume connector>
                                                 [<volume connector> ...]

Unregister baremetal volume connector(s).

Expand
Table 11.99. Positional Arguments
ValueSummary

<volume connector>

Uuid(s) of the volume connector(s) to delete.

Expand
Table 11.100. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.31. baremetal volume connector list

Usage:

openstack baremetal volume connector list [-h]

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

List baremetal volume connectors.

Expand
Table 11.101. Optional Arguments
ValueSummary

-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.

Expand
Table 11.102. Output Formatters
ValueSummary

-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

Expand
Table 11.103. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.104. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.105. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.32. baremetal volume connector set

Usage:

openstack baremetal volume connector set [-h] [--node <uuid>]

                                              [--type <type>]
                                              [--connector-id <connector id>]
                                              [--extra <key=value>]
                                              <volume connector>

Set baremetal volume connector properties.

Expand
Table 11.106. Positional Arguments
ValueSummary

<volume connector>

Uuid of the volume connector.

Expand
Table 11.107. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.33. baremetal volume connector show

Usage:

openstack baremetal volume connector show [-h]

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

Show baremetal volume connector details.

Expand
Table 11.108. Positional Arguments
ValueSummary

<id>

Uuid of the volume connector.

Expand
Table 11.109. Optional Arguments
ValueSummary

-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.

Expand
Table 11.110. Output Formatters
ValueSummary

-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

Expand
Table 11.111. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.112. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.113. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.34. baremetal volume connector unset

Usage:

openstack baremetal volume connector unset [-h] [--extra <key>]

                                                <volume connector>

Unset baremetal volume connector properties.

Expand
Table 11.114. Positional Arguments
ValueSummary

<volume connector>

Uuid of the volume connector.

Expand
Table 11.115. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--extra <key>

Extra to unset (repeat option to unset multiple extras)

This command is provided by the python-ironicclient plugin.

11.35. baremetal volume target create

Usage:

openstack baremetal volume target create [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              --node <uuid> --type <volume
                                              type> [--property <key=value>]
                                              --boot-index <boot index>
                                              --volume-id <volume id>
                                              [--uuid <uuid>]
                                              [--extra <key=value>]

Create a new baremetal volume target.

Expand
Table 11.116. Optional Arguments
ValueSummary

-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.

Expand
Table 11.117. Output Formatters
ValueSummary

-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

Expand
Table 11.118. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.119. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.120. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.36. baremetal volume target delete

Usage:

openstack baremetal volume target delete [-h]

                                              <volume target>
                                              [<volume target> ...]

Unregister baremetal volume target(s).

Expand
Table 11.121. Positional Arguments
ValueSummary

<volume target>

Uuid(s) of the volume target(s) to delete.

Expand
Table 11.122. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-ironicclient plugin.

11.37. baremetal volume target list

Usage:

openstack baremetal volume target list [-h]

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

List baremetal volume targets.

Expand
Table 11.123. Optional Arguments
ValueSummary

-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.

Expand
Table 11.124. Output Formatters
ValueSummary

-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

Expand
Table 11.125. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.126. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.127. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-ironicclient plugin.

11.38. baremetal volume target set

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>

Set baremetal volume target properties.

Expand
Table 11.128. Positional Arguments
ValueSummary

<volume target>

Uuid of the volume target.

Expand
Table 11.129. Optional Arguments
ValueSummary

-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.

This command is provided by the python-ironicclient plugin.

11.39. baremetal volume target show

Usage:

openstack baremetal volume target show [-h]

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

Show baremetal volume target details.

Expand
Table 11.130. Positional Arguments
ValueSummary

<id>

Uuid of the volume target.

Expand
Table 11.131. Optional Arguments
ValueSummary

-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.

Expand
Table 11.132. Output Formatters
ValueSummary

-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

Expand
Table 11.133. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 11.134. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 11.135. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-ironicclient plugin.

11.40. baremetal volume target unset

Usage:

openstack baremetal volume target unset [-h] [--extra <key>]

                                             [--property <key>]
                                             <volume target>

Unset baremetal volume target properties.

Expand
Table 11.136. Positional Arguments
ValueSummary

<volume target>

Uuid of the volume target.

Expand
Table 11.137. Optional Arguments
ValueSummary

-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).

This command is provided by the python-ironicclient plugin.

Chapter 12. bgp

This chapter describes the commands under the bgp command.

12.1. bgp dragent add speaker

Usage:

openstack bgp dragent add speaker [-h] <agent-id> <bgp-speaker>

Add a BGP speaker to a dynamic routing agent

Expand
Table 12.1. Positional Arguments
ValueSummary

<agent-id>

Id of the dynamic routing agent

<bgp-speaker>

Id or name of the bgp speaker

Expand
Table 12.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.2. bgp dragent remove speaker

Usage:

openstack bgp dragent remove speaker [-h] <agent-id> <bgp-speaker>

Removes a BGP speaker from a dynamic routing agent

Expand
Table 12.3. Positional Arguments
ValueSummary

<agent-id>

Id of the dynamic routing agent

<bgp-speaker>

Id or name of the bgp speaker

Expand
Table 12.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.3. bgp peer delete

Usage:

openstack bgp peer delete [-h] <bgp-peer>

Delete a BGP peer

Expand
Table 12.5. Positional Arguments
ValueSummary

<bgp-peer>

Bgp peer to delete (name or id)

Expand
Table 12.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.4. bgp peer list

Usage:

openstack bgp peer list [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN]

List BGP peers

Expand
Table 12.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 12.8. Output Formatters
ValueSummary

-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

Expand
Table 12.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.11. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

12.5. bgp peer set

Usage:

openstack bgp peer set [-h] [--name NAME] [--password <auth-password>]

                            <bgp-peer>

Update a BGP peer

Expand
Table 12.12. Positional Arguments
ValueSummary

<bgp-peer>

Bgp peer to update (name or id)

Expand
Table 12.13. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Updated name of the bgp peer

--password <auth-password>

Updated authentication password

This command is provided by the python-neutronclient plugin.

12.6. bgp peer show

Usage:

openstack bgp peer show [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]
                             <bgp-peer>

Show information for a BGP peer

Expand
Table 12.14. Positional Arguments
ValueSummary

<bgp-peer>

Bgp peer to display (name or id)

Expand
Table 12.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 12.16. Output Formatters
ValueSummary

-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

Expand
Table 12.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

12.7. bgp speaker add network

Usage:

openstack bgp speaker add network [-h] <bgp-speaker> <network>

Add a network to a BGP speaker

Expand
Table 12.20. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker (name or id)

<network>

Network to add (name or id)

Expand
Table 12.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.8. bgp speaker add peer

Usage:

openstack bgp speaker add peer [-h] <bgp-speaker> <bgp-peer>

Add a peer to a BGP speaker

Expand
Table 12.22. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker (name or id)

<bgp-peer>

Bgp peer to add (name or id)

Expand
Table 12.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.9. bgp speaker create

Usage:

openstack bgp speaker create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] --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>

Create a BGP speaker

Expand
Table 12.24. Positional Arguments
ValueSummary

<name>

Name of the bgp speaker to create

Expand
Table 12.25. Optional Arguments
ValueSummary

-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.

Expand
Table 12.26. Output Formatters
ValueSummary

-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

Expand
Table 12.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.29. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

12.10. bgp speaker delete

Usage:

openstack bgp speaker delete [-h] <bgp-speaker>

Delete a BGP speaker

Expand
Table 12.30. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker to delete (name or id)

Expand
Table 12.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.11. bgp speaker list

Usage:

openstack bgp speaker list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                [--agent <agent-id>]

List BGP speakers

Expand
Table 12.32. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--agent <agent-id>

List bgp speakers hosted by an agent (id only)

Expand
Table 12.33. Output Formatters
ValueSummary

-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

Expand
Table 12.34. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.35. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.36. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

12.12. bgp speaker list advertised routes

Usage:

openstack bgp speaker list advertised routes [-h]

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

List routes advertised

Expand
Table 12.37. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker (name or id)

Expand
Table 12.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 12.39. Output Formatters
ValueSummary

-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

Expand
Table 12.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.42. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

12.13. bgp speaker remove network

Usage:

openstack bgp speaker remove network [-h] <bgp-speaker> <network>

Remove a network from a BGP speaker

Expand
Table 12.43. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker (name or id)

<network>

Network to remove (name or id)

Expand
Table 12.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.14. bgp speaker remove peer

Usage:

openstack bgp speaker remove peer [-h] <bgp-speaker> <bgp-peer>

Remove a peer from a BGP speaker

Expand
Table 12.45. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker (name or id)

<bgp-peer>

Bgp peer to remove (name or id)

Expand
Table 12.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

12.15. bgp speaker set

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>

Set BGP speaker properties

Expand
Table 12.47. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker to update (name or id)

Expand
Table 12.48. Optional Arguments
ValueSummary

-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.

This command is provided by the python-neutronclient plugin.

12.16. bgp speaker show

Usage:

openstack bgp speaker show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <bgp-speaker>

Show a BGP speaker

Expand
Table 12.49. Positional Arguments
ValueSummary

<bgp-speaker>

Bgp speaker to display (name or id)

Expand
Table 12.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 12.51. Output Formatters
ValueSummary

-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

Expand
Table 12.52. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.53. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.54. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

12.17. bgp speaker show dragents

Usage:

openstack bgp speaker show dragents [-h]

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

List dynamic routing agents hosting a BGP speaker

Expand
Table 12.55. Positional Arguments
ValueSummary

<bgp-speaker>

Id or name of the bgp speaker

Expand
Table 12.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 12.57. Output Formatters
ValueSummary

-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

Expand
Table 12.58. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 12.59. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 12.60. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

Chapter 13. bgpvpn

This chapter describes the commands under the bgpvpn command.

13.1. bgpvpn create

Usage:

openstack bgpvpn create [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--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}]

Create BGP VPN resource

Expand
Table 13.1. Optional Arguments
ValueSummary

-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)

Expand
Table 13.2. Output Formatters
ValueSummary

-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

Expand
Table 13.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.2. bgpvpn delete

Usage:

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

Delete BGP VPN resource(s)

Expand
Table 13.6. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn(s) to delete (name or id)

Expand
Table 13.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

13.3. bgpvpn list

Usage:

openstack bgpvpn list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--project <project>]
                           [--project-domain <project-domain>] [--long]
                           [--property <key=value>]

List BGP VPN resources

Expand
Table 13.8. Optional Arguments
ValueSummary

-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)

Expand
Table 13.9. Output Formatters
ValueSummary

-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

Expand
Table 13.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

13.4. bgpvpn network association create

Usage:

openstack bgpvpn network association create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX]
                                                 [--project <project>]
                                                 [--project-domain <project-domain>]
                                                 <bgpvpn> <network>

Create a BGP VPN network association

Expand
Table 13.13. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn to apply the network association (name or id)

<network>

Network to associate the bgp vpn (name or id)

Expand
Table 13.14. Optional Arguments
ValueSummary

-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.

Expand
Table 13.15. Output Formatters
ValueSummary

-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

Expand
Table 13.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.18. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.5. bgpvpn network association delete

Usage:

openstack bgpvpn network association delete [-h]

                                                 <network association ID>
                                                 [<network association ID> ...]
                                                 <bgpvpn>

Delete a BGP VPN network association(s) for a given BGP VPN

Expand
Table 13.19. Positional Arguments
ValueSummary

<network association ID>

Network association ID(s) to remove

<bgpvpn>

Bgp vpn the network association belongs to (name or ID)

Expand
Table 13.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

13.6. bgpvpn network association list

Usage:

openstack bgpvpn network association list [-h]

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

List BGP VPN network associations for a given BGP VPN

Expand
Table 13.21. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn listed associations belong to (name or id)

Expand
Table 13.22. Optional Arguments
ValueSummary

-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)

Expand
Table 13.23. Output Formatters
ValueSummary

-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

Expand
Table 13.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.26. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

13.7. bgpvpn network association show

Usage:

openstack bgpvpn network association show [-h]

                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--prefix PREFIX]
                                               <network association ID>
                                               <bgpvpn>

Show information of a given BGP VPN network association

Expand
Table 13.27. Positional Arguments
ValueSummary

<network association ID>

Network association ID to look up

<bgpvpn>

Bgp vpn the association belongs to (name or id)

Expand
Table 13.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 13.29. Output Formatters
ValueSummary

-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

Expand
Table 13.30. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.31. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.32. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.8. bgpvpn port association create

Usage:

openstack bgpvpn port association create [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--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>

Create a BGP VPN port association

Expand
Table 13.33. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn to apply the port association (name or id)

<port>

Port to associate the bgp vpn (name or id)

Expand
Table 13.34. Optional Arguments
ValueSummary

-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)

Expand
Table 13.35. Output Formatters
ValueSummary

-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

Expand
Table 13.36. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.38. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.9. bgpvpn port association delete

Usage:

openstack bgpvpn port association delete [-h]

                                              <port association ID>
                                              [<port association ID> ...]
                                              <bgpvpn>

Delete a BGP VPN port association(s) for a given BGP VPN

Expand
Table 13.39. Positional Arguments
ValueSummary

<port association ID>

Port association ID(s) to remove

<bgpvpn>

Bgp vpn the port association belongs to (name or id)

Expand
Table 13.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

13.10. bgpvpn port association list

Usage:

openstack bgpvpn port association list [-h]

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

List BGP VPN port associations for a given BGP VPN

Expand
Table 13.41. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn listed associations belong to (name or id)

Expand
Table 13.42. Optional Arguments
ValueSummary

-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)

Expand
Table 13.43. Output Formatters
ValueSummary

-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

Expand
Table 13.44. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.45. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.46. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

13.11. bgpvpn port association set

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>

Set BGP VPN port association properties

Expand
Table 13.47. Positional Arguments
ValueSummary

<port association ID>

Port association ID to update

<bgpvpn>

Bgp vpn the port association belongs to (name or id)

Expand
Table 13.48. Optional Arguments
ValueSummary

-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

This command is provided by the python-neutronclient plugin.

13.12. bgpvpn port association show

Usage:

openstack bgpvpn port association show [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            <port association ID> <bgpvpn>

Show information of a given BGP VPN port association

Expand
Table 13.49. Positional Arguments
ValueSummary

<port association ID>

Port association ID to look up

<bgpvpn>

Bgp vpn the association belongs to (name or id)

Expand
Table 13.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 13.51. Output Formatters
ValueSummary

-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

Expand
Table 13.52. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.53. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.54. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.13. bgpvpn port association unset

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>

Unset BGP VPN port association properties

Expand
Table 13.55. Positional Arguments
ValueSummary

<port association ID>

Port association ID to update

<bgpvpn>

Bgp vpn the port association belongs to (name or id)

Expand
Table 13.56. Optional Arguments
ValueSummary

-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

This command is provided by the python-neutronclient plugin.

13.14. bgpvpn router association create

Usage:

openstack bgpvpn router association create [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                [--project <project>]
                                                [--project-domain <project-domain>]
                                                <bgpvpn> <router>

Create a BGP VPN router association

Expand
Table 13.57. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn to apply the router association (name or id)

<router>

Router to associate the bgp vpn (name or id)

Expand
Table 13.58. Optional Arguments
ValueSummary

-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.

Expand
Table 13.59. Output Formatters
ValueSummary

-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

Expand
Table 13.60. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.61. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.62. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.15. bgpvpn router association delete

Usage:

openstack bgpvpn router association delete [-h]

                                                <router association ID>
                                                [<router association ID> ...]
                                                <bgpvpn>

Delete a BGP VPN router association(s) for a given BGP VPN

Expand
Table 13.63. Positional Arguments
ValueSummary

<router association ID>

Router association ID(s) to remove

<bgpvpn>

Bgp vpn the router association belongs to (name or id)

Expand
Table 13.64. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

13.16. bgpvpn router association list

Usage:

openstack bgpvpn router association list [-h]

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

List BGP VPN router associations for a given BGP VPN

Expand
Table 13.65. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn listed associations belong to (name or id)

Expand
Table 13.66. Optional Arguments
ValueSummary

-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)

Expand
Table 13.67. Output Formatters
ValueSummary

-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

Expand
Table 13.68. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.69. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.70. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

13.17. bgpvpn router association show

Usage:

openstack bgpvpn router association show [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              <router association ID>
                                              <bgpvpn>

Show information of a given BGP VPN router association

Expand
Table 13.71. Positional Arguments
ValueSummary

<router association ID>

Router association ID to look up

<bgpvpn>

Bgp vpn the association belongs to (name or id)

Expand
Table 13.72. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 13.73. Output Formatters
ValueSummary

-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

Expand
Table 13.74. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.75. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.76. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.18. bgpvpn set

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>

Set BGP VPN properties

Expand
Table 13.77. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn to update (name or id)

Expand
Table 13.78. Optional Arguments
ValueSummary

-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.

This command is provided by the python-neutronclient plugin.

13.19. bgpvpn show

Usage:

openstack bgpvpn show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           <bgpvpn>

Show information of a given BGP VPN

Expand
Table 13.79. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn to display (name or id)

Expand
Table 13.80. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 13.81. Output Formatters
ValueSummary

-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

Expand
Table 13.82. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 13.83. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 13.84. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

13.20. bgpvpn unset

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>

Unset BGP VPN properties

Expand
Table 13.85. Positional Arguments
ValueSummary

<bgpvpn>

Bgp vpn to update (name or id)

Expand
Table 13.86. Optional Arguments
ValueSummary

-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.

This command is provided by the python-neutronclient plugin.

Chapter 14. ca

This chapter describes the commands under the ca command.

14.1. ca get

Usage:

openstack ca get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                      [--max-width <integer>] [--fit-width] [--print-empty]
                      [--noindent] [--prefix PREFIX]
                      URI

Retrieve a CA by providing its URI.

Expand
Table 14.1. Positional Arguments
ValueSummary

URI

The uri reference for the ca.

Expand
Table 14.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 14.3. Output Formatters
ValueSummary

-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

Expand
Table 14.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 14.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 14.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

14.2. ca list

Usage:

openstack ca list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                       [--max-width <integer>] [--fit-width] [--print-empty]
                       [--noindent] [--quote {all,minimal,none,nonnumeric}]
                       [--sort-column SORT_COLUMN] [--limit LIMIT]
                       [--offset OFFSET] [--name NAME]

List CAs.

Expand
Table 14.7. Optional Arguments
ValueSummary

-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)

Expand
Table 14.8. Output Formatters
ValueSummary

-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

Expand
Table 14.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 14.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 14.11. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

Chapter 15. catalog

This chapter describes the commands under the catalog command.

15.1. catalog list

Usage:

openstack catalog list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN]

List services in the service catalog

Expand
Table 15.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 15.2. Output Formatters
ValueSummary

-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

Expand
Table 15.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 15.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 15.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

15.2. catalog show

Usage:

openstack catalog show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX]
                            <service>

Display service catalog details

Expand
Table 15.6. Positional Arguments
ValueSummary

<service>

Service to display (type or name)

Expand
Table 15.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 15.8. Output Formatters
ValueSummary

-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

Expand
Table 15.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 15.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 15.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 16. coe

This chapter describes the commands under the coe command.

16.1. coe ca rotate

Usage:

openstack coe ca rotate [-h] <cluster>

Rotate the CA certificate for cluster to revoke access.

Expand
Table 16.1. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

Expand
Table 16.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.2. coe ca show

Usage:

openstack coe ca show [-h] <cluster>

Show details about the CA certificate for a cluster.

Expand
Table 16.3. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

Expand
Table 16.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.3. coe ca sign

Usage:

openstack coe ca sign [-h] <cluster> <csr>

Generate the CA certificate for a cluster.

Expand
Table 16.5. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

<csr>

File path of csr file to send to magnum to get signed.

Expand
Table 16.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.4. coe cluster config

Usage:

openstack coe cluster config [-h] [--dir <dir>] [--force] <cluster>

Get Configuration for a Cluster

Expand
Table 16.7. Positional Arguments
ValueSummary

<cluster>

The name or uuid of cluster to update

Expand
Table 16.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--dir <dir>

Directory to save the certificate and config files.

--force

Overwrite files if existing.

This command is provided by the python-magnumclient plugin.

16.5. coe cluster create

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>

Create a cluster

Expand
Table 16.9. Positional Arguments
ValueSummary

<name>

Name of the cluster to create.

Expand
Table 16.10. Optional Arguments
ValueSummary

-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.

This command is provided by the python-magnumclient plugin.

16.6. coe cluster delete

Usage:

openstack coe cluster delete [-h] <cluster> [<cluster> ...]

Delete a cluster

Expand
Table 16.11. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster(s) to delete.

Expand
Table 16.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.7. coe cluster list

Usage:

openstack coe cluster list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                [--limit <limit>] [--sort-key <sort-key>]
                                [--sort-dir <sort-dir>]

List clusters

Expand
Table 16.13. Optional Arguments
ValueSummary

-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".

Expand
Table 16.14. Output Formatters
ValueSummary

-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

Expand
Table 16.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.17. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-magnumclient plugin.

16.8. coe cluster show

Usage:

openstack coe cluster show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <cluster>

Show a Cluster

Expand
Table 16.18. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster to show.

Expand
Table 16.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.20. Output Formatters
ValueSummary

-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

Expand
Table 16.21. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.22. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.23. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.9. coe cluster template create

Usage:

openstack coe cluster template create [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           --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>

Create a Cluster Template.

Expand
Table 16.24. Positional Arguments
ValueSummary

<name>

Name of the cluster template to create.

Expand
Table 16.25. Optional Arguments
ValueSummary

-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

Expand
Table 16.26. Output Formatters
ValueSummary

-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

Expand
Table 16.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.29. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.10. coe cluster template delete

Usage:

openstack coe cluster template delete [-h]

                                           <cluster-templates>
                                           [<cluster-templates> ...]

Delete a Cluster Template.

Expand
Table 16.30. Positional Arguments
ValueSummary

<cluster-templates>

Id or name of the (cluster template)s to delete.

Expand
Table 16.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

16.11. coe cluster template list

Usage:

openstack coe cluster template list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--limit <limit>]
                                         [--sort-key <sort-key>]
                                         [--sort-dir <sort-dir>]
                                         [--fields <fields>]

List Cluster Templates.

Expand
Table 16.32. Optional Arguments
ValueSummary

-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

Expand
Table 16.33. Output Formatters
ValueSummary

-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

Expand
Table 16.34. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.35. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.36. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-magnumclient plugin.

16.12. coe cluster template show

Usage:

openstack coe cluster template show [-h]

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

Show a Cluster Template.

Expand
Table 16.37. Positional Arguments
ValueSummary

<cluster-template>

Id or name of the cluster template to show.

Expand
Table 16.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.39. Output Formatters
ValueSummary

-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

Expand
Table 16.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.13. coe cluster template update

Usage:

openstack coe cluster template update [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           <cluster-template> <op>
                                           <path=value> [<path=value> ...]

Update a Cluster Template.

Expand
Table 16.43. Positional Arguments
ValueSummary

<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)

Expand
Table 16.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.45. Output Formatters
ValueSummary

-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

Expand
Table 16.46. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.48. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-magnumclient plugin.

16.14. coe cluster update

Usage:

openstack coe cluster update [-h] [--rollback]

                                  <cluster> <op> <path=value>
                                  [<path=value> ...]

Update a Cluster

Expand
Table 16.49. Positional Arguments
ValueSummary

<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)

Expand
Table 16.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--rollback

Rollback cluster on update failure.

This command is provided by the python-magnumclient plugin.

16.15. coe quotas create

Usage:

openstack coe quotas create [-h] --project-id <project-id> --resource

                                 <resource> [--hard-limit <hard-limit>]

Create a quota.

Expand
Table 16.51. Optional Arguments
ValueSummary

-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)

This command is provided by the python-magnumclient plugin.

16.16. coe quotas delete

Usage:

openstack coe quotas delete [-h] --project-id <project-id> --resource

                                 <resource>

Delete specified resource quota.

Expand
Table 16.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project-id <project-id>

Project ID

--resource <resource>

Resource name.

This command is provided by the python-magnumclient plugin.

16.17. coe quotas list

Usage:

openstack coe quotas list [-h] [--marker <marker>] [--limit <limit>]

                               [--sort-key <sort-key>]
                               [--sort-dir <sort-dir>] [--all-tenants]

Print a list of available quotas.

Expand
Table 16.53. Optional Arguments
ValueSummary

-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.

This command is provided by the python-magnumclient plugin.

16.18. coe quotas show

Usage:

openstack coe quotas show [-h] --project-id <project-id> --resource

                               <resource>

Show details about the given project resource quota.

Expand
Table 16.54. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project-id <project-id>

Project ID

--resource <resource>

Resource name.

This command is provided by the python-magnumclient plugin.

16.19. coe quotas update

Usage:

openstack coe quotas update [-h] --project-id <project-id> --resource

                                 <resource> [--hard-limit <hard-limit>]

Update information about the given project resource quota.

Expand
Table 16.55. Optional Arguments
ValueSummary

-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)

This command is provided by the python-magnumclient plugin.

16.20. coe service list

Usage:

openstack coe service list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]

Print a list of Magnum services.

Expand
Table 16.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 16.57. Output Formatters
ValueSummary

-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

Expand
Table 16.58. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 16.59. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 16.60. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-magnumclient plugin.

16.21. coe stats list

Usage:

openstack coe stats list [-h] <project>

Show stats for the given project_id

Expand
Table 16.61. Positional Arguments
ValueSummary

<project>

Project id

Expand
Table 16.62. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-magnumclient plugin.

Chapter 17. command

This chapter describes the commands under the command command.

17.1. command list

Usage:

openstack command list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN]
                            [--group <group-keyword>]

List recognized commands by group

Expand
Table 17.1. Optional Arguments
ValueSummary

-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

Expand
Table 17.2. Output Formatters
ValueSummary

-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

Expand
Table 17.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 17.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 17.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

Chapter 18. complete.adoc

This chapter describes the commands under the complete.adoc command.

18.1. complete

Usage:

openstack complete [-h] [--name <command_name>] [--shell <shell>]

print bash completion command

Expand
Table 18.1. Optional Arguments
ValueSummary

-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)

This command is provided by the cliff plugin.

Chapter 19. compute

This chapter describes the commands under the compute command.

19.1. compute agent create

Usage:

openstack compute agent create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <os> <architecture> <version> <url>
                                    <md5hash> <hypervisor>

Create compute agent

Expand
Table 19.1. Positional Arguments
ValueSummary

<os>

Type of os

<architecture>

Type of architecture

<version>

Version

<url>

Url

<md5hash>

Md5 hash

<hypervisor>

Type of hypervisor

Expand
Table 19.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 19.3. Output Formatters
ValueSummary

-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

Expand
Table 19.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 19.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 19.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

19.2. compute agent delete

Usage:

openstack compute agent delete [-h] <id> [<id> ...]

Delete compute agent(s)

Expand
Table 19.7. Positional Arguments
ValueSummary

<id>

Id of agent(s) to delete

Expand
Table 19.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

19.3. compute agent list

Usage:

openstack compute agent list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  [--hypervisor <hypervisor>]

List compute agents

Expand
Table 19.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--hypervisor <hypervisor>

Type of hypervisor

Expand
Table 19.10. Output Formatters
ValueSummary

-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

Expand
Table 19.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 19.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 19.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

19.4. compute agent set

Usage:

openstack compute agent set [-h] [--agent-version <version>]

                                 [--url <url>] [--md5hash <md5hash>]
                                 <id>

Set compute agent properties

Expand
Table 19.14. Positional Arguments
ValueSummary

<id>

Id of the agent

Expand
Table 19.15. Optional Arguments
ValueSummary

-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

Usage:

openstack compute service delete [-h] <service> [<service> ...]

Delete compute service(s)

Expand
Table 19.16. Positional Arguments
ValueSummary

<service>

Compute service(s) to delete (id only)

Expand
Table 19.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

19.6. compute service list

Usage:

openstack compute service list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--host <host>] [--service <service>]
                                    [--long]

List compute services

Expand
Table 19.18. Optional Arguments
ValueSummary

-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

Expand
Table 19.19. Output Formatters
ValueSummary

-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

Expand
Table 19.20. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 19.21. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 19.22. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

19.7. compute service set

Usage:

openstack compute service set [-h] [--enable | --disable]

                                   [--disable-reason <reason>]
                                   [--up | --down]
                                   <host> <service>

Set compute service properties

Expand
Table 19.23. Positional Arguments
ValueSummary

<host>

Name of host

<service>

Name of service (binary name)

Expand
Table 19.24. Optional Arguments
ValueSummary

-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

Usage:

openstack configuration show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] [--mask | --unmask]

Display configuration details

Expand
Table 20.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--mask

Attempt to mask passwords (default)

--unmask

Show password in clear text

Expand
Table 20.2. Output Formatters
ValueSummary

-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

Expand
Table 20.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 20.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 21. consistency

This chapter describes the commands under the consistency command.

21.1. consistency group add volume

Usage:

openstack consistency group add volume [-h]

                                            <consistency-group> <volume>
                                            [<volume> ...]

Add volume(s) to consistency group

Expand
Table 21.1. Positional Arguments
ValueSummary

<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)

Expand
Table 21.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

21.2. consistency group create

Usage:

openstack consistency group create [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        (--volume-type <volume-type> | --consistency-group-source <consistency-group> | --consistency-group-snapshot <consistency-group-snapshot>)
                                        [--description <description>]
                                        [--availability-zone <availability-zone>]
                                        [<name>]

Create new consistency group.

Expand
Table 21.3. Positional Arguments
ValueSummary

<name>

Name of new consistency group (default to none)

Expand
Table 21.4. Optional Arguments
ValueSummary

-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)

Expand
Table 21.5. Output Formatters
ValueSummary

-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

Expand
Table 21.6. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 21.7. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 21.8. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

21.3. consistency group delete

Usage:

openstack consistency group delete [-h] [--force]

                                        <consistency-group>
                                        [<consistency-group> ...]

Delete consistency group(s).

Expand
Table 21.9. Positional Arguments
ValueSummary

<consistency-group>

Consistency group(s) to delete (name or id)

Expand
Table 21.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Allow delete in state other than error or available

21.4. consistency group list

Usage:

openstack consistency group list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--all-projects] [--long]

List consistency groups.

Expand
Table 21.11. Optional Arguments
ValueSummary

-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

Expand
Table 21.12. Output Formatters
ValueSummary

-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

Expand
Table 21.13. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 21.14. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 21.15. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

21.5. consistency group remove volume

Usage:

openstack consistency group remove volume [-h]

                                               <consistency-group> <volume>
                                               [<volume> ...]

Remove volume(s) from consistency group

Expand
Table 21.16. Positional Arguments
ValueSummary

<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)

Expand
Table 21.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

21.6. consistency group set

Usage:

openstack consistency group set [-h] [--name <name>]

                                     [--description <description>]
                                     <consistency-group>

Set consistency group properties

Expand
Table 21.18. Positional Arguments
ValueSummary

<consistency-group>

Consistency group to modify (name or id)

Expand
Table 21.19. Optional Arguments
ValueSummary

-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

Usage:

openstack consistency group show [-h]

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

Display consistency group details.

Expand
Table 21.20. Positional Arguments
ValueSummary

<consistency-group>

Consistency group to display (name or id)

Expand
Table 21.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 21.22. Output Formatters
ValueSummary

-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

Expand
Table 21.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 21.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 21.25. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

21.8. consistency group snapshot create

Usage:

openstack consistency group snapshot create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX]
                                                 [--consistency-group <consistency-group>]
                                                 [--description <description>]
                                                 [<snapshot-name>]

Create new consistency group snapshot.

Expand
Table 21.26. Positional Arguments
ValueSummary

<snapshot-name>

Name of new consistency group snapshot (default to None)

Expand
Table 21.27. Optional Arguments
ValueSummary

-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

Expand
Table 21.28. Output Formatters
ValueSummary

-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

Expand
Table 21.29. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 21.30. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 21.31. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

21.9. consistency group snapshot delete

Usage:

openstack consistency group snapshot delete [-h]


                                                 <consistency-group-snapshot>
                                                 [<consistency-group-snapshot> ...]

Delete consistency group snapshot(s).

Expand
Table 21.32. Positional Arguments
ValueSummary

<consistency-group-snapshot>

Consistency group snapshot(s) to delete (name or ID)

Expand
Table 21.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

21.10. consistency group snapshot list

Usage:

openstack consistency group snapshot list [-h]

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

List consistency group snapshots.

Expand
Table 21.34. Optional Arguments
ValueSummary

-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)

Expand
Table 21.35. Output Formatters
ValueSummary

-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

Expand
Table 21.36. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 21.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 21.38. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

21.11. consistency group snapshot show

Usage:

openstack consistency group snapshot show [-h]

                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--prefix PREFIX]
                                               <consistency-group-snapshot>

Display consistency group snapshot details

Expand
Table 21.39. Positional Arguments
ValueSummary

<consistency-group-snapshot>

Consistency group snapshot to display (name or ID)

Expand
Table 21.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 21.41. Output Formatters
ValueSummary

-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

Expand
Table 21.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 21.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 21.44. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 22. console

This chapter describes the commands under the console command.

22.1. console log show

Usage:

openstack console log show [-h] [--lines <num-lines>] <server>

Show server’s console output

Expand
Table 22.1. Positional Arguments
ValueSummary

<server>

Server to show console log (name or id)

Expand
Table 22.2. Optional Arguments
ValueSummary

-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

Usage:

openstack console url show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                [--novnc | --xvpvnc | --spice | --rdp | --serial | --mks]
                                <server>

Show server’s remote console URL

Expand
Table 22.3. Positional Arguments
ValueSummary

<server>

Server to show url (name or id)

Expand
Table 22.4. Optional Arguments
ValueSummary

-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

Expand
Table 22.5. Output Formatters
ValueSummary

-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

Expand
Table 22.6. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 22.7. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 22.8. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 23. container

This chapter describes the commands under the container command.

23.1. container create

Usage:

openstack container create [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                <container-name> [<container-name> ...]

Create new container

Expand
Table 23.1. Positional Arguments
ValueSummary

<container-name>

New container name(s)

Expand
Table 23.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 23.3. Output Formatters
ValueSummary

-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

Expand
Table 23.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 23.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 23.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

23.2. container delete

Usage:

openstack container delete [-h] [--recursive]

                                <container> [<container> ...]

Delete container

Expand
Table 23.7. Positional Arguments
ValueSummary

<container>

Container(s) to delete

Expand
Table 23.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--recursive, -r

Recursively delete objects and container

23.3. container list

Usage:

openstack container list [-h] [-f {csv,json,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--sort-column SORT_COLUMN]
                              [--prefix <prefix>] [--marker <marker>]
                              [--end-marker <end-marker>]
                              [--limit <num-containers>] [--long] [--all]

List containers

Expand
Table 23.9. Optional Arguments
ValueSummary

-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)

Expand
Table 23.10. Output Formatters
ValueSummary

-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

Expand
Table 23.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 23.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 23.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

23.4. container save

Usage:

openstack container save [-h] <container>

Save container contents locally

Expand
Table 23.14. Positional Arguments
ValueSummary

<container>

Container to save

Expand
Table 23.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

23.5. container set

Usage:

openstack container set [-h] --property <key=value> <container>

Set container properties

Expand
Table 23.16. Positional Arguments
ValueSummary

<container>

Container to modify

Expand
Table 23.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key=value>

Set a property on this container (repeat option to set multiple properties)

23.6. container show

Usage:

openstack container show [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              <container>

Display container details

Expand
Table 23.18. Positional Arguments
ValueSummary

<container>

Container to display

Expand
Table 23.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 23.20. Output Formatters
ValueSummary

-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

Expand
Table 23.21. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 23.22. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 23.23. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

23.7. container unset

Usage:

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

Unset container properties

Expand
Table 23.24. Positional Arguments
ValueSummary

<container>

Container to modify

Expand
Table 23.25. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from container (repeat option to remove multiple properties)

Chapter 24. cron

This chapter describes the commands under the cron command.

24.1. cron trigger create

Usage:

openstack cron trigger create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--params PARAMS] [--pattern <* * * * *>]
                                   [--first-time <YYYY-MM-DD HH:MM>]
                                   [--count <integer>] [--utc]
                                   name workflow_identifier [workflow_input]

Create new trigger.

Expand
Table 24.1. Positional Arguments
ValueSummary

name

Cron trigger name

workflow_identifier

Workflow name or id

workflow_input

Workflow input

Expand
Table 24.2. Optional Arguments
ValueSummary

-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

Expand
Table 24.3. Output Formatters
ValueSummary

-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

Expand
Table 24.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 24.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 24.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

24.2. cron trigger delete

Usage:

openstack cron trigger delete [-h] cron_trigger [cron_trigger ...]

Delete trigger.

Expand
Table 24.7. Positional Arguments
ValueSummary

cron_trigger

Name of cron trigger(s).

Expand
Table 24.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

24.3. cron trigger list

Usage:

openstack cron trigger list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]

List all cron triggers.

Expand
Table 24.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 24.10. Output Formatters
ValueSummary

-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

Expand
Table 24.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 24.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 24.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

24.4. cron trigger show

Usage:

openstack cron trigger show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 cron_trigger

Show specific cron trigger.

Expand
Table 24.14. Positional Arguments
ValueSummary

cron_trigger

Cron trigger name

Expand
Table 24.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 24.16. Output Formatters
ValueSummary

-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

Expand
Table 24.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 24.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 24.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 25. database

This chapter describes the commands under the database command.

25.1. database backup create

Usage:

openstack database backup create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--description <description>]
                                      [--parent <parent>] [--incremental]
                                      <instance> <name>

Creates a backup of an instance.

Expand
Table 25.1. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of the backup.

Expand
Table 25.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

An optional description for the backup.

--parent <parent>

Optional id of the parent backup to perform an incremental backup from.

--incremental

Create an incremental backup based on the last full or incremental backup. It will create a full backup if no existing backup found.

Expand
Table 25.3. Output Formatters
ValueSummary

-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

Expand
Table 25.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.2. database backup delete

Usage:

openstack database backup delete [-h] <backup>

Deletes a backup.

Expand
Table 25.7. Positional Arguments
ValueSummary

<backup>

Id or name of the backup.

Expand
Table 25.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.3. database backup execution delete

Usage:

openstack database backup execution delete [-h] <execution>

Deletes an execution.

Expand
Table 25.9. Positional Arguments
ValueSummary

<execution>

Id of the execution to delete.

Expand
Table 25.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.4. database backup list

Usage:

openstack database backup list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--limit <limit>] [--marker <ID>]
                                    [--datastore <datastore>]

List database backups

Expand
Table 25.11. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Return up to n number of the most recent bcakups.

--marker <ID>

Begin displaying the results for ids greater than thespecified marker. When used with :option:`--limit,` setthis to the last ID displayed in the previous run.

--datastore <datastore>

ID or name of the datastore (to filter backups by).

Expand
Table 25.12. Output Formatters
ValueSummary

-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

Expand
Table 25.13. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.14. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.15. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.5. database backup list instance

Usage:

openstack database backup list instance [-h]

                                             [-f {csv,json,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent]
                                             [--quote {all,minimal,none,nonnumeric}]
                                             [--sort-column SORT_COLUMN]
                                             [--limit <limit>]
                                             [--marker <ID>]
                                             <instance>

Lists available backups for an instance.

Expand
Table 25.16. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Return up to n number of the most recent bcakups.

--marker <ID>

Begin displaying the results for ids greater than thespecified marker. When used with :option:`--limit,` setthis to the last ID displayed in the previous run.

Expand
Table 25.18. Output Formatters
ValueSummary

-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

Expand
Table 25.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.21. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.6. database backup show

Usage:

openstack database backup show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <backup>

Shows details of a database backup

Expand
Table 25.22. Positional Arguments
ValueSummary

<backup>

Id or name of the backup

Expand
Table 25.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.24. Output Formatters
ValueSummary

-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

Expand
Table 25.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.7. database cluster create

Usage:

openstack database cluster create [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       [--instance "opt=<value>[,opt=<value> ...]
                                       "] [--locality <policy>]
                                       <name> <datastore>
                                       <datastore_version>

Creates a new database cluster.

Expand
Table 25.28. Positional Arguments
ValueSummary

<name>

Name of the cluster.

<datastore>

A datastore name or id.

<datastore_version>

A datastore version name or id.

Expand
Table 25.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--instance "opt=<value>[,opt=<value> …​] "

Add an instance to the cluster. Specify multiple times to create multiple instances. Valid options are: flavor=<flavor_name_or_id>, volume=<disk_size_in_GB>, volume_type=<type>, nic='<net-id=<net-uuid>, v4-fixed- ip=<ip-addr>, port-id=<port-uuid>>' (where net- id=network_id, v4-fixed-ip=IPv4r_fixed_address, port- id=port_id), availability_zone=<AZ_hint_for_Nova>, module=<module_name_or_id>, type=<type_of_cluster_node>, related_to=<related_attribute>.

--locality <policy>

Locality policy to use when creating cluster. choose one of affinity, anti-affinity.

Expand
Table 25.30. Output Formatters
ValueSummary

-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

Expand
Table 25.31. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.32. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.33. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.8. database cluster delete

Usage:

openstack database cluster delete [-h] <cluster>

Deletes a cluster.

Expand
Table 25.34. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

Expand
Table 25.35. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.9. database cluster force delete

Usage:

openstack database cluster force delete [-h] <cluster>

Force delete a cluster.

Expand
Table 25.36. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

Expand
Table 25.37. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.10. database cluster grow

Usage:

openstack database cluster grow [-h]

                                     [--instance "opt=<value>[,opt=<value> ...]
                                     "]
                                     <cluster>

Adds more instances to a cluster.

Expand
Table 25.38. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

Expand
Table 25.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--instance "opt=<value>[,opt=<value> …​] "

Add an instance to the cluster. Specify multiple times to create multiple instances. Valid options are: flavor=<flavor_name_or_id>, volume=<disk_size_in_GB>, volume_type=<type>, nic='<net-id=<net-uuid>, v4-fixed- ip=<ip-addr>, port-id=<port-uuid>>' (where net- id=network_id, v4-fixed-ip=IPv4r_fixed_address, port- id=port_id), availability_zone=<AZ_hint_for_Nova>, module=<module_name_or_id>, type=<type_of_cluster_node>, related_to=<related_attribute>.

This command is provided by the python-troveclient plugin.

25.11. database cluster list

Usage:

openstack database cluster list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     [--limit <limit>] [--marker <ID>]

List database clusters

Expand
Table 25.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Limit the number of results displayed.

--marker <ID>

Begin displaying the results for ids greater than the specified marker. When used with :option:`--limit,` set this to the last ID displayed in the previous run.

Expand
Table 25.41. Output Formatters
ValueSummary

-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

Expand
Table 25.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.44. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.12. database cluster list instances

Usage:

openstack database cluster list instances [-h]

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

Lists all instances of a cluster.

Expand
Table 25.45. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

Expand
Table 25.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.47. Output Formatters
ValueSummary

-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

Expand
Table 25.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.50. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.13. database cluster modules

Usage:

openstack database cluster modules [-h]

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

Lists all modules for each instance of a cluster.

Expand
Table 25.51. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

Expand
Table 25.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.53. Output Formatters
ValueSummary

-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

Expand
Table 25.54. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.55. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.56. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.14. database cluster reset status

Usage:

openstack database cluster reset status [-h] <cluster>

Set the cluster task to NONE.

Expand
Table 25.57. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

Expand
Table 25.58. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.15. database cluster show

Usage:

openstack database cluster show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <cluster>

Shows details of a database cluster

Expand
Table 25.59. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster

Expand
Table 25.60. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.61. Output Formatters
ValueSummary

-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

Expand
Table 25.62. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.63. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.64. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.16. database cluster shrink

Usage:

openstack database cluster shrink [-h]

                                       <cluster> <instance> [<instance> ...]

Drops instances from a cluster.

Expand
Table 25.65. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

<instance>

Drop instance(s) from the cluster. specify multiple ids to drop multiple instances.

Expand
Table 25.66. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.17. database cluster upgrade

Usage:

openstack database cluster upgrade [-h] <cluster> <datastore_version>

Upgrades a cluster to a new datastore version.

Expand
Table 25.67. Positional Arguments
ValueSummary

<cluster>

Id or name of the cluster.

<datastore_version>

A datastore version name or id.

Expand
Table 25.68. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.18. database configuration attach

Usage:

openstack database configuration attach [-h] <instance> <configuration>

Attaches a configuration group to an instance.

Expand
Table 25.69. Positional Arguments
ValueSummary

<instance>

Id or name of the instance

<configuration>

Id or name of the configuration group to attach to the instance.

Expand
Table 25.70. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.19. database configuration create

Usage:

openstack database configuration create [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--datastore <datastore>]
                                             [--datastore_version <datastore_version>]
                                             [--description <description>]
                                             <name> <values>

Creates a configuration group.

Expand
Table 25.71. Positional Arguments
ValueSummary

<name>

Name of the configuration group.

<values>

Dictionary of the values to set.

Expand
Table 25.72. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--datastore <datastore>

Datastore assigned to the configuration group. Required if default datastore is not configured.

--datastore_version <datastore_version>

Datastore version ID assigned to the configuration group.

--description <description>

An optional description for the configuration group.

Expand
Table 25.73. Output Formatters
ValueSummary

-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

Expand
Table 25.74. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.75. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.76. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.20. database configuration default

Usage:

openstack database configuration default [-h]

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

Shows the default configuration of an instance.

Expand
Table 25.77. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.78. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.79. Output Formatters
ValueSummary

-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

Expand
Table 25.80. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.81. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.82. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.21. database configuration delete

Usage:

openstack database configuration delete [-h] <configuration_group>

Deletes a configuration group.

Expand
Table 25.83. Positional Arguments
ValueSummary

<configuration_group>

ID or name of the configuration group

Expand
Table 25.84. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.22. database configuration detach

Usage:

openstack database configuration detach [-h] <instance>

Detaches a configuration group from an instance.

Expand
Table 25.85. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.23. database configuration instances

Usage:

openstack database configuration instances [-h]

                                                [-f {csv,json,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--quote {all,minimal,none,nonnumeric}]
                                                [--sort-column SORT_COLUMN]
                                                [--limit <limit>]
                                                [--marker <ID>]
                                                <configuration_group>

Lists all instances associated with a configuration group.

Expand
Table 25.87. Positional Arguments
ValueSummary

<configuration_group>

ID or name of the configuration group.

Expand
Table 25.88. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Limit the number of results displayed.

--marker <ID>

Begin displaying the results for ids greater than the specified marker. When used with --limit, set this to the last ID displayed in the previous run.

Expand
Table 25.89. Output Formatters
ValueSummary

-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

Expand
Table 25.90. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.91. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.92. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.24. database configuration list

Usage:

openstack database configuration list [-h]

                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--sort-column SORT_COLUMN]
                                           [--limit <limit>] [--marker <ID>]

List database configurations

Expand
Table 25.93. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Limit the number of results displayed.

--marker <ID>

Begin displaying the results for ids greater than the specified marker. When used with --limit, set this to the last ID displayed in the previous run.

Expand
Table 25.94. Output Formatters
ValueSummary

-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

Expand
Table 25.95. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.96. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.97. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.25. database configuration parameter list

Usage:

openstack database configuration parameter list [-h]

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

Lists available parameters for a configuration group.

Expand
Table 25.98. Positional Arguments
ValueSummary

<datastore_version>

Datastore version name or id assignedto the configuration group.

Expand
Table 25.99. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--datastore <datastore>

ID or name of the datastore to list configurationparameters for. Optional if the ID of thedatastore_version is provided.

Expand
Table 25.100. Output Formatters
ValueSummary

-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

Expand
Table 25.101. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.102. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.103. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.26. database configuration parameter show

Usage:

openstack database configuration parameter show [-h]

                                                     [-f {json,shell,table,value,yaml}]
                                                     [-c COLUMN]
                                                     [--max-width <integer>]
                                                     [--fit-width]
                                                     [--print-empty]
                                                     [--noindent]
                                                     [--prefix PREFIX]
                                                     [--datastore <datastore>]
                                                     <datastore_version>
                                                     <parameter>

Shows details of a database configuration parameter.

Expand
Table 25.104. Positional Arguments
ValueSummary

<datastore_version>

Datastore version name or id assigned to the configuration group.

<parameter>

Name of the configuration parameter.

Expand
Table 25.105. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--datastore <datastore>

ID or name of the datastore to list configuration parameters for. Optional if the ID of the datastore_version is provided.

Expand
Table 25.106. Output Formatters
ValueSummary

-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

Expand
Table 25.107. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.108. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.109. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.27. database configuration show

Usage:

openstack database configuration show [-h]

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

Shows details of a database configuration group.

Expand
Table 25.110. Positional Arguments
ValueSummary

<configuration_group>

ID or name of the configuration group

Expand
Table 25.111. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.112. Output Formatters
ValueSummary

-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

Expand
Table 25.113. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.114. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.115. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.28. database db create

Usage:

openstack database db create [-h] [--character_set <character_set>]

                                  [--collate <collate>]
                                  <instance> <name>

Creates a database on an instance.

Expand
Table 25.116. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of the database.

Expand
Table 25.117. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--character_set <character_set>

Optional character set for database.

--collate <collate>

Optional collation type for database.

This command is provided by the python-troveclient plugin.

25.29. database db delete

Usage:

openstack database db delete [-h] <instance> <database>

Deletes a database from an instance.

Expand
Table 25.118. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<database>

Name of the database.

Expand
Table 25.119. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.30. database db list

Usage:

openstack database db list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                <instance>

Get a list of all Databases from the instance.

Expand
Table 25.120. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.121. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.122. Output Formatters
ValueSummary

-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

Expand
Table 25.123. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.124. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.125. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.31. database flavor list

Usage:

openstack database flavor list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--datastore-type <datastore-type>]
                                    [--datastore-version-id <datastore-version-id>]

List database flavors

Expand
Table 25.126. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--datastore-type <datastore-type>

Type of the datastore. For eg: mysql.

--datastore-version-id <datastore-version-id>

ID of the datastore version.

Expand
Table 25.127. Output Formatters
ValueSummary

-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

Expand
Table 25.128. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.129. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.130. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.32. database flavor show

Usage:

openstack database flavor show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <flavor>

Shows details of a database flavor

Expand
Table 25.131. Positional Arguments
ValueSummary

<flavor>

Id or name of the flavor

Expand
Table 25.132. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.133. Output Formatters
ValueSummary

-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

Expand
Table 25.134. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.135. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.136. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.33. database instance create

Usage:

openstack database instance create [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        [--size <size>]
                                        [--volume_type <volume_type>]
                                        [--databases <database> [<database> ...]]
                                        [--users <user:password> [<user:password> ...]]
                                        [--backup <backup>]
                                        [--availability_zone <availability_zone>]
                                        [--datastore <datastore>]
                                        [--datastore_version <datastore_version>]
                                        [--nic <net-id=<net-uuid>,v4-fixed-ip=<ip-addr>,port-id=<port-uuid>>]
                                        [--configuration <configuration>]
                                        [--replica_of <source_instance>]
                                        [--replica_count <count>]
                                        [--module <module>]
                                        [--locality <policy>]
                                        <name> <flavor>

Creates a new database instance.

Expand
Table 25.137. Positional Arguments
ValueSummary

<name>

Name of the instance.

<flavor>

A flavor name or id.

Expand
Table 25.138. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--size <size>

Size of the instance disk volume in gb. required when volume support is enabled.

--volume_type <volume_type>

Volume type. Optional when volume support is enabled.

--databases <database> [<database> …​]

Optional list of databases.

--users <user:password> [<user:password> …​]

Optional list of users.

--backup <backup>

A backup name or id.

--availability_zone <availability_zone>

The Zone hint to give to Nova.

--datastore <datastore>

A datastore name or ID.

--datastore_version <datastore_version>

A datastore version name or ID.

--nic <net-id=<net-uuid>,v4-fixed-ip=<ip-addr>,port-id=<port-uuid>>

Create a NIC on the instance. Specify option multiple times to create multiple NICs. net-id: attach NIC to network with this ID (either port-id or net-id must be specified), v4-fixed-ip: IPv4 fixed address for NIC (optional), port-id: attach NIC to port with this ID (either port-id or net-id must be specified).

--configuration <configuration>

ID of the configuration group to attach to the instance.

--replica_of <source_instance>

ID or name of an existing instance to replicate from.

--replica_count <count>

Number of replicas to create (defaults to 1 if replica_of specified).

--module <module>

Id or name of the module to apply. specify multiple times to apply multiple modules.

--locality <policy>

Locality policy to use when creating replicas. choose one of affinity, anti-affinity.

Expand
Table 25.139. Output Formatters
ValueSummary

-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

Expand
Table 25.140. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.141. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.142. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.34. database instance delete

Usage:

openstack database instance delete [-h] <instance>

Deletes an instance.

Expand
Table 25.143. Positional Arguments
ValueSummary

<instance>

Id or name of the instance

Expand
Table 25.144. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.35. database instance detach replica

Usage:

openstack database instance detach replica [-h] <instance>

Detaches a replica instance from its replication source.

Expand
Table 25.145. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.146. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.36. database instance eject replica source

Usage:

openstack database instance eject replica source [-h] <instance>

Ejects a replica source from its set.

Expand
Table 25.147. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.148. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.37. database instance force delete

Usage:

openstack database instance force delete [-h] <instance>

Force delete an instance.

Expand
Table 25.149. Positional Arguments
ValueSummary

<instance>

Id or name of the instance

Expand
Table 25.150. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.38. database instance list

Usage:

openstack database instance list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--limit <limit>] [--marker <ID>]
                                      [--include_clustered]

List database instances

Expand
Table 25.151. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Limit the number of results displayed.

--marker <ID>

Begin displaying the results for ids greater than thespecified marker. When used with :option:`--limit,` setthis to the last ID displayed in the previous run.

--include_clustered, --include-clustered

Include instances that are part of a cluster (default False). --include-clustered may be deprecated in the future, retaining just --include_clustered.

Expand
Table 25.152. Output Formatters
ValueSummary

-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

Expand
Table 25.153. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.154. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.155. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.39. database instance promote to replica source

Usage:

openstack database instance promote to replica source [-h] <instance>

Promotes a replica to be the new replica source of its set.

Expand
Table 25.156. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.157. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.40. database instance reset status

Usage:

openstack database instance reset status [-h] <instance>

Set the task status of an instance to NONE if the instance is in BUILD or ERROR state. Resetting task status of an instance in BUILD state will allow the instance to be deleted.

Expand
Table 25.158. Positional Arguments
ValueSummary

<instance>

Id or name of the instance

Expand
Table 25.159. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.41. database instance resize flavor

Usage:

openstack database instance resize flavor [-h] <instance> <flavor_id>

Resize an instance with a new flavor

Expand
Table 25.160. Positional Arguments
ValueSummary

<instance>

Id or name of the instance

<flavor_id>

New flavor of the instance

Expand
Table 25.161. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.42. database instance resize volume

Usage:

openstack database instance resize volume [-h] <instance> <size>

Resizes the volume size of an instance.

Expand
Table 25.162. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<size>

New size of the instance disk volume in gb.

Expand
Table 25.163. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.43. database instance restart

Usage:

openstack database instance restart [-h] <instance>

Restarts an instance.

Expand
Table 25.164. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.165. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.44. database instance show

Usage:

openstack database instance show [-h]

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

Show instance details

Expand
Table 25.166. Positional Arguments
ValueSummary

<instance>

Instance (name or id)

Expand
Table 25.167. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.168. Output Formatters
ValueSummary

-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

Expand
Table 25.169. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.170. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.171. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.45. database instance update

Usage:

openstack database instance update [-h] [--name <name>]

                                        [--configuration <configuration>]
                                        [--detach_replica_source]
                                        [--remove_configuration]
                                        <instance>

Updates an instance: Edits name, configuration, or replica source.

Expand
Table 25.172. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.173. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Id or name of the instance.

--configuration <configuration>

ID of the configuration reference to attach.

--detach_replica_source, --detach-replica-source

Detach the replica instance from its replication source. --detach-replica-source may be deprecated in the future in favor of just --detach_replica_source

--remove_configuration

Drops the current configuration reference.

This command is provided by the python-troveclient plugin.

25.46. database instance upgrade

Usage:

openstack database instance upgrade [-h] <instance> <datastore_version>

Upgrades an instance to a new datastore version.

Expand
Table 25.174. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<datastore_version>

Id or name of the instance.

Expand
Table 25.175. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.47. database limit list

Usage:

openstack database limit list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]

List database limits

Expand
Table 25.176. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.177. Output Formatters
ValueSummary

-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

Expand
Table 25.178. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.179. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.180. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.48. database log enable

Usage:

openstack database log enable [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <instance> <log_name>

Instructs Trove guest to start collecting log details.

Expand
Table 25.181. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<log_name>

Name of log to publish.

Expand
Table 25.182. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.183. Output Formatters
ValueSummary

-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

Expand
Table 25.184. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.185. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.186. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.49. database log list

Usage:

openstack database log list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]
                                 <instance>

Lists the log files available for instance.

Expand
Table 25.187. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.188. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.189. Output Formatters
ValueSummary

-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

Expand
Table 25.190. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.191. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.192. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.50. database quota show

Usage:

openstack database quota show [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   <tenant_id>

Show quotas for a tenant.

Expand
Table 25.193. Positional Arguments
ValueSummary

<tenant_id>

Id of tenant for which to show quotas.

Expand
Table 25.194. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.195. Output Formatters
ValueSummary

-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

Expand
Table 25.196. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.197. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.198. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.51. database quota update

Usage:

openstack database quota update [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <tenant_id> <resource> <limit>

Update quotas for a tenant.

Expand
Table 25.199. Positional Arguments
ValueSummary

<tenant_id>

Id of tenant for which to update quotas.

<resource>

Id of resource to change.

<limit>

New limit to set for the named resource.

Expand
Table 25.200. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.201. Output Formatters
ValueSummary

-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

Expand
Table 25.202. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.203. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.204. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.52. database root disable

Usage:

openstack database root disable [-h] <instance>

Disables root for an instance.

Expand
Table 25.205. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.206. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-troveclient plugin.

25.53. database root enable

Usage:

openstack database root enable [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--root_password <root_password>]
                                    <instance_or_cluster>

Enables root for an instance and resets if already exists.

Expand
Table 25.207. Positional Arguments
ValueSummary

<instance_or_cluster>

ID or name of the instance or cluster.

Expand
Table 25.208. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--root_password <root_password>

Root password to set.

Expand
Table 25.209. Output Formatters
ValueSummary

-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

Expand
Table 25.210. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.211. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.212. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.54. database root show

Usage:

openstack database root show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <instance_or_cluster>

Gets status if root was ever enabled for an instance or cluster.

Expand
Table 25.213. Positional Arguments
ValueSummary

<instance_or_cluster>

ID or name of the instance or cluster.

Expand
Table 25.214. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.215. Output Formatters
ValueSummary

-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

Expand
Table 25.216. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.217. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.218. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.55. database user create

Usage:

openstack database user create [-h] [--host <host>]

                                    [--databases <databases> [<databases> ...]]
                                    <instance> <name> <password>

Creates a user on an instance.

Expand
Table 25.219. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

<password>

Password of user.

Expand
Table 25.220. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

--databases <databases> [<databases> …​]

Optional list of databases.

This command is provided by the python-troveclient plugin.

25.56. database user delete

Usage:

openstack database user delete [-h] [--host <host>] <instance> <name>

Deletes a user from an instance.

Expand
Table 25.221. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

Expand
Table 25.222. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

This command is provided by the python-troveclient plugin.

25.57. database user grant access

Usage:

openstack database user grant access [-h] [--host <host>]

                                          <instance> <name> <databases>
                                          [<databases> ...]

Grants access to a database(s) for a user.

Expand
Table 25.223. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

<databases>

List of databases.

Expand
Table 25.224. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

This command is provided by the python-troveclient plugin.

25.58. database user list

Usage:

openstack database user list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  <instance>

Lists the users for an instance.

Expand
Table 25.225. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

Expand
Table 25.226. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 25.227. Output Formatters
ValueSummary

-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

Expand
Table 25.228. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.229. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.230. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.59. database user revoke access

Usage:

openstack database user revoke access [-h] [--host <host>]

                                           <instance> <name> <databases>

Revokes access to a database for a user.

Expand
Table 25.231. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

<databases>

A single database.

Expand
Table 25.232. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

This command is provided by the python-troveclient plugin.

25.60. database user show

Usage:

openstack database user show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] [--host <host>]
                                  <instance> <name>

Shows details of a database user of an instance.

Expand
Table 25.233. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

Expand
Table 25.234. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

Expand
Table 25.235. Output Formatters
ValueSummary

-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

Expand
Table 25.236. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.237. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.238. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

25.61. database user show access

Usage:

openstack database user show access [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--host <host>]
                                         <instance> <name>

Shows access details of a user of an instance.

Expand
Table 25.239. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

Expand
Table 25.240. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

Expand
Table 25.241. Output Formatters
ValueSummary

-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

Expand
Table 25.242. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 25.243. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 25.244. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

25.62. database user update attributes

Usage:

openstack database user update attributes [-h] [--host <host>]

                                               [--new_name <new_name>]
                                               [--new_password <new_password>]
                                               [--new_host <new_host>]
                                               <instance> <name>

Updates a user’s attributes on an instance.At least one optional argument must be provided.

Expand
Table 25.245. Positional Arguments
ValueSummary

<instance>

Id or name of the instance.

<name>

Name of user.

Expand
Table 25.246. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Optional host of user.

--new_name <new_name>

Optional new name of user.

--new_password <new_password>

Optional new password of user.

--new_host <new_host>

Optional new host of user.

This command is provided by the python-troveclient plugin.

Chapter 26. dataprocessing

This chapter describes the commands under the dataprocessing command.

26.1. dataprocessing cluster create

Usage:

openstack dataprocessing cluster create [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--name <name>]
                                             [--cluster-template <cluster-template>]
                                             [--image <image>]
                                             [--description <description>]
                                             [--user-keypair <keypair>]
                                             [--neutron-network <network>]
                                             [--count <count>] [--public]
                                             [--protected] [--transient]
                                             [--json <filename>] [--wait]

Creates cluster

Expand
Table 26.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the cluster [required if json is not provided]

--cluster-template <cluster-template>

Cluster template name or ID [REQUIRED if JSON is not provided]

--image <image>

Image that will be used for cluster deployment (name or ID) [REQUIRED if JSON is not provided]

--description <description>

Description of the cluster

--user-keypair <keypair>

User keypair to get acces to VMs after cluster creation

--neutron-network <network>

Instances of the cluster will get fixed IP addresses in this network. (Name or ID should be provided)

--count <count>

Number of clusters to be created

--public

Make the cluster public (visible from other projects)

--protected

Make the cluster protected

--transient

Create transient cluster

--json <filename>

Json representation of the cluster. other arguments (except for --wait) will not be taken into account if this one is provided

--wait

Wait for the cluster creation to complete

Expand
Table 26.2. Output Formatters
ValueSummary

-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

Expand
Table 26.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.2. dataprocessing cluster delete

Usage:

openstack dataprocessing cluster delete [-h] [--wait]

                                             <cluster> [<cluster> ...]

Deletes cluster

Expand
Table 26.6. Positional Arguments
ValueSummary

<cluster>

Name(s) or id(s) of the cluster(s) to delete

Expand
Table 26.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for the cluster(s) delete to complete

This command is provided by the python-saharaclient plugin.

26.3. dataprocessing cluster list

Usage:

openstack dataprocessing cluster list [-h]

                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--sort-column SORT_COLUMN]
                                           [--long] [--plugin <plugin>]
                                           [--plugin-version <plugin_version>]
                                           [--name <name-substring>]

Lists clusters

Expand
Table 26.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--plugin <plugin>

List clusters with specific plugin

--plugin-version <plugin_version>

List clusters with specific version of the plugin

--name <name-substring>

List clusters with specific substring in the name

Expand
Table 26.9. Output Formatters
ValueSummary

-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

Expand
Table 26.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.4. dataprocessing cluster scale

Usage:

openstack dataprocessing cluster scale [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--instances <node-group-template:instances_count> [<node-group-template:instances_count> ...]]
                                            [--json <filename>] [--wait]
                                            <cluster>

Scales cluster

Expand
Table 26.13. Positional Arguments
ValueSummary

<cluster>

Name or id of the cluster

Expand
Table 26.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--instances <node-group-template:instances_count> [<node-group-template:instances_count> …​]

Node group templates and number of their instances to be scale to [REQUIRED if JSON is not provided]

--json <filename>

Json representation of the cluster scale object. other arguments (except for --wait) will not be taken into account if this one is provided

--wait

Wait for the cluster scale to complete

Expand
Table 26.15. Output Formatters
ValueSummary

-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

Expand
Table 26.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.18. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.5. dataprocessing cluster show

Usage:

openstack dataprocessing cluster show [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           [--verification]
                                           [--show-progress]
                                           [--full-dump-events]
                                           <cluster>

Display cluster details

Expand
Table 26.19. Positional Arguments
ValueSummary

<cluster>

Name or id of the cluster to display

Expand
Table 26.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--verification

List additional fields for verifications

--show-progress

Provides ability to show brief details of event logs.

--full-dump-events

Provides ability to make full dump with event log details.

Expand
Table 26.21. Output Formatters
ValueSummary

-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

Expand
Table 26.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.24. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.6. dataprocessing cluster template create

Usage:

openstack dataprocessing cluster template create [-h]

                                                      [-f {json,shell,table,value,yaml}]
                                                      [-c COLUMN]
                                                      [--max-width <integer>]
                                                      [--fit-width]
                                                      [--print-empty]
                                                      [--noindent]
                                                      [--prefix PREFIX]
                                                      [--name <name>]
                                                      [--node-groups <node-group:instances_count> [<node-group:instances_count> ...]]
                                                      [--anti-affinity <anti-affinity> [<anti-affinity> ...]]
                                                      [--description <description>]
                                                      [--autoconfig]
                                                      [--public]
                                                      [--protected]
                                                      [--json <filename>]
                                                      [--shares <filename>]
                                                      [--configs <filename>]
                                                      [--domain-name <domain-name>]

Creates cluster template

Expand
Table 26.25. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the cluster template [required if json is not provided]

--node-groups <node-group:instances_count> [<node-group:instances_count> …​]

List of the node groups(names or IDs) and numbers of instances for each one of them [REQUIRED if JSON is not provided]

--anti-affinity <anti-affinity> [<anti-affinity> …​]

List of processes that should be added to an anti- affinity group

--description <description>

Description of the cluster template

--autoconfig

If enabled, instances of the cluster will be automatically configured

--public

Make the cluster template public (visible from other projects)

--protected

Make the cluster template protected

--json <filename>

Json representation of the cluster template. other arguments will not be taken into account if this one is provided

--shares <filename>

Json representation of the manila shares

--configs <filename>

Json representation of the cluster template configs

--domain-name <domain-name>

Domain name for instances of this cluster template. This option is available if 'use_designate' config is True

Expand
Table 26.26. Output Formatters
ValueSummary

-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

Expand
Table 26.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.29. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.7. dataprocessing cluster template delete

Usage:

openstack dataprocessing cluster template delete [-h]

                                                      <cluster-template>
                                                      [<cluster-template> ...]

Deletes cluster template

Expand
Table 26.30. Positional Arguments
ValueSummary

<cluster-template>

Name(s) or id(s) of the cluster template(s) to delete

Expand
Table 26.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-saharaclient plugin.

26.8. dataprocessing cluster template export

Usage:

openstack dataprocessing cluster template export [-h]

                                                      [--file <filename>]
                                                      <cluster-template>

Export cluster template to JSON

Expand
Table 26.32. Positional Arguments
ValueSummary

<cluster-template>

Name or id of the cluster template to export

Expand
Table 26.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <filename>

Name of the file cluster template should be exported to If not provided, print to stdout

This command is provided by the python-saharaclient plugin.

26.9. dataprocessing cluster template import

Usage:

openstack dataprocessing cluster template import [-h]

                                                      [-f {json,shell,table,value,yaml}]
                                                      [-c COLUMN]
                                                      [--max-width <integer>]
                                                      [--fit-width]
                                                      [--print-empty]
                                                      [--noindent]
                                                      [--prefix PREFIX]
                                                      [--name <name>]
                                                      [--default-image-id <default_image_id>]
                                                      --node-groups
                                                      <node-group:instances_count>
                                                      [<node-group:instances_count> ...]
                                                      <json>

Imports cluster template

Expand
Table 26.34. Positional Arguments
ValueSummary

<json>

Json containing cluster template

Expand
Table 26.35. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the cluster template

--default-image-id <default_image_id>

Default image ID to be used

--node-groups <node-group:instances_count> [<node-group:instances_count> …​]

List of the node groups(names or IDs) and numbers of instances for each one of them

Expand
Table 26.36. Output Formatters
ValueSummary

-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

Expand
Table 26.37. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.38. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.39. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.10. dataprocessing cluster template list

Usage:

openstack dataprocessing cluster template list [-h]

                                                    [-f {csv,json,table,value,yaml}]
                                                    [-c COLUMN]
                                                    [--max-width <integer>]
                                                    [--fit-width]
                                                    [--print-empty]
                                                    [--noindent]
                                                    [--quote {all,minimal,none,nonnumeric}]
                                                    [--sort-column SORT_COLUMN]
                                                    [--long]
                                                    [--plugin <plugin>]
                                                    [--plugin-version <plugin_version>]
                                                    [--name <name-substring>]

Lists cluster templates

Expand
Table 26.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--plugin <plugin>

List cluster templates for specific plugin

--plugin-version <plugin_version>

List cluster templates with specific version of the plugin

--name <name-substring>

List cluster templates with specific substring in the name

Expand
Table 26.41. Output Formatters
ValueSummary

-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

Expand
Table 26.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.44. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.11. dataprocessing cluster template show

Usage:

openstack dataprocessing cluster template show [-h]

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

Display cluster template details

Expand
Table 26.45. Positional Arguments
ValueSummary

<cluster-template>

Name or id of the cluster template to display

Expand
Table 26.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.47. Output Formatters
ValueSummary

-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

Expand
Table 26.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.50. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.12. dataprocessing cluster template update

Usage:

openstack dataprocessing cluster template update [-h]

                                                      [-f {json,shell,table,value,yaml}]
                                                      [-c COLUMN]
                                                      [--max-width <integer>]
                                                      [--fit-width]
                                                      [--print-empty]
                                                      [--noindent]
                                                      [--prefix PREFIX]
                                                      [--name <name>]
                                                      [--node-groups <node-group:instances_count> [<node-group:instances_count> ...]]
                                                      [--anti-affinity <anti-affinity> [<anti-affinity> ...]]
                                                      [--description <description>]
                                                      [--autoconfig-enable | --autoconfig-disable]
                                                      [--public | --private]
                                                      [--protected | --unprotected]
                                                      [--json <filename>]
                                                      [--shares <filename>]
                                                      [--configs <filename>]
                                                      [--domain-name <domain-name>]
                                                      <cluster-template>

Updates cluster template

Expand
Table 26.51. Positional Arguments
ValueSummary

<cluster-template>

Name or id of the cluster template [required]

Expand
Table 26.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New name of the cluster template

--node-groups <node-group:instances_count> [<node-group:instances_count> …​]

List of the node groups(names or IDs) and numbers ofinstances for each one of them

--anti-affinity <anti-affinity> [<anti-affinity> …​]

List of processes that should be added to an anti- affinity group

--description <description>

Description of the cluster template

--autoconfig-enable

Instances of the cluster will be automatically configured

--autoconfig-disable

Instances of the cluster will not be automatically configured

--public

Make the cluster template public (visible from other projects)

--private

Make the cluster template private (visible only from this tenant)

--protected

Make the cluster template protected

--unprotected

Make the cluster template unprotected

--json <filename>

Json representation of the cluster template. other arguments will not be taken into account if this one is provided

--shares <filename>

Json representation of the manila shares

--configs <filename>

Json representation of the cluster template configs

--domain-name <domain-name>

Domain name for instances of this cluster template. This option is available if 'use_designate' config is True

Expand
Table 26.53. Output Formatters
ValueSummary

-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

Expand
Table 26.54. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.55. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.56. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.13. dataprocessing cluster update

Usage:

openstack dataprocessing cluster update [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--name <name>]
                                             [--description <description>]
                                             [--shares <filename>]
                                             [--public | --private]
                                             [--protected | --unprotected]
                                             <cluster>

Updates cluster

Expand
Table 26.57. Positional Arguments
ValueSummary

<cluster>

Name or id of the cluster

Expand
Table 26.58. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New name of the cluster

--description <description>

Description of the cluster

--shares <filename>

Json representation of the manila shares

--public

Make the cluster public (visible from other projects)

--private

Make the cluster private (visible only from this tenant)

--protected

Make the cluster protected

--unprotected

Make the cluster unprotected

Expand
Table 26.59. Output Formatters
ValueSummary

-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

Expand
Table 26.60. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.61. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.62. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.14. dataprocessing cluster verification

Usage:

openstack dataprocessing cluster verification [-h]

                                                   [-f {json,shell,table,value,yaml}]
                                                   [-c COLUMN]
                                                   [--max-width <integer>]
                                                   [--fit-width]
                                                   [--print-empty]
                                                   [--noindent]
                                                   [--prefix PREFIX]
                                                   (--start | --show)
                                                   <cluster>

Updates cluster verifications

Expand
Table 26.63. Positional Arguments
ValueSummary

<cluster>

Name or id of the cluster

Expand
Table 26.64. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--start

Start health verification for the cluster

--show

Show health of the cluster

Expand
Table 26.65. Output Formatters
ValueSummary

-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

Expand
Table 26.66. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.67. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.68. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.15. dataprocessing data source create

Usage:

openstack dataprocessing data source create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX] --type
                                                 <type> --url <url>
                                                 [--username <username> | --access-key <accesskey>]
                                                 [--password <password> | --secret-key <secretkey>]
                                                 [--s3-endpoint <endpoint>]
                                                 [--enable-s3-ssl | --disable-s3-ssl]
                                                 [--enable-s3-bucket-in-path | --disable-s3-bucket-in-path]
                                                 [--description <description>]
                                                 [--public] [--protected]
                                                 <name>

Creates data source

Expand
Table 26.69. Positional Arguments
ValueSummary

<name>

Name of the data source

Expand
Table 26.70. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type <type>

Type of the data source (swift, hdfs, maprfs, manila, s3) [REQUIRED]

--url <url>

Url for the data source [required]

--username <username>

Username for accessing the data source URL

--access-key <accesskey>

S3 access key for accessing the data source URL

--password <password>

Password for accessing the data source URL

--secret-key <secretkey>

S3 secret key for accessing the data source URL

--s3-endpoint <endpoint>

S3 endpoint for accessing the data source URL (ignored if data source not in S3)

--enable-s3-ssl

Enable access to s3 endpoint using ssl (ignored if data source not in S3)

--disable-s3-ssl

Disable access to s3 endpoint using ssl (ignored if data source not in S3)

--enable-s3-bucket-in-path

Access S3 endpoint using bucket name in path (ignored if data source not in S3)

--disable-s3-bucket-in-path

Access S3 endpoint using bucket name in path (ignored if data source not in S3)

--description <description>

Description of the data source

--public

Make the data source public

--protected

Make the data source protected

Expand
Table 26.71. Output Formatters
ValueSummary

-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

Expand
Table 26.72. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.73. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.74. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.16. dataprocessing data source delete

Usage:

openstack dataprocessing data source delete [-h]

                                                 <data-source>
                                                 [<data-source> ...]

Delete data source

Expand
Table 26.75. Positional Arguments
ValueSummary

<data-source>

Name(s) or id(s) of the data source(s) to delete

Expand
Table 26.76. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-saharaclient plugin.

26.17. dataprocessing data source list

Usage:

openstack dataprocessing data source list [-h]

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

Lists data sources

Expand
Table 26.77. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--type <type>

List data sources of specific type (swift, hdfs, maprfs, manila, s3)

Expand
Table 26.78. Output Formatters
ValueSummary

-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

Expand
Table 26.79. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.80. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.81. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.18. dataprocessing data source show

Usage:

openstack dataprocessing data source show [-h]

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

Display data source details

Expand
Table 26.82. Positional Arguments
ValueSummary

<data-source>

Name or id of the data source to display

Expand
Table 26.83. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.84. Output Formatters
ValueSummary

-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

Expand
Table 26.85. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.86. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.87. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.19. dataprocessing data source update

Usage:

openstack dataprocessing data source update [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX]
                                                 [--name <name>]
                                                 [--type <type>]
                                                 [--url <url>]
                                                 [--username <username> | --access-key <accesskey>]
                                                 [--password <password> | --secret-key <secretkey>]
                                                 [--s3-endpoint <endpoint>]
                                                 [--enable-s3-ssl | --disable-s3-ssl]
                                                 [--enable-s3-bucket-in-path | --disable-s3-bucket-in-path]
                                                 [--description <description>]
                                                 [--public | --private]
                                                 [--protected | --unprotected]
                                                 <data-source>

Update data source

Expand
Table 26.88. Positional Arguments
ValueSummary

<data-source>

Name or id of the data source

Expand
Table 26.89. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New name of the data source

--type <type>

Type of the data source (swift, hdfs, maprfs, manila, s3)

--url <url>

Url for the data source

--username <username>

Username for accessing the data source URL

--access-key <accesskey>

S3 access key for accessing the data source URL

--password <password>

Password for accessing the data source URL

--secret-key <secretkey>

S3 secret key for accessing the data source URL

--s3-endpoint <endpoint>

S3 endpoint for accessing the data source URL (ignored if data source not in S3)

--enable-s3-ssl

Enable access to s3 endpoint using ssl (ignored if data source not in S3)

--disable-s3-ssl

Disable access to s3 endpoint using ssl (ignored if data source not in S3)

--enable-s3-bucket-in-path

Access S3 endpoint using bucket name in path (ignored if data source not in S3)

--disable-s3-bucket-in-path

Access S3 endpoint using bucket name in path (ignored if data source not in S3)

--description <description>

Description of the data source

--public

Make the data source public (visible from other projects)

--private

Make the data source private (visible only from this tenant)

--protected

Make the data source protected

--unprotected

Make the data source unprotected

Expand
Table 26.90. Output Formatters
ValueSummary

-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

Expand
Table 26.91. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.92. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.93. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.20. dataprocessing image list

Usage:

openstack dataprocessing image list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--long] [--name <name-regex>]
                                         [--tags <tag> [<tag> ...]]
                                         [--username <username>]

Lists registered images

Expand
Table 26.94. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--name <name-regex>

Regular expression to match image name

--tags <tag> [<tag> …​]

List images with specific tag(s)

--username <username>

List images with specific username

Expand
Table 26.95. Output Formatters
ValueSummary

-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

Expand
Table 26.96. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.97. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.98. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.21. dataprocessing image register

Usage:

openstack dataprocessing image register [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             --username <username>
                                             [--description <description>]
                                             <image>

Register an image

Expand
Table 26.99. Positional Arguments
ValueSummary

<image>

Name or id of the image to register

Expand
Table 26.100. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--username <username>

Username of privileged user in the image [REQUIRED]

--description <description>

Description of the image. If not provided, description of the image will be reset to empty

Expand
Table 26.101. Output Formatters
ValueSummary

-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

Expand
Table 26.102. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.103. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.104. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.22. dataprocessing image show

Usage:

openstack dataprocessing image show [-h]

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

Display image details

Expand
Table 26.105. Positional Arguments
ValueSummary

<image>

Name or id of the image to display

Expand
Table 26.106. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.107. Output Formatters
ValueSummary

-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

Expand
Table 26.108. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.109. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.110. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.23. dataprocessing image tags add

Usage:

openstack dataprocessing image tags add [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             --tags <tag> [<tag> ...]
                                             <image>

Add image tags

Expand
Table 26.111. Positional Arguments
ValueSummary

<image>

Name or id of the image

Expand
Table 26.112. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--tags <tag> [<tag> …​]

Tag(s) to add [REQUIRED]

Expand
Table 26.113. Output Formatters
ValueSummary

-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

Expand
Table 26.114. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.115. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.116. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.24. dataprocessing image tags remove

Usage:

openstack dataprocessing image tags remove [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                [--tags <tag> [<tag> ...] |
                                                --all]
                                                <image>

Remove image tags

Expand
Table 26.117. Positional Arguments
ValueSummary

<image>

Name or id of the image

Expand
Table 26.118. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--tags <tag> [<tag> …​]

Tag(s) to remove

--all

Remove all tags from image

Expand
Table 26.119. Output Formatters
ValueSummary

-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

Expand
Table 26.120. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.121. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.122. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.25. dataprocessing image tags set

Usage:

openstack dataprocessing image tags set [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             --tags <tag> [<tag> ...]
                                             <image>

Set image tags (Replace current image tags with provided ones)

Expand
Table 26.123. Positional Arguments
ValueSummary

<image>

Name or id of the image

Expand
Table 26.124. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--tags <tag> [<tag> …​]

Tag(s) to set [REQUIRED]

Expand
Table 26.125. Output Formatters
ValueSummary

-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

Expand
Table 26.126. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.127. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.128. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.26. dataprocessing image unregister

Usage:

openstack dataprocessing image unregister [-h] <image> [<image> ...]

Unregister image(s)

Expand
Table 26.129. Positional Arguments
ValueSummary

<image>

Name(s) or id(s) of the image(s) to unregister

Expand
Table 26.130. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-saharaclient plugin.

26.27. dataprocessing job binary create

Usage:

openstack dataprocessing job binary create [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                [--name <name>]
                                                [--data <file> | --url <url>]
                                                [--description <description>]
                                                [--username <username> | --access-key <accesskey>]
                                                [--password <password> | --secret-key <secretkey> | --password-prompt | --secret-key-prompt]
                                                [--s3-endpoint <endpoint>]
                                                [--public] [--protected]
                                                [--json <filename>]

Creates job binary

Expand
Table 26.131. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the job binary [required if json is not provided]

--data <file>

File that will be stored in the internal db [required if JSON and URL are not provided]

--url <url>

Url for the job binary [required if json and file are not provided]

--description <description>

Description of the job binary

--username <username>

Username for accessing the job binary URL

--access-key <accesskey>

S3 access key for accessing the job binary URL

--password <password>

Password for accessing the job binary URL

--secret-key <secretkey>

S3 secret key for accessing the job binary URL

--password-prompt

Prompt interactively for password

--secret-key-prompt

Prompt interactively for s3 secret key

--s3-endpoint <endpoint>

S3 endpoint for accessing the job binary URL (ignored if binary not in S3

--public

Make the job binary public

--protected

Make the job binary protected

--json <filename>

Json representation of the job binary. other arguments will not be taken into account if this one is provided

Expand
Table 26.132. Output Formatters
ValueSummary

-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

Expand
Table 26.133. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.134. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.135. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.28. dataprocessing job binary delete

Usage:

openstack dataprocessing job binary delete [-h]

                                                <job-binary>
                                                [<job-binary> ...]

Deletes job binary

Expand
Table 26.136. Positional Arguments
ValueSummary

<job-binary>

Name(s) or id(s) of the job binary(ies) to delete

Expand
Table 26.137. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-saharaclient plugin.

26.29. dataprocessing job binary download

Usage:

openstack dataprocessing job binary download [-h] [--file <file>]

                                                  <job-binary>

Downloads job binary

Expand
Table 26.138. Positional Arguments
ValueSummary

<job-binary>

Name or id of the job binary to download

Expand
Table 26.139. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <file>

Destination file (defaults to job binary name)

This command is provided by the python-saharaclient plugin.

26.30. dataprocessing job binary list

Usage:

openstack dataprocessing job binary list [-h]

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

Lists job binaries

Expand
Table 26.140. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--name <name-substring>

List job binaries with specific substring in the name

Expand
Table 26.141. Output Formatters
ValueSummary

-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

Expand
Table 26.142. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.143. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.144. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.31. dataprocessing job binary show

Usage:

openstack dataprocessing job binary show [-h]

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

Display job binary details

Expand
Table 26.145. Positional Arguments
ValueSummary

<job-binary>

Name or id of the job binary to display

Expand
Table 26.146. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.147. Output Formatters
ValueSummary

-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

Expand
Table 26.148. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.149. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.150. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.32. dataprocessing job binary update

Usage:

openstack dataprocessing job binary update [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                [--name <name>]
                                                [--url <url>]
                                                [--description <description>]
                                                [--username <username> | --access-key <accesskey>]
                                                [--password <password> | --secret-key <secretkey> | --password-prompt | --secret-key-prompt]
                                                [--s3-endpoint <endpoint>]
                                                [--public | --private]
                                                [--protected | --unprotected]
                                                [--json <filename>]
                                                <job-binary>

Updates job binary

Expand
Table 26.151. Positional Arguments
ValueSummary

<job-binary>

Name or id of the job binary

Expand
Table 26.152. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New name of the job binary

--url <url>

Url for the job binary [internal db url can not be updated]

--description <description>

Description of the job binary

--username <username>

Username for accessing the job binary URL

--access-key <accesskey>

S3 access key for accessing the job binary URL

--password <password>

Password for accessing the job binary URL

--secret-key <secretkey>

S3 secret key for accessing the job binary URL

--password-prompt

Prompt interactively for password

--secret-key-prompt

Prompt interactively for s3 secret key

--s3-endpoint <endpoint>

S3 endpoint for accessing the job binary URL (ignored if binary not in S3

--public

Make the job binary public (visible from other projects)

--private

Make the job binary private (visible only from this project)

--protected

Make the job binary protected

--unprotected

Make the job binary unprotected

--json <filename>

Json representation of the update object. other arguments will not be taken into account if this one is provided

Expand
Table 26.153. Output Formatters
ValueSummary

-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

Expand
Table 26.154. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.155. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.156. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.33. dataprocessing job delete

Usage:

openstack dataprocessing job delete [-h] [--wait] <job> [<job> ...]

Deletes job

Expand
Table 26.157. Positional Arguments
ValueSummary

<job>

Id(s) of the job(s) to delete

Expand
Table 26.158. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for the job(s) delete to complete

This command is provided by the python-saharaclient plugin.

26.34. dataprocessing job execute

Usage:

openstack dataprocessing job execute [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--job-template <job-template>]
                                          [--cluster <cluster>]
                                          [--input <input>]
                                          [--output <output>]
                                          [--params <name:value> [<name:value> ...]]
                                          [--args <argument> [<argument> ...]]
                                          [--public] [--protected]
                                          [--config-json <filename> | --configs <name:value> [<name:value> ...]]
                                          [--interface <filename>]
                                          [--json <filename>]

Executes job

Expand
Table 26.159. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--job-template <job-template>

Name or ID of the job template [REQUIRED if JSON is not provided]

--cluster <cluster>

Name or id of the cluster [required if json is not provided]

--input <input>

Name or id of the input data source

--output <output>

Name or id of the output data source

--params <name:value> [<name:value> …​]

Parameters to add to the job

--args <argument> [<argument> …​]

Arguments to add to the job

--public

Make the job public

--protected

Make the job protected

--config-json <filename>

JSON representation of the job configs

--configs <name:value> [<name:value> …​]

Configs to add to the job

--interface <filename>

JSON representation of the interface

--json <filename>

Json representation of the job. other arguments will not be taken into account if this one is provided

Expand
Table 26.160. Output Formatters
ValueSummary

-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

Expand
Table 26.161. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.162. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.163. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.35. dataprocessing job list

Usage:

openstack dataprocessing job list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN] [--long]
                                       [--status <status>]

Lists jobs

Expand
Table 26.164. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--status <status>

List jobs with specific status

Expand
Table 26.165. Output Formatters
ValueSummary

-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

Expand
Table 26.166. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.167. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.168. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.36. dataprocessing job show

Usage:

openstack dataprocessing job show [-h]

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

Display job details

Expand
Table 26.169. Positional Arguments
ValueSummary

<job>

Id of the job to display

Expand
Table 26.170. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.171. Output Formatters
ValueSummary

-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

Expand
Table 26.172. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.173. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.174. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.37. dataprocessing job template create

Usage:

openstack dataprocessing job template create [-h]

                                                  [-f {json,shell,table,value,yaml}]
                                                  [-c COLUMN]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]
                                                  [--noindent]
                                                  [--prefix PREFIX]
                                                  [--name <name>]
                                                  [--type <type>]
                                                  [--mains <main> [<main> ...]]
                                                  [--libs <lib> [<lib> ...]]
                                                  [--description <description>]
                                                  [--public] [--protected]
                                                  [--interface <filename>]
                                                  [--json <filename>]

Creates job template

Expand
Table 26.175. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the job template [required if json is not provided]

--type <type>

Type of the job (hive, java, mapreduce, storm, Storm.Pyleus, Pig, Shell, MapReduce.Streaming, Spark) [REQUIRED if JSON is not provided]

--mains <main> [<main> …​]

Name(s) or ID(s) for job’s main job binary(s)

--libs <lib> [<lib> …​]

Name(s) or ID(s) for job’s lib job binary(s)

--description <description>

Description of the job template

--public

Make the job template public

--protected

Make the job template protected

--interface <filename>

JSON representation of the interface

--json <filename>

Json representation of the job template

Expand
Table 26.176. Output Formatters
ValueSummary

-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

Expand
Table 26.177. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.178. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.179. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.38. dataprocessing job template delete

Usage:

openstack dataprocessing job template delete [-h]

                                                  <job-template>
                                                  [<job-template> ...]

Deletes job template

Expand
Table 26.180. Positional Arguments
ValueSummary

<job-template>

Name(s) or id(s) of the job template(s) to delete

Expand
Table 26.181. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-saharaclient plugin.

26.39. dataprocessing job template list

Usage:

openstack dataprocessing job template list [-h]

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

Lists job templates

Expand
Table 26.182. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--type <type>

List job templates of specific type

--name <name-substring>

List job templates with specific substring in the name

Expand
Table 26.183. Output Formatters
ValueSummary

-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

Expand
Table 26.184. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.185. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.186. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.40. dataprocessing job template show

Usage:

openstack dataprocessing job template show [-h]

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

Display job template details

Expand
Table 26.187. Positional Arguments
ValueSummary

<job-template>

Name or id of the job template to display

Expand
Table 26.188. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.189. Output Formatters
ValueSummary

-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

Expand
Table 26.190. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.191. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.192. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.41. dataprocessing job template update

Usage:

openstack dataprocessing job template update [-h]

                                                  [-f {json,shell,table,value,yaml}]
                                                  [-c COLUMN]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]
                                                  [--noindent]
                                                  [--prefix PREFIX]
                                                  [--name <name>]
                                                  [--description <description>]
                                                  [--public | --private]
                                                  [--protected | --unprotected]
                                                  <job-template>

Updates job template

Expand
Table 26.193. Positional Arguments
ValueSummary

<job-template>

Name or id of the job template

Expand
Table 26.194. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New name of the job template

--description <description>

Description of the job template

--public

Make the job template public (visible from other projects)

--private

Make the job_template private (visible only from this tenant)

--protected

Make the job template protected

--unprotected

Make the job template unprotected

Expand
Table 26.195. Output Formatters
ValueSummary

-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

Expand
Table 26.196. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.197. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.198. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.42. dataprocessing job type configs get

Usage:

openstack dataprocessing job type configs get [-h] [--file <file>]

                                                   <job-type>

Get job type configs

Expand
Table 26.199. Positional Arguments
ValueSummary

<job-type>

Type of the job to provide config information about

Expand
Table 26.200. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <file>

Destination file (defaults to job type)

This command is provided by the python-saharaclient plugin.

26.43. dataprocessing job type list

Usage:

openstack dataprocessing job type list [-h]

                                            [-f {csv,json,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent]
                                            [--quote {all,minimal,none,nonnumeric}]
                                            [--sort-column SORT_COLUMN]
                                            [--type <type>]
                                            [--plugin <plugin>]
                                            [--plugin-version <plugin_version>]

Lists job types supported by plugins

Expand
Table 26.201. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type <type>

Get information about specific job type

--plugin <plugin>

Get only job types supported by this plugin

--plugin-version <plugin_version>

Get only job types supported by specific version of the plugin. This parameter will be taken into account only if plugin is provided

Expand
Table 26.202. Output Formatters
ValueSummary

-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

Expand
Table 26.203. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.204. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.205. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.44. dataprocessing job update

Usage:

openstack dataprocessing job update [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--public | --private]
                                         [--protected | --unprotected]
                                         <job>

Updates job

Expand
Table 26.206. Positional Arguments
ValueSummary

<job>

Id of the job to update

Expand
Table 26.207. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--public

Make the job public (visible from other projects)

--private

Make the job private (visible only from this project)

--protected

Make the job protected

--unprotected

Make the job unprotected

Expand
Table 26.208. Output Formatters
ValueSummary

-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

Expand
Table 26.209. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.210. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.211. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.45. dataprocessing node group template create

Usage:

openstack dataprocessing node group template create [-h]

                                                         [-f {json,shell,table,value,yaml}]
                                                         [-c COLUMN]
                                                         [--max-width <integer>]
                                                         [--fit-width]
                                                         [--print-empty]
                                                         [--noindent]
                                                         [--prefix PREFIX]
                                                         [--name <name>]
                                                         [--plugin <plugin>]
                                                         [--plugin-version <plugin_version>]
                                                         [--processes <processes> [<processes> ...]]
                                                         [--flavor <flavor>]
                                                         [--security-groups <security-groups> [<security-groups> ...]]
                                                         [--auto-security-group]
                                                         [--availability-zone <availability-zone>]
                                                         [--floating-ip-pool <floating-ip-pool>]
                                                         [--volumes-per-node <volumes-per-node>]
                                                         [--volumes-size <volumes-size>]
                                                         [--volumes-type <volumes-type>]
                                                         [--volumes-availability-zone <volumes-availability-zone>]
                                                         [--volumes-mount-prefix <volumes-mount-prefix>]
                                                         [--volumes-locality]
                                                         [--description <description>]
                                                         [--autoconfig]
                                                         [--proxy-gateway]
                                                         [--public]
                                                         [--protected]
                                                         [--json <filename>]
                                                         [--shares <filename>]
                                                         [--configs <filename>]

Creates node group template

Expand
Table 26.212. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the node group template [required if json is not provided]

--plugin <plugin>

Name of the plugin [required if json is not provided]

--plugin-version <plugin_version>

Version of the plugin [REQUIRED if JSON is not provided]

--processes <processes> [<processes> …​]

List of the processes that will be launched on each instance [REQUIRED if JSON is not provided]

--flavor <flavor>

Name or id of the flavor [required if json is not provided]

--security-groups <security-groups> [<security-groups> …​]

List of the security groups for the instances in this node group

--auto-security-group

Indicates if an additional security group should be created for the node group

--availability-zone <availability-zone>

Name of the availability zone where instances will be created

--floating-ip-pool <floating-ip-pool>

ID of the floating IP pool

--volumes-per-node <volumes-per-node>

Number of volumes attached to every node

--volumes-size <volumes-size>

Size of volumes attached to node (GB). This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-type <volumes-type>

Type of the volumes. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-availability-zone <volumes-availability-zone>

Name of the availability zone where volumes will be created. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-mount-prefix <volumes-mount-prefix>

Prefix for mount point directory. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-locality

If enabled, instance and attached volumes will be created on the same physical host. This parameter will be taken into account only if volumes-per-node is set and non-zero

--description <description>

Description of the node group template

--autoconfig

If enabled, instances of the node group will be automatically configured

--proxy-gateway

If enabled, instances of the node group will be used to access other instances in the cluster

--public

Make the node group template public (visible from other projects)

--protected

Make the node group template protected

--json <filename>

Json representation of the node group template. other arguments will not be taken into account if this one is provided

--shares <filename>

Json representation of the manila shares

--configs <filename>

Json representation of the node group template configs

Expand
Table 26.213. Output Formatters
ValueSummary

-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

Expand
Table 26.214. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.215. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.216. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.46. dataprocessing node group template delete

Usage:

openstack dataprocessing node group template delete [-h]


                                                         <node-group-template>
                                                         [<node-group-template> ...]

Deletes node group template

Expand
Table 26.217. Positional Arguments
ValueSummary

<node-group-template>

Name(s) or id(s) of the node group template(s) to delete

Expand
Table 26.218. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-saharaclient plugin.

26.47. dataprocessing node group template export

Usage:

openstack dataprocessing node group template export [-h]

                                                         [--file <filename>]

                                                         <node-group-template>

Export node group template to JSON

Expand
Table 26.219. Positional Arguments
ValueSummary

<node-group-template>

Name or id of the node group template to export

Expand
Table 26.220. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <filename>

Name of the file node group template should be exported to.If not provided, print to stdout

This command is provided by the python-saharaclient plugin.

26.48. dataprocessing node group template import

Usage:

openstack dataprocessing node group template import [-h]

                                                         [-f {json,shell,table,value,yaml}]
                                                         [-c COLUMN]
                                                         [--max-width <integer>]
                                                         [--fit-width]
                                                         [--print-empty]
                                                         [--noindent]
                                                         [--prefix PREFIX]
                                                         [--name <name>]
                                                         [--security_groups <security_groups>]
                                                         [--floating_ip_pool <floating_ip_pool>]
                                                         --image_id
                                                         <image_id>
                                                         --flavor_id
                                                         <flavor_id>
                                                         <json>

Imports node group template

Expand
Table 26.221. Positional Arguments
ValueSummary

<json>

Json containing node group template

Expand
Table 26.222. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the node group template

--security_groups <security_groups>

Security groups of the node group template

--floating_ip_pool <floating_ip_pool>

Floating IP pool of the node group template

--image_id <image_id>

Image ID of the node group template

--flavor_id <flavor_id>

Flavor ID of the node group template

Expand
Table 26.223. Output Formatters
ValueSummary

-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

Expand
Table 26.224. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.225. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.226. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.49. dataprocessing node group template list

Usage:

openstack dataprocessing node group template list [-h]

                                                       [-f {csv,json,table,value,yaml}]
                                                       [-c COLUMN]
                                                       [--max-width <integer>]
                                                       [--fit-width]
                                                       [--print-empty]
                                                       [--noindent]
                                                       [--quote {all,minimal,none,nonnumeric}]
                                                       [--sort-column SORT_COLUMN]
                                                       [--long]
                                                       [--plugin <plugin>]
                                                       [--plugin-version <plugin_version>]
                                                       [--name <name-substring>]

Lists node group templates

Expand
Table 26.227. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--plugin <plugin>

List node group templates for specific plugin

--plugin-version <plugin_version>

List node group templates with specific version of the plugin

--name <name-substring>

List node group templates with specific substring in the name

Expand
Table 26.228. Output Formatters
ValueSummary

-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

Expand
Table 26.229. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.230. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.231. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.50. dataprocessing node group template show

Usage:

openstack dataprocessing node group template show [-h]

                                                       [-f {json,shell,table,value,yaml}]
                                                       [-c COLUMN]
                                                       [--max-width <integer>]
                                                       [--fit-width]
                                                       [--print-empty]
                                                       [--noindent]
                                                       [--prefix PREFIX]
                                                       <node-group-template>

Display node group template details

Expand
Table 26.232. Positional Arguments
ValueSummary

<node-group-template>

Name or id of the node group template to display

Expand
Table 26.233. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.234. Output Formatters
ValueSummary

-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

Expand
Table 26.235. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.236. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.237. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.51. dataprocessing node group template update

Usage:

openstack dataprocessing node group template update [-h]

                                                         [-f {json,shell,table,value,yaml}]
                                                         [-c COLUMN]
                                                         [--max-width <integer>]
                                                         [--fit-width]
                                                         [--print-empty]
                                                         [--noindent]
                                                         [--prefix PREFIX]
                                                         [--name <name>]
                                                         [--plugin <plugin>]
                                                         [--plugin-version <plugin_version>]
                                                         [--processes <processes> [<processes> ...]]
                                                         [--security-groups <security-groups> [<security-groups> ...]]
                                                         [--auto-security-group-enable | --auto-security-group-disable]
                                                         [--availability-zone <availability-zone>]
                                                         [--flavor <flavor>]
                                                         [--floating-ip-pool <floating-ip-pool>]
                                                         [--volumes-per-node <volumes-per-node>]
                                                         [--volumes-size <volumes-size>]
                                                         [--volumes-type <volumes-type>]
                                                         [--volumes-availability-zone <volumes-availability-zone>]
                                                         [--volumes-mount-prefix <volumes-mount-prefix>]
                                                         [--volumes-locality-enable | --volumes-locality-disable]
                                                         [--description <description>]
                                                         [--autoconfig-enable | --autoconfig-disable]
                                                         [--proxy-gateway-enable | --proxy-gateway-disable]
                                                         [--public | --private]
                                                         [--protected | --unprotected]
                                                         [--json <filename>]
                                                         [--shares <filename>]
                                                         [--configs <filename>]

                                                         <node-group-template>

Updates node group template

Expand
Table 26.238. Positional Arguments
ValueSummary

<node-group-template>

Name or ID of the node group template

Expand
Table 26.239. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New name of the node group template

--plugin <plugin>

Name of the plugin

--plugin-version <plugin_version>

Version of the plugin

--processes <processes> [<processes> …​]

List of the processes that will be launched on each instance

--security-groups <security-groups> [<security-groups> …​]

List of the security groups for the instances in this node group

--auto-security-group-enable

Additional security group should be created for the node group

--auto-security-group-disable

Additional security group should not be created for the node group

--availability-zone <availability-zone>

Name of the availability zone where instances will be created

--flavor <flavor>

Name or id of the flavor

--floating-ip-pool <floating-ip-pool>

ID of the floating IP pool

--volumes-per-node <volumes-per-node>

Number of volumes attached to every node

--volumes-size <volumes-size>

Size of volumes attached to node (GB). This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-type <volumes-type>

Type of the volumes. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-availability-zone <volumes-availability-zone>

Name of the availability zone where volumes will be created. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-mount-prefix <volumes-mount-prefix>

Prefix for mount point directory. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-locality-enable

Instance and attached volumes will be created on the same physical host. This parameter will be taken into account only if volumes-per-node is set and non-zero

--volumes-locality-disable

Instance and attached volumes creation on the same physical host will not be regulated. This parameter will be takeninto account only if volumes-per-node is set and non-zero

--description <description>

Description of the node group template

--autoconfig-enable

Instances of the node group will be automatically configured

--autoconfig-disable

Instances of the node group will not be automatically configured

--proxy-gateway-enable

Instances of the node group will be used to access other instances in the cluster

--proxy-gateway-disable

Instances of the node group will not be used to access other instances in the cluster

--public

Make the node group template public (visible from other projects)

--private

Make the node group template private (visible only from this project)

--protected

Make the node group template protected

--unprotected

Make the node group template unprotected

--json <filename>

Json representation of the node group template update fields. Other arguments will not be taken into account if this one is provided

--shares <filename>

Json representation of the manila shares

--configs <filename>

Json representation of the node group template configs

Expand
Table 26.240. Output Formatters
ValueSummary

-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

Expand
Table 26.241. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.242. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.243. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.52. dataprocessing plugin configs get

Usage:

openstack dataprocessing plugin configs get [-h] [--file <file>]

                                                 <plugin> <plugin_version>

Get plugin configs

Expand
Table 26.244. Positional Arguments
ValueSummary

<plugin>

Name of the plugin to provide config information about

<plugin_version>

Version of the plugin to provide config information about

Expand
Table 26.245. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <file>

Destination file (defaults to a combination of plugin name and plugin version)

This command is provided by the python-saharaclient plugin.

26.53. dataprocessing plugin list

Usage:

openstack dataprocessing plugin list [-h]

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

Lists plugins

Expand
Table 26.246. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 26.247. Output Formatters
ValueSummary

-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

Expand
Table 26.248. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.249. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.250. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-saharaclient plugin.

26.54. dataprocessing plugin show

Usage:

openstack dataprocessing plugin show [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--plugin-version <plugin_version>]
                                          <plugin>

Display plugin details

Expand
Table 26.251. Positional Arguments
ValueSummary

<plugin>

Name of the plugin to display

Expand
Table 26.252. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--plugin-version <plugin_version>

Version of the plugin to display

Expand
Table 26.253. Output Formatters
ValueSummary

-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

Expand
Table 26.254. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.255. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.256. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

26.55. dataprocessing plugin update

Usage:

openstack dataprocessing plugin update [-h]

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

Expand
Table 26.257. Positional Arguments
ValueSummary

<plugin>

Name of the plugin to provide config information about

<json>

Json representation of the plugin update dictionary

Expand
Table 26.258. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 26.259. Output Formatters
ValueSummary

-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

Expand
Table 26.260. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 26.261. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 26.262. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-saharaclient plugin.

Chapter 27. datastore

This chapter describes the commands under the datastore command.

27.1. datastore list

Usage:

openstack datastore list [-h] [-f {csv,json,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--sort-column SORT_COLUMN]

List available datastores

Expand
Table 27.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 27.2. Output Formatters
ValueSummary

-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

Expand
Table 27.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 27.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 27.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

27.2. datastore show

Usage:

openstack datastore show [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              <datastore>

Shows details of a datastore

Expand
Table 27.6. Positional Arguments
ValueSummary

<datastore>

Id of the datastore

Expand
Table 27.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 27.8. Output Formatters
ValueSummary

-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

Expand
Table 27.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 27.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 27.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

27.3. datastore version list

Usage:

openstack datastore version list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      <datastore>

Lists available versions for a datastore

Expand
Table 27.12. Positional Arguments
ValueSummary

<datastore>

Id or name of the datastore

Expand
Table 27.13. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 27.14. Output Formatters
ValueSummary

-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

Expand
Table 27.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 27.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 27.17. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-troveclient plugin.

27.4. datastore version show

Usage:

openstack datastore version show [-h]

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

Shows details of a datastore version.

Expand
Table 27.18. Positional Arguments
ValueSummary

<datastore_version>

Id or name of the datastore version.

Expand
Table 27.19. Optional Arguments
ValueSummary

-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.

Expand
Table 27.20. Output Formatters
ValueSummary

-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

Expand
Table 27.21. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 27.22. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 27.23. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-troveclient plugin.

Chapter 28. dns

This chapter describes the commands under the dns command.

28.1. dns quota list

Usage:

openstack dns quota list [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX] [--all-projects]
                              [--edit-managed]
                              [--sudo-project-id SUDO_PROJECT_ID]
                              [--project-id PROJECT_ID]

List quotas

Expand
Table 28.1. Optional Arguments
ValueSummary

-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

Expand
Table 28.2. Output Formatters
ValueSummary

-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

Expand
Table 28.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 28.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 28.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

28.2. dns quota reset

Usage:

openstack dns quota reset [-h] [--all-projects] [--edit-managed]

                               [--sudo-project-id SUDO_PROJECT_ID]
                               [--project-id PROJECT_ID]

Reset quotas

Expand
Table 28.6. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

28.3. dns quota set

Usage:

openstack dns quota set [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--all-projects]
                             [--edit-managed]
                             [--sudo-project-id SUDO_PROJECT_ID]
                             [--project-id PROJECT_ID]
                             [--api-export-size <api-export-size>]
                             [--zones <zones>]
                             [--recordset-records <recordset-records>]
                             [--zone-records <zone-records>]
                             [--zone-recordsets <zone-recordsets>]

Set quotas

Expand
Table 28.7. Optional Arguments
ValueSummary

-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

--zones <zones>

New value for the zones 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

Expand
Table 28.8. Output Formatters
ValueSummary

-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

Expand
Table 28.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 28.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 28.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

28.4. dns service list

Usage:

openstack dns service list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                [--hostname HOSTNAME]
                                [--service_name SERVICE_NAME]
                                [--status STATUS] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]

List service statuses

Expand
Table 28.12. Optional Arguments
ValueSummary

-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

Expand
Table 28.13. Output Formatters
ValueSummary

-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

Expand
Table 28.14. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 28.15. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 28.16. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

28.5. dns service show

Usage:

openstack dns service show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]
                                id

Show service status details

Expand
Table 28.17. Positional Arguments
ValueSummary

id

Service status id

Expand
Table 28.18. Optional Arguments
ValueSummary

-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

Expand
Table 28.19. Output Formatters
ValueSummary

-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

Expand
Table 28.20. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 28.21. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 28.22. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

Chapter 29. ec2

This chapter describes the commands under the ec2 command.

29.1. ec2 credentials create

Usage:

openstack ec2 credentials create [-h]

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

Create EC2 credentials

Expand
Table 29.1. Optional Arguments
ValueSummary

-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)

Expand
Table 29.2. Output Formatters
ValueSummary

-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

Expand
Table 29.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 29.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 29.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

29.2. ec2 credentials delete

Usage:

openstack ec2 credentials delete [-h] [--user <user>]

                                      <access-key> [<access-key> ...]

Delete EC2 credentials

Expand
Table 29.6. Positional Arguments
ValueSummary

<access-key>

Credentials access key(s)

Expand
Table 29.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--user <user>

Delete credentials for user (name or id)

29.3. ec2 credentials list

Usage:

openstack ec2 credentials list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--user <user>]

List EC2 credentials

Expand
Table 29.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--user <user>

Filter list by user (name or id)

Expand
Table 29.9. Output Formatters
ValueSummary

-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

Expand
Table 29.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 29.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 29.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

29.4. ec2 credentials show

Usage:

openstack ec2 credentials show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--user <user>]
                                    <access-key>

Display EC2 credentials details

Expand
Table 29.13. Positional Arguments
ValueSummary

<access-key>

Credentials access key

Expand
Table 29.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--user <user>

Show credentials for user (name or id)

Expand
Table 29.15. Output Formatters
ValueSummary

-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

Expand
Table 29.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 29.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 29.18. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 30. endpoint

This chapter describes the commands under the endpoint command.

30.1. endpoint create

Usage:

openstack endpoint create [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] --publicurl <url>
                               [--adminurl <url>] [--internalurl <url>]
                               [--region <region-id>]
                               <service>

Create new endpoint

Expand
Table 30.1. Positional Arguments
ValueSummary

<service>

Service to be associated with new endpoint (name or ID)

Expand
Table 30.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--publicurl <url>

New endpoint public url (required)

--adminurl <url>

New endpoint admin url

--internalurl <url>

New endpoint internal url

--region <region-id>

New endpoint region id

Expand
Table 30.3. Output Formatters
ValueSummary

-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

Expand
Table 30.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 30.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 30.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

30.2. endpoint delete

Usage:

openstack endpoint delete [-h] <endpoint-id> [<endpoint-id> ...]

Delete endpoint(s)

Expand
Table 30.7. Positional Arguments
ValueSummary

<endpoint-id>

Endpoint(s) to delete (id only)

Expand
Table 30.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

30.3. endpoint list

Usage:

openstack endpoint list [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN] [--long]

List endpoints

Expand
Table 30.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 30.10. Output Formatters
ValueSummary

-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

Expand
Table 30.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 30.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 30.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

30.4. endpoint show

Usage:

openstack endpoint show [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]
                             <endpoint>

Display endpoint details

Expand
Table 30.14. Positional Arguments
ValueSummary

<endpoint>

Endpoint to display (endpoint id, service id, service name, service type)

Expand
Table 30.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 30.16. Output Formatters
ValueSummary

-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

Expand
Table 30.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 30.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 30.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 31. event

This chapter describes the commands under the event command.

31.1. event trigger create

Usage:

openstack event trigger create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--params PARAMS]
                                    name workflow_id exchange topic event
                                    [workflow_input]

Create new trigger.

Expand
Table 31.1. Positional Arguments
ValueSummary

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

Expand
Table 31.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--params PARAMS

Workflow params

Expand
Table 31.3. Output Formatters
ValueSummary

-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

Expand
Table 31.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 31.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 31.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

31.2. event trigger delete

Usage:

openstack event trigger delete [-h]

                                    event_trigger_id [event_trigger_id ...]

Delete trigger.

Expand
Table 31.7. Positional Arguments
ValueSummary

event_trigger_id

Id of event trigger(s).

Expand
Table 31.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

31.3. event trigger list

Usage:

openstack event trigger list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]

List all event triggers.

Expand
Table 31.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 31.10. Output Formatters
ValueSummary

-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

Expand
Table 31.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 31.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 31.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

31.4. event trigger show

Usage:

openstack event trigger show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  event_trigger

Show specific event trigger.

Expand
Table 31.14. Positional Arguments
ValueSummary

event_trigger

Event trigger id

Expand
Table 31.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 31.16. Output Formatters
ValueSummary

-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

Expand
Table 31.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 31.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 31.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 32. extension

This chapter describes the commands under the extension command.

32.1. extension list

Usage:

openstack extension list [-h] [-f {csv,json,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--sort-column SORT_COLUMN] [--compute]
                              [--identity] [--network] [--volume] [--long]

List API extensions

Expand
Table 32.1. Optional Arguments
ValueSummary

-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

Expand
Table 32.2. Output Formatters
ValueSummary

-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

Expand
Table 32.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 32.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 32.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

32.2. extension show

Usage:

openstack extension show [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              <extension>

Show API extension

Expand
Table 32.6. Positional Arguments
ValueSummary

<extension>

Extension to display. currently, only network extensions are supported. (Name or Alias)

Expand
Table 32.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 32.8. Output Formatters
ValueSummary

-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

Expand
Table 32.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 32.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 32.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 33. firewall

This chapter describes the commands under the firewall command.

33.1. firewall group create

Usage:

openstack firewall group create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--name NAME]
                                     [--description <description>]
                                     [--ingress-firewall-policy <ingress-firewall-policy> | --no-ingress-firewall-policy]
                                     [--egress-firewall-policy <egress-firewall-policy> | --no-egress-firewall-policy]
                                     [--public | --private | --share | --no-share]
                                     [--enable | --disable]
                                     [--project <project>]
                                     [--project-domain <project-domain>]
                                     [--port <port> | --no-port]

Create a new firewall group

Expand
Table 33.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Name for the firewall group

--description <description>

Description of the firewall group

--ingress-firewall-policy <ingress-firewall-policy>

Ingress firewall policy (name or ID)

--no-ingress-firewall-policy

Detach ingress firewall policy from the firewall group

--egress-firewall-policy <egress-firewall-policy>

Egress firewall policy (name or ID)

--no-egress-firewall-policy

Detach egress firewall policy from the firewall group

--public

Make the firewall group public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project). This option is deprecated and would be removed in R release.

--private

Restrict use of the firewall group to the current project. This option is deprecated and would be removed in R release.

--share

Share the firewall group to be used in all projects (by default, it is restricted to be used by the current project).

--no-share

Restrict use of the firewall group to the current project

--enable

Enable firewall group

--disable

Disable firewall group

--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.

--port <port>

Port(s) (name or id) to apply firewall group. this option can be repeated

--no-port

Detach all port from the firewall group

Expand
Table 33.2. Output Formatters
ValueSummary

-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

Expand
Table 33.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

33.2. firewall group delete

Usage:

openstack firewall group delete [-h]

                                     <firewall-group> [<firewall-group> ...]

Delete firewall group(s)

Expand
Table 33.6. Positional Arguments
ValueSummary

<firewall-group>

Firewall group(s) to delete (name or id)

Expand
Table 33.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

33.3. firewall group list

Usage:

openstack firewall group list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN] [--long]

List firewall groups

Expand
Table 33.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 33.9. Output Formatters
ValueSummary

-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

Expand
Table 33.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

33.4. firewall group policy add rule

Usage:

openstack firewall group policy add rule [-h]

                                              [--insert-before <firewall-rule>]
                                              [--insert-after <firewall-rule>]
                                              <firewall-policy>
                                              <firewall-rule>

Insert a rule into a given firewall policy

Expand
Table 33.13. Positional Arguments
ValueSummary

<firewall-policy>

Firewall policy to insert rule (name or id)

<firewall-rule>

Firewall rule to be inserted (name or id)

Expand
Table 33.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--insert-before <firewall-rule>

Insert the new rule before this existing rule (name or ID)

--insert-after <firewall-rule>

Insert the new rule after this existing rule (name or ID)

This command is provided by the python-neutronclient plugin.

33.5. firewall group policy create

Usage:

openstack firewall group policy create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--description DESCRIPTION]
                                            [--audited | --no-audited]
                                            [--share | --public | --private | --no-share]
                                            [--project <project>]
                                            [--project-domain <project-domain>]
                                            [--firewall-rule <firewall-rule> | --no-firewall-rule]
                                            <name>

Create a new firewall policy

Expand
Table 33.15. Positional Arguments
ValueSummary

<name>

Name for the firewall policy

Expand
Table 33.16. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description DESCRIPTION

Description of the firewall policy

--audited

Enable auditing for the policy

--no-audited

Disable auditing for the policy

--share

Share the firewall policy to be used in all projects (by default, it is restricted to be used by the current project).

--public

Make the firewall policy public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project.) This option is deprecated and would be removed in R release.

--private

Restrict use of the firewall policy to the current project.This option is deprecated and would be removed in R release.

--no-share

Restrict use of the firewall policy to the current project

--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.

--firewall-rule <firewall-rule>

Firewall rule(s) to apply (name or ID)

--no-firewall-rule

Unset all firewall rules from firewall policy

Expand
Table 33.17. Output Formatters
ValueSummary

-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

Expand
Table 33.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.20. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

33.6. firewall group policy delete

Usage:

openstack firewall group policy delete [-h]

                                            <firewall-policy>
                                            [<firewall-policy> ...]

Delete firewall policy(s)

Expand
Table 33.21. Positional Arguments
ValueSummary

<firewall-policy>

Firewall policy(s) to delete (name or id)

Expand
Table 33.22. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

33.7. firewall group policy list

Usage:

openstack firewall group policy list [-h]

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

List firewall policies

Expand
Table 33.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 33.24. Output Formatters
ValueSummary

-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

Expand
Table 33.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.27. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

33.8. firewall group policy remove rule

Usage:

openstack firewall group policy remove rule [-h]

                                                 <firewall-policy>
                                                 <firewall-rule>

Remove a rule from a given firewall policy

Expand
Table 33.28. Positional Arguments
ValueSummary

<firewall-policy>

Firewall policy to remove rule (name or id)

<firewall-rule>

Firewall rule to remove from policy (name or id)

Expand
Table 33.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

33.9. firewall group policy set

Usage:

openstack firewall group policy set [-h] [--description DESCRIPTION]

                                         [--audited | --no-audited]
                                         [--share | --public | --private | --no-share]
                                         [--name <name>]
                                         [--firewall-rule <firewall-rule>]
                                         [--no-firewall-rule]
                                         <firewall-policy>

Set firewall policy properties

Expand
Table 33.30. Positional Arguments
ValueSummary

<firewall-policy>

Firewall policy to update (name or id)

Expand
Table 33.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description DESCRIPTION

Description of the firewall policy

--audited

Enable auditing for the policy

--no-audited

Disable auditing for the policy

--share

Share the firewall policy to be used in all projects (by default, it is restricted to be used by the current project).

--public

Make the firewall policy public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project.) This option is deprecated and would be removed in R release.

--private

Restrict use of the firewall policy to the current project.This option is deprecated and would be removed in R release.

--no-share

Restrict use of the firewall policy to the current project

--name <name>

Name for the firewall policy

--firewall-rule <firewall-rule>

Firewall rule(s) to apply (name or ID)

--no-firewall-rule

Remove all firewall rules from firewall policy

This command is provided by the python-neutronclient plugin.

33.10. firewall group policy show

Usage:

openstack firewall group policy show [-h]

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

Display firewall policy details

Expand
Table 33.32. Positional Arguments
ValueSummary

<firewall-policy>

Firewall policy to show (name or id)

Expand
Table 33.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 33.34. Output Formatters
ValueSummary

-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

Expand
Table 33.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.37. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

33.11. firewall group policy unset

Usage:

openstack firewall group policy unset [-h]

                                           [--firewall-rule <firewall-rule> | --all-firewall-rule]
                                           [--audited] [--share] [--public]
                                           <firewall-policy>

Unset firewall policy properties

Expand
Table 33.38. Positional Arguments
ValueSummary

<firewall-policy>

Firewall policy to unset (name or id)

Expand
Table 33.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--firewall-rule <firewall-rule>

Remove firewall rule(s) from the firewall policy (name or ID)

--all-firewall-rule

Remove all firewall rules from the firewall policy

--audited

Disable auditing for the policy

--share

Restrict use of the firewall policy to the current project

--public

Restrict use of the firewall policy to the current project. This option is deprecated and would be removed in R release.

This command is provided by the python-neutronclient plugin.

33.12. firewall group rule create

Usage:

openstack firewall group rule create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--name <name>]
                                          [--description <description>]
                                          [--protocol {tcp,udp,icmp,any}]
                                          [--action {allow,deny,reject}]
                                          [--ip-version <ip-version>]
                                          [--source-ip-address <source-ip-address> | --no-source-ip-address]
                                          [--destination-ip-address <destination-ip-address> | --no-destination-ip-address]
                                          [--source-port <source-port> | --no-source-port]
                                          [--destination-port <destination-port> | --no-destination-port]
                                          [--public | --private | --share | --no-share]
                                          [--enable-rule | --disable-rule]
                                          [--project <project>]
                                          [--project-domain <project-domain>]

Create a new firewall rule

Expand
Table 33.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the firewall rule

--description <description>

Description of the firewall rule

--protocol {tcp,udp,icmp,any}

Protocol for the firewall rule

--action {allow,deny,reject}

Action for the firewall rule

--ip-version <ip-version>

Set IP version 4 or 6 (default is 4)

--source-ip-address <source-ip-address>

Source IP address or subnet

--no-source-ip-address

Detach source IP address

--destination-ip-address <destination-ip-address>

Destination IP address or subnet

--no-destination-ip-address

Detach destination IP address

--source-port <source-port>

Source port number or range(integer in [1, 65535] or range like 123:456)

--no-source-port

Detach source port number or range

--destination-port <destination-port>

Destination port number or range(integer in [1, 65535] or range like 123:456)

--no-destination-port

Detach destination port number or range

--public

Make the firewall policy public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project). This option is deprecated and would be removed in R Release

--private

Restrict use of the firewall rule to the current project.This option is deprecated and would be removed in R release.

--share

Share the firewall rule to be used in all projects (by default, it is restricted to be used by the current project).

--no-share

Restrict use of the firewall rule to the current project

--enable-rule

Enable this rule (default is enabled)

--disable-rule

Disable this rule

--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.

Expand
Table 33.41. Output Formatters
ValueSummary

-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

Expand
Table 33.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.44. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

33.13. firewall group rule delete

Usage:

openstack firewall group rule delete [-h]

                                          <firewall-rule>
                                          [<firewall-rule> ...]

Delete firewall rule(s)

Expand
Table 33.45. Positional Arguments
ValueSummary

<firewall-rule>

Firewall rule(s) to delete (name or id)

Expand
Table 33.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

33.14. firewall group rule list

Usage:

openstack firewall group rule list [-h]

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

List firewall rules that belong to a given tenant

Expand
Table 33.47. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 33.48. Output Formatters
ValueSummary

-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

Expand
Table 33.49. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.50. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.51. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

33.15. firewall group rule set

Usage:

openstack firewall group rule set [-h] [--name <name>]

                                       [--description <description>]
                                       [--protocol {tcp,udp,icmp,any}]
                                       [--action {allow,deny,reject}]
                                       [--ip-version <ip-version>]
                                       [--source-ip-address <source-ip-address> | --no-source-ip-address]
                                       [--destination-ip-address <destination-ip-address> | --no-destination-ip-address]
                                       [--source-port <source-port> | --no-source-port]
                                       [--destination-port <destination-port> | --no-destination-port]
                                       [--public | --private | --share | --no-share]
                                       [--enable-rule | --disable-rule]
                                       <firewall-rule>

Set firewall rule properties

Expand
Table 33.52. Positional Arguments
ValueSummary

<firewall-rule>

Firewall rule to set (name or id)

Expand
Table 33.53. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the firewall rule

--description <description>

Description of the firewall rule

--protocol {tcp,udp,icmp,any}

Protocol for the firewall rule

--action {allow,deny,reject}

Action for the firewall rule

--ip-version <ip-version>

Set IP version 4 or 6 (default is 4)

--source-ip-address <source-ip-address>

Source IP address or subnet

--no-source-ip-address

Detach source IP address

--destination-ip-address <destination-ip-address>

Destination IP address or subnet

--no-destination-ip-address

Detach destination IP address

--source-port <source-port>

Source port number or range(integer in [1, 65535] or range like 123:456)

--no-source-port

Detach source port number or range

--destination-port <destination-port>

Destination port number or range(integer in [1, 65535] or range like 123:456)

--no-destination-port

Detach destination port number or range

--public

Make the firewall policy public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project). This option is deprecated and would be removed in R Release

--private

Restrict use of the firewall rule to the current project.This option is deprecated and would be removed in R release.

--share

Share the firewall rule to be used in all projects (by default, it is restricted to be used by the current project).

--no-share

Restrict use of the firewall rule to the current project

--enable-rule

Enable this rule (default is enabled)

--disable-rule

Disable this rule

This command is provided by the python-neutronclient plugin.

33.16. firewall group rule show

Usage:

openstack firewall group rule show [-h]

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

Display firewall rule details

Expand
Table 33.54. Positional Arguments
ValueSummary

<firewall-rule>

Firewall rule to display (name or id)

Expand
Table 33.55. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 33.56. Output Formatters
ValueSummary

-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

Expand
Table 33.57. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.58. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.59. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

33.17. firewall group rule unset

Usage:

openstack firewall group rule unset [-h] [--source-ip-address]

                                         [--destination-ip-address]
                                         [--source-port]
                                         [--destination-port] [--share]
                                         [--public] [--enable-rule]
                                         <firewall-rule>

Unset firewall rule properties

Expand
Table 33.60. Positional Arguments
ValueSummary

<firewall-rule>

Firewall rule to unset (name or id)

Expand
Table 33.61. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--source-ip-address

Source ip address or subnet

--destination-ip-address

Destination IP address or subnet

--source-port

Source port number or range(integer in [1, 65535] or range like 123:456)

--destination-port

Destination port number or range(integer in [1, 65535] or range like 123:456)

--share

Restrict use of the firewall rule to the current project

--public

Restrict use of the firewall rule to the current project. This option is deprecated and would be removed in R Release.

--enable-rule

Disable this rule

This command is provided by the python-neutronclient plugin.

33.18. firewall group set

Usage:

openstack firewall group set [-h] [--name NAME]

                                  [--description <description>]
                                  [--ingress-firewall-policy <ingress-firewall-policy> | --no-ingress-firewall-policy]
                                  [--egress-firewall-policy <egress-firewall-policy> | --no-egress-firewall-policy]
                                  [--public | --private | --share | --no-share]
                                  [--enable | --disable] [--port <port>]
                                  [--no-port]
                                  <firewall-group>

Set firewall group properties

Expand
Table 33.62. Positional Arguments
ValueSummary

<firewall-group>

Firewall group to update (name or id)

Expand
Table 33.63. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Name for the firewall group

--description <description>

Description of the firewall group

--ingress-firewall-policy <ingress-firewall-policy>

Ingress firewall policy (name or ID)

--no-ingress-firewall-policy

Detach ingress firewall policy from the firewall group

--egress-firewall-policy <egress-firewall-policy>

Egress firewall policy (name or ID)

--no-egress-firewall-policy

Detach egress firewall policy from the firewall group

--public

Make the firewall group public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project). This option is deprecated and would be removed in R release.

--private

Restrict use of the firewall group to the current project. This option is deprecated and would be removed in R release.

--share

Share the firewall group to be used in all projects (by default, it is restricted to be used by the current project).

--no-share

Restrict use of the firewall group to the current project

--enable

Enable firewall group

--disable

Disable firewall group

--port <port>

Port(s) (name or id) to apply firewall group. this option can be repeated

--no-port

Detach all port from the firewall group

This command is provided by the python-neutronclient plugin.

33.19. firewall group show

Usage:

openstack firewall group show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <firewall-group>

Display firewall group details

Expand
Table 33.64. Positional Arguments
ValueSummary

<firewall-group>

Firewall group to show (name or id)

Expand
Table 33.65. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 33.66. Output Formatters
ValueSummary

-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

Expand
Table 33.67. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 33.68. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 33.69. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

33.20. firewall group unset

Usage:

openstack firewall group unset [-h] [--port <port> | --all-port]

                                    [--ingress-firewall-policy]
                                    [--egress-firewall-policy]
                                    [--public | --share] [--enable]
                                    <firewall-group>

Unset firewall group properties

Expand
Table 33.70. Positional Arguments
ValueSummary

<firewall-group>

Firewall group to unset (name or id)

Expand
Table 33.71. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--port <port>

Port(s) (name or id) to apply firewall group. this option can be repeated

--all-port

Remove all ports for this firewall group

--ingress-firewall-policy

Ingress firewall policy (name or ID) to delete

--egress-firewall-policy

Egress firewall policy (name or ID) to delete

--public

Make the firewall group public, which allows it to be used in all projects (as opposed to the default, which is to restrict its use to the current project). This option is deprecated and would be removed in R release.

--share

Restrict use of the firewall group to the current project

--enable

Disable firewall group

This command is provided by the python-neutronclient plugin.

Chapter 34. flavor

This chapter describes the commands under the flavor command.

34.1. flavor create

Usage:

openstack flavor create [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--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>

Create new flavor

Expand
Table 34.1. Positional Arguments
ValueSummary

<flavor-name>

New flavor name

Expand
Table 34.2. Optional Arguments
ValueSummary

-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.

Expand
Table 34.3. Output Formatters
ValueSummary

-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

Expand
Table 34.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 34.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 34.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

34.2. flavor delete

Usage:

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

Delete flavor(s)

Expand
Table 34.7. Positional Arguments
ValueSummary

<flavor>

Flavor(s) to delete (name or id)

Expand
Table 34.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

34.3. flavor list

Usage:

openstack flavor list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN]
                           [--public | --private | --all] [--long]
                           [--marker <flavor-id>] [--limit <num-flavors>]

List flavors

Expand
Table 34.9. Optional Arguments
ValueSummary

-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

Expand
Table 34.10. Output Formatters
ValueSummary

-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

Expand
Table 34.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 34.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 34.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

34.4. flavor set

Usage:

openstack flavor set [-h] [--no-property] [--property <key=value>]

                          [--project <project>]
                          [--description <description>]
                          [--project-domain <project-domain>]
                          <flavor>

Set flavor properties

Expand
Table 34.14. Positional Arguments
ValueSummary

<flavor>

Flavor to modify (name or id)

Expand
Table 34.15. Optional Arguments
ValueSummary

-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.

34.5. flavor show

Usage:

openstack flavor show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           <flavor>

Display flavor details

Expand
Table 34.16. Positional Arguments
ValueSummary

<flavor>

Flavor to display (name or id)

Expand
Table 34.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 34.18. Output Formatters
ValueSummary

-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

Expand
Table 34.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 34.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 34.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

34.6. flavor unset

Usage:

openstack flavor unset [-h] [--property <key>] [--project <project>]

                            [--project-domain <project-domain>]
                            <flavor>

Unset flavor properties

Expand
Table 34.22. Positional Arguments
ValueSummary

<flavor>

Flavor to modify (name or id)

Expand
Table 34.23. Optional Arguments
ValueSummary

-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 35. floating

This chapter describes the commands under the floating command.

35.1. floating ip create

Usage:

openstack floating ip create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] [--subnet <subnet>]
                                  [--port <port>]
                                  [--floating-ip-address <ip-address>]
                                  [--fixed-ip-address <ip-address>]
                                  [--qos-policy <qos-policy>]
                                  [--description <description>]
                                  [--project <project>]
                                  [--project-domain <project-domain>]
                                  [--tag <tag> | --no-tag]
                                  <network>

Create floating IP

Expand
Table 35.1. Positional Arguments
ValueSummary

<network>

Network to allocate floating ip from (name or id)

Expand
Table 35.2. Optional Arguments
ValueSummary

-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)

--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

Expand
Table 35.3. Output Formatters
ValueSummary

-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

Expand
Table 35.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 35.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 35.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

35.2. floating ip delete

Usage:

openstack floating ip delete [-h] <floating-ip> [<floating-ip> ...]

Delete floating IP(s)

Expand
Table 35.7. Positional Arguments
ValueSummary

<floating-ip>

Floating ip(s) to delete (ip address or id)

Expand
Table 35.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

35.3. floating ip list

Usage:

openstack floating ip list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                [--network <network>] [--port <port>]
                                [--fixed-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>,...]]

List floating IP(s)

Expand
Table 35.9. Optional Arguments
ValueSummary

-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

--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)

Expand
Table 35.10. Output Formatters
ValueSummary

-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

Expand
Table 35.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 35.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 35.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

35.4. floating ip pool list

Usage:

openstack floating ip pool list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]

List pools of floating IP addresses

Expand
Table 35.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 35.15. Output Formatters
ValueSummary

-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

Expand
Table 35.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 35.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 35.18. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

35.5. floating ip set

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>

Set floating IP Properties

Expand
Table 35.19. Positional Arguments
ValueSummary

<floating-ip>

Floating ip to modify (ip address or id)

Expand
Table 35.20. Optional Arguments
ValueSummary

-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

35.6. floating ip show

Usage:

openstack floating ip show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <floating-ip>

Display floating IP details

Expand
Table 35.21. Positional Arguments
ValueSummary

<floating-ip>

Floating ip to display (ip address or id)

Expand
Table 35.22. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 35.23. Output Formatters
ValueSummary

-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

Expand
Table 35.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 35.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 35.26. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

35.7. floating ip unset

Usage:

openstack floating ip unset [-h] [--port] [--qos-policy]

                                 [--tag <tag> | --all-tag]
                                 <floating-ip>

Unset floating IP Properties

Expand
Table 35.27. Positional Arguments
ValueSummary

<floating-ip>

Floating ip to disassociate (ip address or id)

Expand
Table 35.28. Optional Arguments
ValueSummary

-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 36. help.adoc

This chapter describes the commands under the help.adoc command.

36.1. help

Usage:

openstack help [-h] [cmd [cmd ...]]

print detailed help for another command

Expand
Table 36.1. Positional Arguments
ValueSummary

cmd

Name of the command

Expand
Table 36.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the cliff plugin.

Chapter 37. host

This chapter describes the commands under the host command.

37.1. host list

Usage:

openstack host list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--sort-column SORT_COLUMN] [--zone <zone>]

List hosts

Expand
Table 37.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--zone <zone>

Only return hosts in the availability zone

Expand
Table 37.2. Output Formatters
ValueSummary

-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

Expand
Table 37.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 37.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 37.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

37.2. host set

Usage:

openstack host set [-h] [--enable | --disable]

                        [--enable-maintenance | --disable-maintenance]
                        <host>

Set host properties

Expand
Table 37.6. Positional Arguments
ValueSummary

<host>

Host to modify (name only)

Expand
Table 37.7. Optional Arguments
ValueSummary

-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

37.3. host show

Usage:

openstack host show [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--sort-column SORT_COLUMN]
                         <host>

Display host details

Expand
Table 37.8. Positional Arguments
ValueSummary

<host>

Name of host

Expand
Table 37.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 37.10. Output Formatters
ValueSummary

-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

Expand
Table 37.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 37.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 37.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

Chapter 38. hypervisor

This chapter describes the commands under the hypervisor command.

38.1. hypervisor list

Usage:

openstack hypervisor list [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN]
                               [--matching <hostname>] [--long]

List hypervisors

Expand
Table 38.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--matching <hostname>

Filter hypervisors using <hostname> substring

--long

List additional fields in output

Expand
Table 38.2. Output Formatters
ValueSummary

-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

Expand
Table 38.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 38.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 38.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

38.2. hypervisor show

Usage:

openstack hypervisor show [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX]
                               <hypervisor>

Display hypervisor details

Expand
Table 38.6. Positional Arguments
ValueSummary

<hypervisor>

Hypervisor to display (name or id)

Expand
Table 38.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 38.8. Output Formatters
ValueSummary

-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

Expand
Table 38.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 38.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 38.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

38.3. hypervisor stats show

Usage:

openstack hypervisor stats show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]

Display hypervisor stats details

Expand
Table 38.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 38.13. Output Formatters
ValueSummary

-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

Expand
Table 38.14. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 38.15. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 38.16. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 39. image

This chapter describes the commands under the image command.

39.1. image add project

Usage:

openstack image add project [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 [--project-domain <project-domain>]
                                 <image> <project>

Associate project with image

Expand
Table 39.1. Positional Arguments
ValueSummary

<image>

Image to share (name or id)

<project>

Project to associate with image (name or id)

Expand
Table 39.2. Optional Arguments
ValueSummary

-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.

Expand
Table 39.3. Output Formatters
ValueSummary

-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

Expand
Table 39.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 39.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 39.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

39.2. image create

Usage:

openstack image create [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--id <id>]
                            [--container-format <container-format>]
                            [--disk-format <disk-format>]
                            [--min-disk <disk-gb>] [--min-ram <ram-mb>]
                            [--file <file> | --volume <volume>] [--force]
                            [--protected | --unprotected]
                            [--public | --private | --community | --shared]
                            [--property <key=value>] [--tag <tag>]
                            [--project <project>]
                            [--project-domain <project-domain>]
                            <image-name>

Create/upload an image

Expand
Table 39.7. Positional Arguments
ValueSummary

<image-name>

New image name

Expand
Table 39.8. Optional Arguments
ValueSummary

-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)

--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.

Expand
Table 39.9. Output Formatters
ValueSummary

-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

Expand
Table 39.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 39.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 39.12. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

39.3. image delete

Usage:

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

Delete image(s)

Expand
Table 39.13. Positional Arguments
ValueSummary

<image>

Image(s) to delete (name or id)

Expand
Table 39.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

39.4. image list

Usage:

openstack image list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                          [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}]
                          [--sort-column SORT_COLUMN]
                          [--public | --private | --community | --shared]
                          [--property <key=value>] [--name <name>]
                          [--status <status>] [--tag <tag>] [--long]
                          [--sort <key>[:<direction>]]
                          [--limit <num-images>] [--marker <image>]

List available images

Expand
Table 39.15. Optional Arguments
ValueSummary

-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

--name <name>

Filter images based on name.

--status <status>

Filter images based on status.

--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)

Expand
Table 39.16. Output Formatters
ValueSummary

-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

Expand
Table 39.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 39.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 39.19. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

39.5. image member list

Usage:

openstack image member list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]
                                 [--project-domain <project-domain>]
                                 <image>

List projects associated with image

Expand
Table 39.20. Positional Arguments
ValueSummary

<image>

Image (name or id)

Expand
Table 39.21. Optional Arguments
ValueSummary

-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.

Expand
Table 39.22. Output Formatters
ValueSummary

-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

Expand
Table 39.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 39.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 39.25. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

39.6. image remove project

Usage:

openstack image remove project [-h] [--project-domain <project-domain>]

                                    <image> <project>

Disassociate project with image

Expand
Table 39.26. Positional Arguments
ValueSummary

<image>

Image to unshare (name or id)

<project>

Project to disassociate with image (name or id)

Expand
Table 39.27. Optional Arguments
ValueSummary

-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.

39.7. image save

Usage:

openstack image save [-h] [--file <filename>] <image>

Save an image locally

Expand
Table 39.28. Positional Arguments
ValueSummary

<image>

Image to save (name or id)

Expand
Table 39.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--file <filename>

Downloaded image save filename (default: stdout)

39.8. image set

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>

Set image properties

Expand
Table 39.30. Positional Arguments
ValueSummary

<image>

Image to modify (name or id)

Expand
Table 39.31. Optional Arguments
ValueSummary

-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'

39.9. image show

Usage:

openstack image show [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          [--human-readable]
                          <image>

Display image details

Expand
Table 39.32. Positional Arguments
ValueSummary

<image>

Image to display (name or id)

Expand
Table 39.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--human-readable

Print image size in a human-friendly format.

Expand
Table 39.34. Output Formatters
ValueSummary

-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

Expand
Table 39.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 39.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 39.37. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

39.10. image unset

Usage:

openstack image unset [-h] [--tag <tag>] [--property <property-key>]

                           <image>

Unset image tags and properties

Expand
Table 39.38. Positional Arguments
ValueSummary

<image>

Image to modify (name or id)

Expand
Table 39.39. Optional Arguments
ValueSummary

-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 40. ip

This chapter describes the commands under the ip command.

40.1. ip availability list

Usage:

openstack ip availability list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--ip-version <ip-version>]
                                    [--project <project>]
                                    [--project-domain <project-domain>]

List IP availability for network

Expand
Table 40.1. Optional Arguments
ValueSummary

-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.

Expand
Table 40.2. Output Formatters
ValueSummary

-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

Expand
Table 40.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 40.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 40.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

40.2. ip availability show

Usage:

openstack ip availability show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <network>

Show network IP availability details

Expand
Table 40.6. Positional Arguments
ValueSummary

<network>

Show ip availability for a specific network (name or ID)

Expand
Table 40.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 40.8. Output Formatters
ValueSummary

-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

Expand
Table 40.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 40.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 40.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 41. keypair

This chapter describes the commands under the keypair command.

41.1. keypair create

Usage:

openstack keypair create [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              [--public-key <file> | --private-key <file>]
                              <name>

Create new public or private key for server ssh access

Expand
Table 41.1. Positional Arguments
ValueSummary

<name>

New public or private key name

Expand
Table 41.2. Optional Arguments
ValueSummary

-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.

Expand
Table 41.3. Output Formatters
ValueSummary

-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

Expand
Table 41.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 41.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 41.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

41.2. keypair delete

Usage:

openstack keypair delete [-h] <key> [<key> ...]

Delete public or private key(s)

Expand
Table 41.7. Positional Arguments
ValueSummary

<key>

Name of key(s) to delete (name only)

Expand
Table 41.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

41.3. keypair list

Usage:

openstack keypair list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN]

List key fingerprints

Expand
Table 41.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 41.10. Output Formatters
ValueSummary

-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

Expand
Table 41.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 41.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 41.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

41.4. keypair show

Usage:

openstack keypair show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--public-key]
                            <key>

Display key details

Expand
Table 41.14. Positional Arguments
ValueSummary

<key>

Public or private key to display (name only)

Expand
Table 41.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--public-key

Show only bare public key paired with the generated key

Expand
Table 41.16. Output Formatters
ValueSummary

-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

Expand
Table 41.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 41.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 41.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 42. l2gw

This chapter describes the commands under the l2gw command.

42.1. l2gw connection create

Usage:

openstack l2gw connection create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--default-segmentation-id SEG_ID]
                                      <GATEWAY-NAME/UUID>
                                      <NETWORK-NAME/UUID>

Create l2gateway-connection

Expand
Table 42.1. Positional Arguments
ValueSummary

<GATEWAY-NAME/UUID>

Descriptive name for logical gateway.

<NETWORK-NAME/UUID>

Network name or uuid.

Expand
Table 42.2. Optional Arguments
ValueSummary

-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.

Expand
Table 42.3. Output Formatters
ValueSummary

-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

Expand
Table 42.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the networking-l2gw plugin.

42.2. l2gw connection delete

Usage:

openstack l2gw connection delete [-h]

                                      <L2_GATEWAY_CONNECTIONS>
                                      [<L2_GATEWAY_CONNECTIONS> ...]

Delete a given l2gateway-connection

Expand
Table 42.7. Positional Arguments
ValueSummary

<L2_GATEWAY_CONNECTIONS>

ID(s) of l2_gateway_connections(s) to delete.

Expand
Table 42.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the networking-l2gw plugin.

42.3. l2gw connection list

Usage:

openstack l2gw connection list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--project <project>]
                                    [--project-domain <project-domain>]

List l2gateway-connections

Expand
Table 42.9. Optional Arguments
ValueSummary

-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.

Expand
Table 42.10. Output Formatters
ValueSummary

-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

Expand
Table 42.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the networking-l2gw plugin.

42.4. l2gw connection show

Usage:

openstack l2gw connection show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <L2_GATEWAY_CONNECTION>

Show information of a given l2gateway-connection

Expand
Table 42.14. Positional Arguments
ValueSummary

<L2_GATEWAY_CONNECTION>

ID of l2_gateway_connection to look up.

Expand
Table 42.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 42.16. Output Formatters
ValueSummary

-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

Expand
Table 42.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the networking-l2gw plugin.

42.5. l2gw create

Usage:

openstack l2gw create [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--project <project>]
                           [--project-domain <project-domain>]
                           [--device name=name,interface_names=INTERFACE-DETAILS]
                           <GATEWAY-NAME>

Create l2gateway resource

Expand
Table 42.20. Positional Arguments
ValueSummary

<GATEWAY-NAME>

Descriptive name for logical gateway.

Expand
Table 42.21. Optional Arguments
ValueSummary

-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>][

Expand
Table 42.22. Output Formatters
ValueSummary

-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

Expand
Table 42.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.25. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the networking-l2gw plugin.

42.6. l2gw delete

Usage:

openstack l2gw delete [-h] <L2_GATEWAY> [<L2_GATEWAY> ...]

Delete a given l2gateway

Expand
Table 42.26. Positional Arguments
ValueSummary

<L2_GATEWAY>

Id(s) or name(s) of l2_gateway to delete.

Expand
Table 42.27. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the networking-l2gw plugin.

42.7. l2gw list

Usage:

openstack l2gw list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--sort-column SORT_COLUMN] [--project <project>]
                         [--project-domain <project-domain>]

List l2gateway that belongs to a given tenant

Expand
Table 42.28. Optional Arguments
ValueSummary

-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.

Expand
Table 42.29. Output Formatters
ValueSummary

-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

Expand
Table 42.30. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.31. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.32. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the networking-l2gw plugin.

42.8. l2gw show

Usage:

openstack l2gw show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent] [--prefix PREFIX]
                         <L2_GATEWAY>

Show information of a given l2gateway

Expand
Table 42.33. Positional Arguments
ValueSummary

<L2_GATEWAY>

Id or name of l2_gateway to look up.

Expand
Table 42.34. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 42.35. Output Formatters
ValueSummary

-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

Expand
Table 42.36. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.38. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the networking-l2gw plugin.

42.9. l2gw update

Usage:

openstack l2gw update [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--name name]
                           [--device name=name,interface_names=INTERFACE-DETAILS]
                           <L2_GATEWAY>

Update a given l2gateway

Expand
Table 42.39. Positional Arguments
ValueSummary

<L2_GATEWAY>

Id or name of l2_gateway to update.

Expand
Table 42.40. Optional Arguments
ValueSummary

-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>][

Expand
Table 42.41. Output Formatters
ValueSummary

-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

Expand
Table 42.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 42.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 42.44. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the networking-l2gw plugin.

Chapter 43. limits

This chapter describes the commands under the limits command.

43.1. limits show

Usage:

openstack limits show [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] (--absolute | --rate)
                           [--reserved] [--project <project>]
                           [--domain <domain>]

Show compute and block storage limits

Expand
Table 43.1. Optional Arguments
ValueSummary

-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]

Expand
Table 43.2. Output Formatters
ValueSummary

-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

Expand
Table 43.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 43.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 43.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

Chapter 44. loadbalancer

This chapter describes the commands under the loadbalancer command.

44.1. loadbalancer amphora list

Usage:

openstack loadbalancer amphora list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--loadbalancer <loadbalancer>]
                                         [--compute-id <compute-id>]
                                         [--role {MASTER,BACKUP,STANDALONE}]
                                         [--status {PENDING_DELETE,DELETED,ERROR,PENDING_CREATE,BOOTING,READY,ALLOCATED}]

List amphorae

Expand
Table 44.1. Optional Arguments
ValueSummary

-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 {MASTER,BACKUP,STANDALONE}

Filter by role.

--status {PENDING_DELETE,DELETED,ERROR,PENDING_CREATE,BOOTING,READY,ALLOCATED}, --provisioning-status {PENDING_DELETE,DELETED,ERROR,PENDING_CREATE,BOOTING,READY,ALLOCATED}

Filter by amphora provisioning status.

Expand
Table 44.2. Output Formatters
ValueSummary

-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

Expand
Table 44.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.2. loadbalancer amphora show

Usage:

openstack loadbalancer amphora show [-h]

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

Show the details of a single amphora

Expand
Table 44.6. Positional Arguments
ValueSummary

<amphora-id>

Uuid of the amphora.

Expand
Table 44.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.8. Output Formatters
ValueSummary

-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

Expand
Table 44.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.3. loadbalancer create

Usage:

openstack loadbalancer create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--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>]
                                   [--enable | --disable]

Create a load balancer

Expand
Table 44.12. Optional Arguments
ValueSummary

-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).

--enable

Enable load balancer (default).

--disable

Disable load balancer.

Expand
Table 44.13. Output Formatters
ValueSummary

-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

Expand
Table 44.14. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.15. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.16. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 44.17. VIP Network
ValueSummary

--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).

This command is provided by the python-octaviaclient plugin.

44.4. loadbalancer delete

Usage:

openstack loadbalancer delete [-h] [--cascade] <load_balancer>

Delete a load balancer

Expand
Table 44.18. Positional Arguments
ValueSummary

<load_balancer>

Load balancers to delete (name or id)

Expand
Table 44.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--cascade

Cascade the delete to all child elements of the load balancer.

This command is provided by the python-octaviaclient plugin.

44.5. loadbalancer failover

Usage:

openstack loadbalancer failover [-h] <load_balancer>

Trigger load balancer failover

Expand
Table 44.20. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.6. loadbalancer healthmonitor create

Usage:

openstack loadbalancer healthmonitor create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX]
                                                 [--name <name>] --delay
                                                 <delay>
                                                 [--expected-codes <codes>]
                                                 [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
                                                 --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>

Create a health monitor

Expand
Table 44.22. Positional Arguments
ValueSummary

<pool>

Set the pool for the health monitor (name or id).

Expand
Table 44.23. Optional Arguments
ValueSummary

-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.

--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.

--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.

Expand
Table 44.24. Output Formatters
ValueSummary

-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

Expand
Table 44.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.7. loadbalancer healthmonitor delete

Usage:

openstack loadbalancer healthmonitor delete [-h] <health_monitor>

Delete a health monitor

Expand
Table 44.28. Positional Arguments
ValueSummary

<health_monitor>

Health monitor to delete (name or id).

Expand
Table 44.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.8. loadbalancer healthmonitor list

Usage:

openstack loadbalancer healthmonitor list [-h]

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

List health monitors

Expand
Table 44.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.31. Output Formatters
ValueSummary

-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

Expand
Table 44.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.34. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.9. loadbalancer healthmonitor set

Usage:

openstack loadbalancer healthmonitor set [-h] [--name <name>]

                                              [--delay <delay>]
                                              [--expected-codes <codes>]
                                              [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
                                              [--timeout <timeout>]
                                              [--max-retries <max_retries>]
                                              [--max-retries-down <max_retries_down>]
                                              [--url-path <url_path>]
                                              [--enable | --disable]
                                              <health_monitor>

Update a health monitor

Expand
Table 44.35. Positional Arguments
ValueSummary

<health_monitor>

Health monitor to update (name or id).

Expand
Table 44.36. Optional Arguments
ValueSummary

-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.

--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.

--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.

This command is provided by the python-octaviaclient plugin.

44.10. loadbalancer healthmonitor show

Usage:

openstack loadbalancer healthmonitor show [-h]

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

Show the details of a single health monitor

Expand
Table 44.37. Positional Arguments
ValueSummary

<health_monitor>

Name or uuid of the health monitor.

Expand
Table 44.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.39. Output Formatters
ValueSummary

-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

Expand
Table 44.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.11. loadbalancer l7policy create

Usage:

openstack loadbalancer l7policy create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--name <name>]
                                            [--description <description>]
                                            --action
                                            {REDIRECT_TO_URL,REDIRECT_TO_POOL,REJECT}
                                            [--redirect-pool <pool> | --redirect-url <url>]
                                            [--position <position>]
                                            [--enable | --disable]
                                            <listener>

Create a l7policy

Expand
Table 44.43. Positional Arguments
ValueSummary

<listener>

Listener to add l7policy to (name or id).

Expand
Table 44.44. Optional Arguments
ValueSummary

-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,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.

--position <position>

Sequence number of this L7 Policy.

--enable

Enable l7policy (default).

--disable

Disable l7policy.

Expand
Table 44.45. Output Formatters
ValueSummary

-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

Expand
Table 44.46. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.48. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.12. loadbalancer l7policy delete

Usage:

openstack loadbalancer l7policy delete [-h] <policy>

Delete a l7policy

Expand
Table 44.49. Positional Arguments
ValueSummary

<policy>

L7policy to delete (name or id).

Expand
Table 44.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.13. loadbalancer l7policy list

Usage:

openstack loadbalancer l7policy list [-h]

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

List l7policies

Expand
Table 44.51. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.52. Output Formatters
ValueSummary

-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

Expand
Table 44.53. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.54. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.55. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.14. loadbalancer l7policy set

Usage:

openstack loadbalancer l7policy set [-h] [--name <name>]

                                         [--description <description>]
                                         [--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REJECT}]
                                         [--redirect-pool <pool> | --redirect-url <url>]
                                         [--position <position>]
                                         [--enable | --disable]
                                         <policy>

Update a l7policy

Expand
Table 44.56. Positional Arguments
ValueSummary

<policy>

L7policy to update (name or id).

Expand
Table 44.57. Optional Arguments
ValueSummary

-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,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.

--position <position>

Set sequence number of this L7 Policy.

--enable

Enable l7policy.

--disable

Disable l7policy.

This command is provided by the python-octaviaclient plugin.

44.15. loadbalancer l7policy show

Usage:

openstack loadbalancer l7policy show [-h]

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

Show the details of a single l7policy

Expand
Table 44.58. Positional Arguments
ValueSummary

<policy>

Name or uuid of the l7policy.

Expand
Table 44.59. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.60. Output Formatters
ValueSummary

-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

Expand
Table 44.61. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.62. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.63. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.16. loadbalancer l7rule create

Usage:

openstack loadbalancer l7rule create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          --compare-type
                                          {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}
                                          [--invert] --value <value>
                                          [--key <key>] --type
                                          {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER}
                                          [--enable | --disable]
                                          <l7policy>

Create a l7rule

Expand
Table 44.64. Positional Arguments
ValueSummary

<l7policy>

L7policy to add l7rule to (name or id).

Expand
Table 44.65. Optional Arguments
ValueSummary

-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}

Set the type for the l7rule.

--enable

Enable l7rule (default).

--disable

Disable l7rule.

Expand
Table 44.66. Output Formatters
ValueSummary

-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

Expand
Table 44.67. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.68. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.69. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.17. loadbalancer l7rule delete

Usage:

openstack loadbalancer l7rule delete [-h] <l7policy> <rule_id>

Delete a l7rule

Expand
Table 44.70. Positional Arguments
ValueSummary

<l7policy>

L7policy to delete rule from (name or id).

<rule_id>

L7rule to delete.

Expand
Table 44.71. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.18. loadbalancer l7rule list

Usage:

openstack loadbalancer l7rule list [-h]

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

List l7rules for l7policy

Expand
Table 44.72. Positional Arguments
ValueSummary

<l7policy>

L7policy to list rules for (name or id).

Expand
Table 44.73. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.74. Output Formatters
ValueSummary

-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

Expand
Table 44.75. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.76. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.77. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.19. loadbalancer l7rule set

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}]
                                       [--enable | --disable]
                                       <l7policy> <l7rule_id>

Update a l7rule

Expand
Table 44.78. Positional Arguments
ValueSummary

<l7policy>

L7policy to update l7rule on (name or id).

<l7rule_id>

L7rule to update.

Expand
Table 44.79. Optional Arguments
ValueSummary

-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}

Set the type for the l7rule.

--enable

Enable l7rule.

--disable

Disable l7rule.

This command is provided by the python-octaviaclient plugin.

44.20. loadbalancer l7rule show

Usage:

openstack loadbalancer l7rule show [-h]

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

Show the details of a single l7rule

Expand
Table 44.80. Positional Arguments
ValueSummary

<l7policy>

L7policy to show rule from (name or id).

<l7rule_id>

L7rule to show.

Expand
Table 44.81. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.82. Output Formatters
ValueSummary

-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

Expand
Table 44.83. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.84. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.85. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.21. loadbalancer list

Usage:

openstack loadbalancer list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--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>]

List load balancers

Expand
Table 44.86. Optional Arguments
ValueSummary

-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.

Expand
Table 44.87. Output Formatters
ValueSummary

-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

Expand
Table 44.88. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.89. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.90. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.22. loadbalancer listener create

Usage:

openstack loadbalancer listener create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--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]
                                            <loadbalancer>

Create a listener

Expand
Table 44.91. Positional Arguments
ValueSummary

<loadbalancer>

Load balancer for the listener (name or id).

Expand
Table 44.92. Optional Arguments
ValueSummary

-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.

Expand
Table 44.93. Output Formatters
ValueSummary

-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

Expand
Table 44.94. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.95. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.96. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.23. loadbalancer listener delete

Usage:

openstack loadbalancer listener delete [-h] <listener>

Delete a listener

Expand
Table 44.97. Positional Arguments
ValueSummary

<listener>

Listener to delete (name or id)

Expand
Table 44.98. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.24. loadbalancer listener list

Usage:

openstack loadbalancer listener list [-h]

                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--sort-column SORT_COLUMN]
                                          [--name <name>]
                                          [--loadbalancer <loadbalancer>]
                                          [--enable | --disable]
                                          [--project <project>]

List listeners

Expand
Table 44.99. Optional Arguments
ValueSummary

-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.

Expand
Table 44.100. Output Formatters
ValueSummary

-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

Expand
Table 44.101. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.102. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.103. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.25. loadbalancer listener set

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]
                                         <listener>

Update a listener

Expand
Table 44.104. Positional Arguments
ValueSummary

<listener>

Listener to modify (name or id).

Expand
Table 44.105. Optional Arguments
ValueSummary

-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.

This command is provided by the python-octaviaclient plugin.

44.26. loadbalancer listener show

Usage:

openstack loadbalancer listener show [-h]

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

Show the details of a single listener

Expand
Table 44.106. Positional Arguments
ValueSummary

<listener>

Name or uuid of the listener

Expand
Table 44.107. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.108. Output Formatters
ValueSummary

-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

Expand
Table 44.109. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.110. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.111. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.27. loadbalancer listener stats show

Usage:

openstack loadbalancer listener stats show [-h]

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

Shows the current statistics for a listener.

Expand
Table 44.112. Positional Arguments
ValueSummary

<listener>

Name or uuid of the listener

Expand
Table 44.113. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.114. Output Formatters
ValueSummary

-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

Expand
Table 44.115. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.116. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.117. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.28. loadbalancer member create

Usage:

openstack loadbalancer member create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--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>

Creating a member in a pool

Expand
Table 44.118. Positional Arguments
ValueSummary

<pool>

Id or name of the pool to create the member for.

Expand
Table 44.119. Optional Arguments
ValueSummary

-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

Expand
Table 44.120. Output Formatters
ValueSummary

-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

Expand
Table 44.121. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.122. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.123. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.29. loadbalancer member delete

Usage:

openstack loadbalancer member delete [-h] <pool> <member>

Delete a member from a pool

Expand
Table 44.124. Positional Arguments
ValueSummary

<pool>

Pool name or id to delete the member from.

<member>

Name or id of the member to be deleted.

Expand
Table 44.125. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.30. loadbalancer member list

Usage:

openstack loadbalancer member list [-h]

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

List members in a pool

Expand
Table 44.126. Positional Arguments
ValueSummary

<pool>

Pool name or id to list the members of.

Expand
Table 44.127. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.128. Output Formatters
ValueSummary

-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

Expand
Table 44.129. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.130. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.131. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.31. loadbalancer member set

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>

Update a member

Expand
Table 44.132. Positional Arguments
ValueSummary

<pool>

Pool that the member to update belongs to (name or ID).

<member>

Name or id of the member to update

Expand
Table 44.133. Optional Arguments
ValueSummary

-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

This command is provided by the python-octaviaclient plugin.

44.32. loadbalancer member show

Usage:

openstack loadbalancer member show [-h]

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

Shows details of a single Member

Expand
Table 44.134. Positional Arguments
ValueSummary

<pool>

Pool name or id to show the members of.

<member>

Name or id of the member to show.

Expand
Table 44.135. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.136. Output Formatters
ValueSummary

-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

Expand
Table 44.137. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.138. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.139. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.33. loadbalancer pool create

Usage:

openstack loadbalancer pool create [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        [--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]

Create a pool

Expand
Table 44.140. Optional Arguments
ValueSummary

-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.

Expand
Table 44.141. Output Formatters
ValueSummary

-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

Expand
Table 44.142. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.143. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.144. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.34. loadbalancer pool delete

Usage:

openstack loadbalancer pool delete [-h] <pool>

Delete a pool

Expand
Table 44.145. Positional Arguments
ValueSummary

<pool>

Pool to delete (name or id).

Expand
Table 44.146. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.35. loadbalancer pool list

Usage:

openstack loadbalancer pool list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--loadbalancer <loadbalancer>]

List pools

Expand
Table 44.147. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--loadbalancer <loadbalancer>

Filter by load balancer (name or ID).

Expand
Table 44.148. Output Formatters
ValueSummary

-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

Expand
Table 44.149. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.150. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.151. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.36. loadbalancer pool set

Usage:

openstack loadbalancer pool set [-h] [--name <name>]

                                     [--description <description>]
                                     [--session-persistence <session_persistence>]
                                     [--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}]
                                     [--enable | --disable]
                                     <pool>

Update a pool

Expand
Table 44.152. Positional Arguments
ValueSummary

<pool>

Pool to update (name or id).

Expand
Table 44.153. Optional Arguments
ValueSummary

-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.

This command is provided by the python-octaviaclient plugin.

44.37. loadbalancer pool show

Usage:

openstack loadbalancer pool show [-h]

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

Show the details of a single pool

Expand
Table 44.154. Positional Arguments
ValueSummary

<pool>

Name or uuid of the pool.

Expand
Table 44.155. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.156. Output Formatters
ValueSummary

-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

Expand
Table 44.157. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.158. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.159. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.38. loadbalancer quota defaults show

Usage:

openstack loadbalancer quota defaults show [-h]

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

Show quota defaults

Expand
Table 44.160. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.161. Output Formatters
ValueSummary

-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

Expand
Table 44.162. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.163. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.164. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.39. loadbalancer quota list

Usage:

openstack loadbalancer quota list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       [--project <project-id>]

List quotas

Expand
Table 44.165. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project-id>

Name or UUID of the project.

Expand
Table 44.166. Output Formatters
ValueSummary

-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

Expand
Table 44.167. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.168. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.169. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.40. loadbalancer quota reset

Usage:

openstack loadbalancer quota reset [-h] <project>

Resets quotas to default quotas

Expand
Table 44.170. Positional Arguments
ValueSummary

<project>

Project to reset quotas (name or id)

Expand
Table 44.171. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.41. loadbalancer quota set

Usage:

openstack loadbalancer quota set [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--healthmonitor <health_monitor>]
                                      [--listener <listener>]
                                      [--loadbalancer <load_balancer>]
                                      [--member <member>] [--pool <pool>]
                                      <project>

Update a quota

Expand
Table 44.172. Positional Arguments
ValueSummary

<project>

Name or uuid of the project.

Expand
Table 44.173. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.174. Output Formatters
ValueSummary

-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

Expand
Table 44.175. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.176. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.177. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 44.178. Quota limits
ValueSummary

--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.

This command is provided by the python-octaviaclient plugin.

44.42. loadbalancer quota show

Usage:

openstack loadbalancer quota show [-h]

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

Show the quota details for a project

Expand
Table 44.179. Positional Arguments
ValueSummary

<project>

Name or uuid of the project.

Expand
Table 44.180. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.181. Output Formatters
ValueSummary

-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

Expand
Table 44.182. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.183. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.184. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.43. loadbalancer set

Usage:

openstack loadbalancer set [-h] [--name <name>]

                                [--description <description>]
                                [--vip-qos-policy-id <vip_qos_policy_id>]
                                [--enable | --disable]
                                <load_balancer>

Update a load balancer

Expand
Table 44.185. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer to update.

Expand
Table 44.186. Optional Arguments
ValueSummary

-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.

This command is provided by the python-octaviaclient plugin.

44.44. loadbalancer show

Usage:

openstack loadbalancer show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 <load_balancer>

Show the details for a single load balancer

Expand
Table 44.187. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.188. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.189. Output Formatters
ValueSummary

-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

Expand
Table 44.190. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.191. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.192. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.45. loadbalancer stats show

Usage:

openstack loadbalancer stats show [-h]

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

Shows the current statistics for a load balancer

Expand
Table 44.193. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.194. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.195. Output Formatters
ValueSummary

-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

Expand
Table 44.196. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 44.197. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.198. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.46. loadbalancer status show

Usage:

openstack loadbalancer status show [-h] <load_balancer>

Display load balancer status tree in json format

Expand
Table 44.199. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.200. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

Chapter 45. messaging

This chapter describes the commands under the messaging command.

45.1. messaging claim create

Usage:

openstack messaging claim create [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--ttl <ttl>] [--grace <grace>]
                                      [--limit <limit>]
                                      <queue_name>

Create claim and return a list of claimed messages

Expand
Table 45.1. Positional Arguments
ValueSummary

<queue_name>

Name of the queue to be claim

Expand
Table 45.2. Optional Arguments
ValueSummary

-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

Expand
Table 45.3. Output Formatters
ValueSummary

-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

Expand
Table 45.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.2. messaging claim query

Usage:

openstack messaging claim query [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     <queue_name> <claim_id>

Display claim details

Expand
Table 45.7. Positional Arguments
ValueSummary

<queue_name>

Name of the claimed queue

<claim_id>

Id of the claim

Expand
Table 45.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.9. Output Formatters
ValueSummary

-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

Expand
Table 45.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.3. messaging claim release

Usage:

openstack messaging claim release [-h] <queue_name> <claim_id>

Delete a claim

Expand
Table 45.13. Positional Arguments
ValueSummary

<queue_name>

Name of the claimed queue

<claim_id>

Claim id to delete

Expand
Table 45.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.4. messaging claim renew

Usage:

openstack messaging claim renew [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     [--ttl <ttl>] [--grace <grace>]
                                     <queue_name> <claim_id>

Renew a claim

Expand
Table 45.15. Positional Arguments
ValueSummary

<queue_name>

Name of the claimed queue

<claim_id>

Claim id

Expand
Table 45.16. Optional Arguments
ValueSummary

-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

Expand
Table 45.17. Output Formatters
ValueSummary

-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

Expand
Table 45.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.20. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.5. messaging flavor create

Usage:

openstack messaging flavor create [-h]

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

Create a pool flavor

Expand
Table 45.21. Positional Arguments
ValueSummary

<flavor_name>

Name of the flavor

<pool_group>

Pool group for flavor

Expand
Table 45.22. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--capabilities <capabilities>

Describes flavor-specific capabilities, This option is only available in client api version < 2 .

Expand
Table 45.23. Output Formatters
ValueSummary

-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

Expand
Table 45.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.26. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.6. messaging flavor delete

Usage:

openstack messaging flavor delete [-h] <flavor_name>

Delete a pool flavor

Expand
Table 45.27. Positional Arguments
ValueSummary

<flavor_name>

Name of the flavor

Expand
Table 45.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.7. messaging flavor list

Usage:

openstack messaging flavor list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     [--marker <flavor_name>]
                                     [--limit <limit>] [--detailed]

List available pool flavors

Expand
Table 45.29. Optional Arguments
ValueSummary

-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

Expand
Table 45.30. Output Formatters
ValueSummary

-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

Expand
Table 45.31. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.32. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.33. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.8. messaging flavor show

Usage:

openstack messaging flavor show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <flavor_name>

Display pool flavor details

Expand
Table 45.34. Positional Arguments
ValueSummary

<flavor_name>

Flavor to display (name)

Expand
Table 45.35. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.36. Output Formatters
ValueSummary

-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

Expand
Table 45.37. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.38. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.39. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.9. messaging flavor update

Usage:

openstack messaging flavor update [-h]

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

Update a flavor’s attributes

Expand
Table 45.40. Positional Arguments
ValueSummary

<flavor_name>

Name of the flavor

Expand
Table 45.41. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--pool_group <pool_group>

Pool group the flavor sits on

--capabilities <capabilities>

Describes flavor-specific capabilities.

Expand
Table 45.42. Output Formatters
ValueSummary

-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

Expand
Table 45.43. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.44. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.45. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.10. messaging health

Usage:

openstack messaging health [-h]

Display detailed health status of Zaqar server

Expand
Table 45.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.11. messaging homedoc

Usage:

openstack messaging homedoc [-h]

Display detailed resource doc of Zaqar server

Expand
Table 45.47. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.12. messaging message list

Usage:

openstack messaging message list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--message-ids <message_ids>]
                                      [--limit <limit>] [--echo]
                                      [--include-claimed]
                                      [--include-delayed]
                                      [--client-id <client_id>]
                                      <queue_name>

List all messages for a given queue

Expand
Table 45.48. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.49. Optional Arguments
ValueSummary

-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.

Expand
Table 45.50. Output Formatters
ValueSummary

-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

Expand
Table 45.51. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.52. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.53. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.13. messaging message post

Usage:

openstack messaging message post [-h] [--client-id <client_id>]

                                      <queue_name> <messages>

Post messages for a given queue

Expand
Table 45.54. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

<messages>

Messages to be posted.

Expand
Table 45.55. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--client-id <client_id>

A UUID for each client instance.

This command is provided by the python-zaqarclient plugin.

45.14. messaging ping

Usage:

openstack messaging ping [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]

Check if Zaqar server is alive or not

Expand
Table 45.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.57. Output Formatters
ValueSummary

-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

Expand
Table 45.58. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.59. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.60. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.15. messaging pool create

Usage:

openstack messaging pool create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--pool_group <pool_group>]
                                     [--pool_options <pool_options>]
                                     <pool_name> <pool_uri> <pool_weight>

Create a pool

Expand
Table 45.61. Positional Arguments
ValueSummary

<pool_name>

Name of the pool

<pool_uri>

Storage engine uri

<pool_weight>

Weight of the pool

Expand
Table 45.62. Optional Arguments
ValueSummary

-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

Expand
Table 45.63. Output Formatters
ValueSummary

-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

Expand
Table 45.64. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.65. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.66. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.16. messaging pool delete

Usage:

openstack messaging pool delete [-h] <pool_name>

Delete a pool

Expand
Table 45.67. Positional Arguments
ValueSummary

<pool_name>

Name of the pool

Expand
Table 45.68. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.17. messaging pool list

Usage:

openstack messaging pool list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--marker <pool_name>] [--limit <limit>]
                                   [--detailed]

List available Pools

Expand
Table 45.69. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--marker <pool_name>

Pool’s paging marker

--limit <limit>

Page size limit

--detailed

Detailed output

Expand
Table 45.70. Output Formatters
ValueSummary

-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

Expand
Table 45.71. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.72. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.73. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.18. messaging pool show

Usage:

openstack messaging pool show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <pool_name>

Display pool details

Expand
Table 45.74. Positional Arguments
ValueSummary

<pool_name>

Pool to display (name)

Expand
Table 45.75. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.76. Output Formatters
ValueSummary

-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

Expand
Table 45.77. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.78. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.79. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.19. messaging pool update

Usage:

openstack messaging pool update [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--pool_uri <pool_uri>]
                                     [--pool_weight <pool_weight>]
                                     [--pool_group <pool_group>]
                                     [--pool_options <pool_options>]
                                     <pool_name>

Update a pool attribute

Expand
Table 45.80. Positional Arguments
ValueSummary

<pool_name>

Name of the pool

Expand
Table 45.81. Optional Arguments
ValueSummary

-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

Expand
Table 45.82. Output Formatters
ValueSummary

-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

Expand
Table 45.83. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.84. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.85. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.20. messaging queue create

Usage:

openstack messaging queue create [-h]

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

Create a queue

Expand
Table 45.86. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.87. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.88. Output Formatters
ValueSummary

-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

Expand
Table 45.89. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.90. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.91. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.21. messaging queue delete

Usage:

openstack messaging queue delete [-h] <queue_name>

Delete a queue

Expand
Table 45.92. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.93. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.22. messaging queue get metadata

Usage:

openstack messaging queue get metadata [-h]

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

Get queue metadata

Expand
Table 45.94. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.95. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.96. Output Formatters
ValueSummary

-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

Expand
Table 45.97. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.98. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.99. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.23. messaging queue list

Usage:

openstack messaging queue list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--marker <queue_id>] [--limit <limit>]
                                    [--detailed]

List available queues

Expand
Table 45.100. Optional Arguments
ValueSummary

-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

Expand
Table 45.101. Output Formatters
ValueSummary

-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

Expand
Table 45.102. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.103. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.104. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.24. messaging queue purge

Usage:

openstack messaging queue purge [-h]

                                     [--resource_types <resource_types>]
                                     <queue_name>

Purge a queue

Expand
Table 45.105. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.106. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource_types <resource_types>

Resource types want to be purged.

This command is provided by the python-zaqarclient plugin.

45.25. messaging queue set metadata

Usage:

openstack messaging queue set metadata [-h]

                                            <queue_name> <queue_metadata>

Set queue metadata

Expand
Table 45.107. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

<queue_metadata>

Queue metadata, all the metadata of the queue will be replaced by queue_metadata

Expand
Table 45.108. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.26. messaging queue signed url

Usage:

openstack messaging queue signed url [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--paths <paths>]
                                          [--ttl-seconds <ttl_seconds>]
                                          [--methods <methods>]
                                          <queue_name>

Create a pre-signed url

Expand
Table 45.109. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.110. Optional Arguments
ValueSummary

-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

Expand
Table 45.111. Output Formatters
ValueSummary

-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

Expand
Table 45.112. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.113. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.114. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.27. messaging queue stats

Usage:

openstack messaging queue stats [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <queue_name>

Get queue stats

Expand
Table 45.115. Positional Arguments
ValueSummary

<queue_name>

Name of the queue

Expand
Table 45.116. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.117. Output Formatters
ValueSummary

-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

Expand
Table 45.118. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.119. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.120. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.28. messaging subscription create

Usage:

openstack messaging subscription create [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--options <options>]
                                             <queue_name> <subscriber> <ttl>

Create a subscription for queue

Expand
Table 45.121. Positional Arguments
ValueSummary

<queue_name>

Name of the queue to subscribe to

<subscriber>

Subscriber which will be notified

<ttl>

Time to live of the subscription in seconds

Expand
Table 45.122. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--options <options>

Metadata of the subscription in json format

Expand
Table 45.123. Output Formatters
ValueSummary

-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

Expand
Table 45.124. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.125. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.126. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.29. messaging subscription delete

Usage:

openstack messaging subscription delete [-h]

                                             <queue_name> <subscription_id>

Delete a subscription

Expand
Table 45.127. Positional Arguments
ValueSummary

<queue_name>

Name of the queue for the subscription

<subscription_id>

Id of the subscription

Expand
Table 45.128. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-zaqarclient plugin.

45.30. messaging subscription list

Usage:

openstack messaging subscription list [-h]

                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--sort-column SORT_COLUMN]
                                           [--marker <subscription_id>]
                                           [--limit <limit>]
                                           <queue_name>

List available subscriptions

Expand
Table 45.129. Positional Arguments
ValueSummary

<queue_name>

Name of the queue to subscribe to

Expand
Table 45.130. Optional Arguments
ValueSummary

-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

Expand
Table 45.131. Output Formatters
ValueSummary

-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

Expand
Table 45.132. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.133. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.134. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-zaqarclient plugin.

45.31. messaging subscription show

Usage:

openstack messaging subscription show [-h]

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

Display subscription details

Expand
Table 45.135. Positional Arguments
ValueSummary

<queue_name>

Name of the queue to subscribe to

<subscription_id>

Id of the subscription

Expand
Table 45.136. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 45.137. Output Formatters
ValueSummary

-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

Expand
Table 45.138. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.139. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.140. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

45.32. messaging subscription update

Usage:

openstack messaging subscription update [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--subscriber <subscriber>]
                                             [--ttl <ttl>]
                                             [--options <options>]
                                             <queue_name> <subscription_id>

Update a subscription

Expand
Table 45.141. Positional Arguments
ValueSummary

<queue_name>

Name of the queue to subscribe to

<subscription_id>

Id of the subscription

Expand
Table 45.142. Optional Arguments
ValueSummary

-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

Expand
Table 45.143. Output Formatters
ValueSummary

-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

Expand
Table 45.144. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 45.145. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 45.146. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-zaqarclient plugin.

Chapter 46. metric

This chapter describes the commands under the metric command.

46.1. metric aggregates

Usage:

openstack metric aggregates [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]
                                 [--resource-type RESOURCE_TYPE]
                                 [--start START] [--stop STOP]
                                 [--granularity GRANULARITY]
                                 [--needed-overlap NEEDED_OVERLAP]
                                 [--groupby GROUPBY] [--fill FILL]
                                 operations [search]

Get measurements of aggregated metrics.

Expand
Table 46.1. Positional Arguments
ValueSummary

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.

Expand
Table 46.2. Optional Arguments
ValueSummary

-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'.

Expand
Table 46.3. Output Formatters
ValueSummary

-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

Expand
Table 46.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.2. metric archive policy create

Usage:

openstack metric archive-policy create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            -d <DEFINITION> [-b BACK_WINDOW]
                                            [-m AGGREGATION_METHODS]
                                            name

Create an archive policy.

Expand
Table 46.7. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.8. Optional Arguments
ValueSummary

-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

Expand
Table 46.9. Output Formatters
ValueSummary

-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

Expand
Table 46.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.12. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.3. metric archive policy delete

Usage:

openstack metric archive-policy delete [-h] name

Delete an archive policy.

Expand
Table 46.13. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.4. metric archive policy list

Usage:

openstack metric archive-policy list [-h]

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

List archive policies.

Expand
Table 46.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.16. Output Formatters
ValueSummary

-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

Expand
Table 46.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.19. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.5. metric archive policy show

Usage:

openstack metric archive-policy show [-h]

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

Show an archive policy.

Expand
Table 46.20. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.22. Output Formatters
ValueSummary

-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

Expand
Table 46.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.25. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.6. metric archive policy update

Usage:

openstack metric archive-policy update [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            -d <DEFINITION>
                                            name

Update an archive policy.

Expand
Table 46.26. Positional Arguments
ValueSummary

name

Name of the archive policy

Expand
Table 46.27. Optional Arguments
ValueSummary

-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 ':'

Expand
Table 46.28. Output Formatters
ValueSummary

-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

Expand
Table 46.29. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.30. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.31. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.7. metric archive policy rule create

Usage:

openstack metric archive-policy-rule create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX] -a
                                                 ARCHIVE_POLICY_NAME -m
                                                 METRIC_PATTERN
                                                 name

Create an archive policy rule.

Expand
Table 46.32. Positional Arguments
ValueSummary

name

Rule name

Expand
Table 46.33. Optional Arguments
ValueSummary

-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

Expand
Table 46.34. Output Formatters
ValueSummary

-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

Expand
Table 46.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.37. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.8. metric archive policy rule delete

Usage:

openstack metric archive-policy-rule delete [-h] name

Delete an archive policy rule.

Expand
Table 46.38. Positional Arguments
ValueSummary

name

Name of the archive policy rule

Expand
Table 46.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.9. metric archive policy rule list

Usage:

openstack metric archive-policy-rule list [-h]

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

List archive policy rules.

Expand
Table 46.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.41. Output Formatters
ValueSummary

-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

Expand
Table 46.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.44. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.10. metric archive policy rule show

Usage:

openstack metric archive-policy-rule show [-h]

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

Show an archive policy rule.

Expand
Table 46.45. Positional Arguments
ValueSummary

name

Name of the archive policy rule

Expand
Table 46.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.47. Output Formatters
ValueSummary

-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

Expand
Table 46.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.50. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.11. metric benchmark measures add

Usage:

openstack metric benchmark measures add [-h]

                                             [--resource-id RESOURCE_ID]
                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--workers WORKERS] --count
                                             COUNT [--batch BATCH]
                                             [--timestamp-start TIMESTAMP_START]
                                             [--timestamp-end TIMESTAMP_END]
                                             [--wait]
                                             metric

Do benchmark testing of adding measurements.

Expand
Table 46.51. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.52. Optional Arguments
ValueSummary

-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

Expand
Table 46.53. Output Formatters
ValueSummary

-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

Expand
Table 46.54. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.55. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.56. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.12. metric benchmark measures show

Usage:

openstack metric benchmark measures show [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--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

Do benchmark testing of measurements show.

Expand
Table 46.57. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.58. Optional Arguments
ValueSummary

-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

Expand
Table 46.59. Output Formatters
ValueSummary

-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

Expand
Table 46.60. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.61. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.62. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.13. metric benchmark metric create

Usage:

openstack metric benchmark metric create [-h]

                                              [--resource-id RESOURCE_ID]
                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--archive-policy-name ARCHIVE_POLICY_NAME]
                                              [--workers WORKERS] --count
                                              COUNT [--keep]

Do benchmark testing of metric creation.

Expand
Table 46.63. Optional Arguments
ValueSummary

-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

Expand
Table 46.64. Output Formatters
ValueSummary

-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

Expand
Table 46.65. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.66. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.67. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.14. metric benchmark metric show

Usage:

openstack metric benchmark metric show [-h] [--resource-id RESOURCE_ID]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--workers WORKERS] --count
                                            COUNT
                                            metric [metric ...]

Do benchmark testing of metric show.

Expand
Table 46.68. Positional Arguments
ValueSummary

metric

Id or name of the metrics

Expand
Table 46.69. Optional Arguments
ValueSummary

-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

Expand
Table 46.70. Output Formatters
ValueSummary

-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

Expand
Table 46.71. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.72. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.73. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.15. metric capabilities list

Usage:

openstack metric capabilities list [-h]

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

List capabilities.

Expand
Table 46.74. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.75. Output Formatters
ValueSummary

-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

Expand
Table 46.76. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.77. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.78. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.16. metric create

Usage:

openstack metric create [-h] [--resource-id RESOURCE_ID]

                             [-f {json,shell,table,value,yaml}] [-c COLUMN]
                             [--max-width <integer>] [--fit-width]
                             [--print-empty] [--noindent] [--prefix PREFIX]
                             [--archive-policy-name ARCHIVE_POLICY_NAME]
                             [--unit UNIT]
                             [METRIC_NAME]

Create a metric.

Expand
Table 46.79. Positional Arguments
ValueSummary

METRIC_NAME

Name of the metric

Expand
Table 46.80. Optional Arguments
ValueSummary

-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

Expand
Table 46.81. Output Formatters
ValueSummary

-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

Expand
Table 46.82. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.83. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.84. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.17. metric delete

Usage:

openstack metric delete [-h] [--resource-id RESOURCE_ID]

                             metric [metric ...]

Delete a metric.

Expand
Table 46.85. Positional Arguments
ValueSummary

metric

Ids or names of the metric

Expand
Table 46.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

This command is provided by the gnocchiclient plugin.

46.18. metric list

Usage:

openstack metric list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--limit <LIMIT>]
                           [--marker <MARKER>] [--sort <SORT>]

List metrics.

Expand
Table 46.87. Optional Arguments
ValueSummary

-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

Expand
Table 46.88. Output Formatters
ValueSummary

-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

Expand
Table 46.89. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.90. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.91. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.19. metric measures add

Usage:

openstack metric measures add [-h] [--resource-id RESOURCE_ID] -m

                                   MEASURE
                                   metric

Add measurements to a metric.

Expand
Table 46.92. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.93. Optional Arguments
ValueSummary

-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 '@'

This command is provided by the gnocchiclient plugin.

46.20. metric measures aggregation

Usage:

openstack metric measures aggregation [-h]

                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--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]

Get measurements of aggregated metrics.

Expand
Table 46.94. Optional Arguments
ValueSummary

-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'.

Expand
Table 46.95. Output Formatters
ValueSummary

-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

Expand
Table 46.96. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.97. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.98. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.21. metric measures batch metrics

Usage:

openstack metric measures batch-metrics [-h] file

Expand
Table 46.99. Positional Arguments
ValueSummary

file

File containing measurements to batch or - for stdin (see Gnocchi REST API docs for the format

Expand
Table 46.100. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.22. metric measures batch resources metrics

Usage:

openstack metric measures batch-resources-metrics [-h]

                                                       [--create-metrics]
                                                       file

Expand
Table 46.101. Positional Arguments
ValueSummary

file

File containing measurements to batch or - for stdin (see Gnocchi REST API docs for the format

Expand
Table 46.102. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--create-metrics

Create unknown metrics

This command is provided by the gnocchiclient plugin.

46.23. metric measures show

Usage:

openstack metric measures show [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN] [--utc]
                                    [--resource-id RESOURCE_ID]
                                    [--aggregation AGGREGATION]
                                    [--start START] [--stop STOP]
                                    [--granularity GRANULARITY] [--refresh]
                                    [--resample RESAMPLE]
                                    metric

Get measurements of a metric.

Expand
Table 46.103. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.104. Optional Arguments
ValueSummary

-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)

Expand
Table 46.105. Output Formatters
ValueSummary

-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

Expand
Table 46.106. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.107. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.108. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.24. metric metric create

Usage:

openstack metric metric create [-h] [--resource-id RESOURCE_ID]

                                    [-f {json,shell,table,value,yaml}]
                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--archive-policy-name ARCHIVE_POLICY_NAME]
                                    [--unit UNIT]
                                    [METRIC_NAME]

Deprecated: Create a metric.

Expand
Table 46.109. Positional Arguments
ValueSummary

METRIC_NAME

Name of the metric

Expand
Table 46.110. Optional Arguments
ValueSummary

-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

Expand
Table 46.111. Output Formatters
ValueSummary

-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

Expand
Table 46.112. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.113. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.114. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.25. metric metric delete

Usage:

openstack metric metric delete [-h] [--resource-id RESOURCE_ID]

                                    metric [metric ...]

Deprecated: Delete a metric.

Expand
Table 46.115. Positional Arguments
ValueSummary

metric

Ids or names of the metric

Expand
Table 46.116. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

This command is provided by the gnocchiclient plugin.

46.26. metric metric list

Usage:

openstack metric metric list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  [--limit <LIMIT>] [--marker <MARKER>]
                                  [--sort <SORT>]

Deprecated: List metrics.

Expand
Table 46.117. Optional Arguments
ValueSummary

-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

Expand
Table 46.118. Output Formatters
ValueSummary

-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

Expand
Table 46.119. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.120. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.121. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.27. metric metric show

Usage:

openstack metric metric show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  [--resource-id RESOURCE_ID]
                                  metric

Deprecated: Show a metric.

Expand
Table 46.122. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.123. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

Expand
Table 46.124. Output Formatters
ValueSummary

-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

Expand
Table 46.125. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.126. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.127. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.28. metric resource batch delete

Usage:

openstack metric resource batch delete [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--type RESOURCE_TYPE]
                                            query

Delete a batch of resources based on attribute values.

Expand
Table 46.128. Positional Arguments
ValueSummary

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.

Expand
Table 46.129. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

Expand
Table 46.130. Output Formatters
ValueSummary

-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

Expand
Table 46.131. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.132. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.133. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.29. metric resource create

Usage:

openstack metric resource create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--type RESOURCE_TYPE] [-a ATTRIBUTE]
                                      [-m ADD_METRIC] [-n CREATE_METRIC]
                                      resource_id

Create a resource.

Expand
Table 46.134. Positional Arguments
ValueSummary

resource_id

Id of the resource

Expand
Table 46.135. Optional Arguments
ValueSummary

-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

Expand
Table 46.136. Output Formatters
ValueSummary

-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

Expand
Table 46.137. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.138. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.139. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.30. metric resource delete

Usage:

openstack metric resource delete [-h] resource_id

Delete a resource.

Expand
Table 46.140. Positional Arguments
ValueSummary

resource_id

Id of the resource

Expand
Table 46.141. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.31. metric resource history

Usage:

openstack metric resource history [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       [--details] [--limit <LIMIT>]
                                       [--marker <MARKER>] [--sort <SORT>]
                                       [--type RESOURCE_TYPE]
                                       resource_id

Show the history of a resource.

Expand
Table 46.142. Positional Arguments
ValueSummary

resource_id

Id of a resource

Expand
Table 46.143. Optional Arguments
ValueSummary

-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

Expand
Table 46.144. Output Formatters
ValueSummary

-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

Expand
Table 46.145. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.146. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.147. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.32. metric resource list

Usage:

openstack metric resource list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN] [--details]
                                    [--history] [--limit <LIMIT>]
                                    [--marker <MARKER>] [--sort <SORT>]
                                    [--type RESOURCE_TYPE]

List resources.

Expand
Table 46.148. Optional Arguments
ValueSummary

-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

Expand
Table 46.149. Output Formatters
ValueSummary

-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

Expand
Table 46.150. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.151. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.152. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.34. metric resource show

Usage:

openstack metric resource show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--type RESOURCE_TYPE]
                                    resource_id

Show a resource.

Expand
Table 46.159. Positional Arguments
ValueSummary

resource_id

Id of a resource

Expand
Table 46.160. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type RESOURCE_TYPE, -t RESOURCE_TYPE

Type of resource

Expand
Table 46.161. Output Formatters
ValueSummary

-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

Expand
Table 46.162. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.163. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.164. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.35. metric resource update

Usage:

openstack metric resource update [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--type RESOURCE_TYPE] [-a ATTRIBUTE]
                                      [-m ADD_METRIC] [-n CREATE_METRIC]
                                      [-d DELETE_METRIC]
                                      resource_id

Update a resource.

Expand
Table 46.165. Positional Arguments
ValueSummary

resource_id

Id of the resource

Expand
Table 46.166. Optional Arguments
ValueSummary

-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

Expand
Table 46.167. Output Formatters
ValueSummary

-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

Expand
Table 46.168. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.169. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.170. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.36. metric resource type create

Usage:

openstack metric resource-type create [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           [-a ATTRIBUTE]
                                           name

Create a resource type.

Expand
Table 46.171. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.172. Optional Arguments
ValueSummary

-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

Expand
Table 46.173. Output Formatters
ValueSummary

-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

Expand
Table 46.174. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.175. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.176. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.37. metric resource type delete

Usage:

openstack metric resource-type delete [-h] name

Delete a resource type.

Expand
Table 46.177. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.178. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the gnocchiclient plugin.

46.38. metric resource type list

Usage:

openstack metric resource-type list [-h]

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

List resource types.

Expand
Table 46.179. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.180. Output Formatters
ValueSummary

-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

Expand
Table 46.181. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.182. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.183. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the gnocchiclient plugin.

46.39. metric resource type show

Usage:

openstack metric resource-type show [-h]

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

Show a resource type.

Expand
Table 46.184. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.185. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.186. Output Formatters
ValueSummary

-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

Expand
Table 46.187. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.188. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.189. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.40. metric resource type update

Usage:

openstack metric resource-type update [-h]

                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--noindent] [--prefix PREFIX]
                                           [-a ATTRIBUTE]
                                           [-r REMOVE_ATTRIBUTE]
                                           name

Expand
Table 46.190. Positional Arguments
ValueSummary

name

Name of the resource type

Expand
Table 46.191. Optional Arguments
ValueSummary

-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

Expand
Table 46.192. Output Formatters
ValueSummary

-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

Expand
Table 46.193. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.194. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.195. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.41. metric server version

Usage:

openstack metric server version [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]

Show the version of Gnocchi server.

Expand
Table 46.196. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.197. Output Formatters
ValueSummary

-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

Expand
Table 46.198. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.199. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.200. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.42. metric show

Usage:

openstack metric show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--resource-id RESOURCE_ID]
                           metric

Show a metric.

Expand
Table 46.201. Positional Arguments
ValueSummary

metric

Id or name of the metric

Expand
Table 46.202. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource-id RESOURCE_ID, -r RESOURCE_ID

ID of the resource

Expand
Table 46.203. Output Formatters
ValueSummary

-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

Expand
Table 46.204. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.205. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.206. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

46.43. metric status

Usage:

openstack metric status [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]

Show the status of measurements processing.

Expand
Table 46.207. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 46.208. Output Formatters
ValueSummary

-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

Expand
Table 46.209. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 46.210. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 46.211. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the gnocchiclient plugin.

Chapter 47. module

This chapter describes the commands under the module command.

47.1. module list

Usage:

openstack module list [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--all]

List module versions

Expand
Table 47.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all

Show all modules that have version information

Expand
Table 47.2. Output Formatters
ValueSummary

-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

Expand
Table 47.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 47.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 47.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 48. network

This chapter describes the commands under the network command.

48.1. network agent add network

Usage:

openstack network agent add network [-h] [--dhcp] <agent-id> <network>

Add network to an agent

Expand
Table 48.1. Positional Arguments
ValueSummary

<agent-id>

Agent to which a network is added (id only)

<network>

Network to be added to an agent (name or id)

Expand
Table 48.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--dhcp

Add network to a dhcp agent

48.2. network agent add router

Usage:

openstack network agent add router [-h] [--l3] <agent-id> <router>

Add router to an agent

Expand
Table 48.3. Positional Arguments
ValueSummary

<agent-id>

Agent to which a router is added (id only)

<router>

Router to be added to an agent (name or id)

Expand
Table 48.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--l3

Add router to an l3 agent

48.3. network agent delete

Usage:

openstack network agent delete [-h]

                                    <network-agent> [<network-agent> ...]

Delete network agent(s)

Expand
Table 48.5. Positional Arguments
ValueSummary

<network-agent>

Network agent(s) to delete (id only)

Expand
Table 48.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.4. network agent list

Usage:

openstack network agent list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]
                                  [--agent-type <agent-type>]
                                  [--host <host>]
                                  [--network <network> | --router <router>]
                                  [--long]

List network agents

Expand
Table 48.7. Optional Arguments
ValueSummary

-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

Expand
Table 48.8. Output Formatters
ValueSummary

-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

Expand
Table 48.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.11. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.5. network agent remove network

Usage:

openstack network agent remove network [-h] [--dhcp]

                                            <agent-id> <network>

Remove network from an agent.

Expand
Table 48.12. Positional Arguments
ValueSummary

<agent-id>

Agent to which a network is removed (id only)

<network>

Network to be removed from an agent (name or id)

Expand
Table 48.13. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--dhcp

Remove network from dhcp agent

48.6. network agent remove router

Usage:

openstack network agent remove router [-h] [--l3] <agent-id> <router>

Remove router from an agent

Expand
Table 48.14. Positional Arguments
ValueSummary

<agent-id>

Agent from which router will be removed (id only)

<router>

Router to be removed from an agent (name or id)

Expand
Table 48.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--l3

Remove router from an l3 agent

48.7. network agent set

Usage:

openstack network agent set [-h] [--description <description>]

                                 [--enable | --disable]
                                 <network-agent>

Set network agent properties

Expand
Table 48.16. Positional Arguments
ValueSummary

<network-agent>

Network agent to modify (id only)

Expand
Table 48.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Set network agent description

--enable

Enable network agent

--disable

Disable network agent

48.8. network agent show

Usage:

openstack network agent show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <network-agent>

Display network agent details

Expand
Table 48.18. Positional Arguments
ValueSummary

<network-agent>

Network agent to display (id only)

Expand
Table 48.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.20. Output Formatters
ValueSummary

-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

Expand
Table 48.21. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.22. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.23. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.9. network auto allocated topology create

Usage:

openstack network auto allocated topology create [-h]

                                                      [-f {json,shell,table,value,yaml}]
                                                      [-c COLUMN]
                                                      [--max-width <integer>]
                                                      [--fit-width]
                                                      [--print-empty]
                                                      [--noindent]
                                                      [--prefix PREFIX]
                                                      [--project <project>]
                                                      [--project-domain <project-domain>]
                                                      [--check-resources]
                                                      [--or-show]

Create the auto allocated topology for project

Expand
Table 48.24. Optional Arguments
ValueSummary

-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)

Expand
Table 48.25. Output Formatters
ValueSummary

-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

Expand
Table 48.26. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.27. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.28. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.10. network auto allocated topology delete

Usage:

openstack network auto allocated topology delete [-h]

                                                      [--project <project>]
                                                      [--project-domain <project-domain>]

Delete auto allocated topology for project

Expand
Table 48.29. Optional Arguments
ValueSummary

-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.

48.11. network create

Usage:

openstack network create [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX] [--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>]
                              [--tag <tag> | --no-tag]
                              <name>

Create new network

Expand
Table 48.30. Positional Arguments
ValueSummary

<name>

New network name

Expand
Table 48.31. Optional Arguments
ValueSummary

-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

--tag <tag>

Tag to be added to the network (repeat option to set multiple tags)

--no-tag

No tags associated with the network

Expand
Table 48.32. Output Formatters
ValueSummary

-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

Expand
Table 48.33. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.34. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.35. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.12. network delete

Usage:

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

Delete network(s)

Expand
Table 48.36. Positional Arguments
ValueSummary

<network>

Network(s) to delete (name or id)

Expand
Table 48.37. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.13. network flavor add profile

Usage:

openstack network flavor add profile [-h] <flavor> <service-profile>

Add a service profile to a network flavor

Expand
Table 48.38. Positional Arguments
ValueSummary

<flavor>

Network flavor (name or id)

<service-profile>

Service profile (id only)

Expand
Table 48.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.14. network flavor create

Usage:

openstack network flavor create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     --service-type <service-type>
                                     [--description DESCRIPTION]
                                     [--project <project>]
                                     [--project-domain <project-domain>]
                                     [--enable | --disable]
                                     <name>

Create new network flavor

Expand
Table 48.40. Positional Arguments
ValueSummary

<name>

Name for the flavor

Expand
Table 48.41. Optional Arguments
ValueSummary

-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

Expand
Table 48.42. Output Formatters
ValueSummary

-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

Expand
Table 48.43. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.44. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.45. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.15. network flavor delete

Usage:

openstack network flavor delete [-h] <flavor> [<flavor> ...]

Delete network flavors

Expand
Table 48.46. Positional Arguments
ValueSummary

<flavor>

Flavor(s) to delete (name or id)

Expand
Table 48.47. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.16. network flavor list

Usage:

openstack network flavor list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]

List network flavors

Expand
Table 48.48. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.49. Output Formatters
ValueSummary

-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

Expand
Table 48.50. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.51. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.52. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.17. network flavor profile create

Usage:

openstack network flavor profile create [-h]

                                             [-f {json,shell,table,value,yaml}]
                                             [-c COLUMN]
                                             [--max-width <integer>]
                                             [--fit-width] [--print-empty]
                                             [--noindent] [--prefix PREFIX]
                                             [--project <project>]
                                             [--project-domain <project-domain>]
                                             [--description <description>]
                                             [--enable | --disable]
                                             [--driver DRIVER]
                                             [--metainfo METAINFO]

Create new network flavor profile

Expand
Table 48.53. Optional Arguments
ValueSummary

-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

Expand
Table 48.54. Output Formatters
ValueSummary

-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

Expand
Table 48.55. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.56. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.57. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.18. network flavor profile delete

Usage:

openstack network flavor profile delete [-h]

                                             <flavor-profile>
                                             [<flavor-profile> ...]

Delete network flavor profile

Expand
Table 48.58. Positional Arguments
ValueSummary

<flavor-profile>

Flavor profile(s) to delete (id only)

Expand
Table 48.59. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.19. network flavor profile list

Usage:

openstack network flavor profile list [-h]

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

List network flavor profile(s)

Expand
Table 48.60. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.61. Output Formatters
ValueSummary

-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

Expand
Table 48.62. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.63. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.64. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.20. network flavor profile set

Usage:

openstack network flavor profile set [-h]

                                          [--project-domain <project-domain>]
                                          [--description <description>]
                                          [--enable | --disable]
                                          [--driver DRIVER]
                                          [--metainfo METAINFO]
                                          <flavor-profile>

Set network flavor profile properties

Expand
Table 48.65. Positional Arguments
ValueSummary

<flavor-profile>

Flavor profile to update (id only)

Expand
Table 48.66. Optional Arguments
ValueSummary

-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

48.21. network flavor profile show

Usage:

openstack network flavor profile show [-h]

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

Display network flavor profile details

Expand
Table 48.67. Positional Arguments
ValueSummary

<flavor-profile>

Flavor profile to display (id only)

Expand
Table 48.68. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.69. Output Formatters
ValueSummary

-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

Expand
Table 48.70. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.71. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.72. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.22. network flavor remove profile

Usage:

openstack network flavor remove profile [-h] <flavor> <service-profile>

Remove service profile from network flavor

Expand
Table 48.73. Positional Arguments
ValueSummary

<flavor>

Network flavor (name or id)

<service-profile>

Service profile (id only)

Expand
Table 48.74. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.23. network flavor set

Usage:

openstack network flavor set [-h] [--description DESCRIPTION]

                                  [--disable | --enable] [--name <name>]
                                  <flavor>

Set network flavor properties

Expand
Table 48.75. Positional Arguments
ValueSummary

<flavor>

Flavor to update (name or id)

Expand
Table 48.76. Optional Arguments
ValueSummary

-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

48.24. network flavor show

Usage:

openstack network flavor show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <flavor>

Display network flavor details

Expand
Table 48.77. Positional Arguments
ValueSummary

<flavor>

Flavor to display (name or id)

Expand
Table 48.78. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.79. Output Formatters
ValueSummary

-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

Expand
Table 48.80. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.81. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.82. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.25. network list

Usage:

openstack network list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--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>,...]]

List networks

Expand
Table 48.83. Optional Arguments
ValueSummary

-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)

Expand
Table 48.84. Output Formatters
ValueSummary

-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

Expand
Table 48.85. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.86. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.87. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.26. network log create

Usage:

openstack network log create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  [--description <description>]
                                  [--enable | --disable]
                                  [--project <project>]
                                  [--project-domain <project-domain>]
                                  [--event <event>] --resource-type
                                  <resource-type> [--resource <resource>]
                                  [--target <target>]
                                  <name>

Create a new network log

Expand
Table 48.88. Positional Arguments
ValueSummary

<name>

Name for the network log

Expand
Table 48.89. Optional Arguments
ValueSummary

-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 resource list

--resource <resource>

Security group (name or ID) 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.

Expand
Table 48.90. Output Formatters
ValueSummary

-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

Expand
Table 48.91. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.92. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.93. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

48.27. network log delete

Usage:

openstack network log delete [-h] <network-log> [<network-log> ...]

Delete network log(s)

Expand
Table 48.94. Positional Arguments
ValueSummary

<network-log>

Network log(s) to delete (name or id)

Expand
Table 48.95. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

48.28. network log list

Usage:

openstack network log list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN] [--long]

List network logs

Expand
Table 48.96. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 48.97. Output Formatters
ValueSummary

-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

Expand
Table 48.98. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.99. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.100. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

48.29. network log set

Usage:

openstack network log set [-h] [--description <description>]

                               [--enable | --disable] [--name <name>]
                               <network-log>

Set network log properties

Expand
Table 48.101. Positional Arguments
ValueSummary

<network-log>

Network log to set (name or id)

Expand
Table 48.102. Optional Arguments
ValueSummary

-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

This command is provided by the python-neutronclient plugin.

48.30. network log show

Usage:

openstack network log show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <network-log>

Display network log details

Expand
Table 48.103. Positional Arguments
ValueSummary

<network-log>

Network log to show (name or id)

Expand
Table 48.104. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.105. Output Formatters
ValueSummary

-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

Expand
Table 48.106. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.107. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.108. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

48.31. network loggable resources list

Usage:

openstack network loggable resources list [-h]

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

List supported loggable resources

Expand
Table 48.109. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 48.110. Output Formatters
ValueSummary

-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

Expand
Table 48.111. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.112. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.113. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

48.32. network meter create

Usage:

openstack network meter create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--description <description>]
                                    [--project <project>]
                                    [--project-domain <project-domain>]
                                    [--share | --no-share]
                                    <name>

Create network meter

Expand
Table 48.114. Positional Arguments
ValueSummary

<name>

Name of meter

Expand
Table 48.115. Optional Arguments
ValueSummary

-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

Expand
Table 48.116. Output Formatters
ValueSummary

-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

Expand
Table 48.117. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.118. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.119. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.33. network meter delete

Usage:

openstack network meter delete [-h] <meter> [<meter> ...]

Delete network meter

Expand
Table 48.120. Positional Arguments
ValueSummary

<meter>

Meter to delete (name or id)

Expand
Table 48.121. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.34. network meter list

Usage:

openstack network meter list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN]

List network meters

Expand
Table 48.122. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.123. Output Formatters
ValueSummary

-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

Expand
Table 48.124. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.125. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.126. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.35. network meter rule create

Usage:

openstack network meter rule create [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--project <project>]
                                         [--project-domain <project-domain>]
                                         [--exclude | --include]
                                         [--ingress | --egress]
                                         --remote-ip-prefix
                                         <remote-ip-prefix>
                                         <meter>

Create a new meter rule

Expand
Table 48.127. Positional Arguments
ValueSummary

<meter>

Label to associate with this metering rule (name or ID)

Expand
Table 48.128. Optional Arguments
ValueSummary

-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

Expand
Table 48.129. Output Formatters
ValueSummary

-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

Expand
Table 48.130. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.131. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.132. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.36. network meter rule delete

Usage:

openstack network meter rule delete [-h]

                                         <meter-rule-id>
                                         [<meter-rule-id> ...]

Delete meter rule(s)

Expand
Table 48.133. Positional Arguments
ValueSummary

<meter-rule-id>

Meter rule to delete (id only)

Expand
Table 48.134. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.37. network meter rule list

Usage:

openstack network meter rule list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]

List meter rules

Expand
Table 48.135. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.136. Output Formatters
ValueSummary

-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

Expand
Table 48.137. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.138. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.139. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.38. network meter rule show

Usage:

openstack network meter rule show [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       <meter-rule-id>

Display meter rules details

Expand
Table 48.140. Positional Arguments
ValueSummary

<meter-rule-id>

Meter rule (id only)

Expand
Table 48.141. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.142. Output Formatters
ValueSummary

-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

Expand
Table 48.143. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.144. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.145. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.39. network meter show

Usage:

openstack network meter show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <meter>

Show network meter

Expand
Table 48.146. Positional Arguments
ValueSummary

<meter>

Meter to display (name or id)

Expand
Table 48.147. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.148. Output Formatters
ValueSummary

-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

Expand
Table 48.149. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.150. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.151. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.40. network qos policy create

Usage:

openstack network qos policy create [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--description <description>]
                                         [--share | --no-share]
                                         [--project <project>]
                                         [--project-domain <project-domain>]
                                         [--default | --no-default]
                                         <name>

Create a QoS policy

Expand
Table 48.152. Positional Arguments
ValueSummary

<name>

Name of qos policy to create

Expand
Table 48.153. Optional Arguments
ValueSummary

-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

Expand
Table 48.154. Output Formatters
ValueSummary

-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

Expand
Table 48.155. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.156. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.157. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.41. network qos policy delete

Usage:

openstack network qos policy delete [-h]

                                         <qos-policy> [<qos-policy> ...]

Delete Qos Policy(s)

Expand
Table 48.158. Positional Arguments
ValueSummary

<qos-policy>

Qos policy(s) to delete (name or id)

Expand
Table 48.159. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.42. network qos policy list

Usage:

openstack network qos policy list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       [--project <project>]
                                       [--project-domain <project-domain>]
                                       [--share | --no-share]

List QoS policies

Expand
Table 48.160. Optional Arguments
ValueSummary

-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

Expand
Table 48.161. Output Formatters
ValueSummary

-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

Expand
Table 48.162. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.163. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.164. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.43. network qos policy set

Usage:

openstack network qos policy set [-h] [--name <name>]

                                      [--description <description>]
                                      [--share | --no-share]
                                      [--default | --no-default]
                                      <qos-policy>

Set QoS policy properties

Expand
Table 48.165. Positional Arguments
ValueSummary

<qos-policy>

Qos policy to modify (name or id)

Expand
Table 48.166. Optional Arguments
ValueSummary

-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

48.44. network qos policy show

Usage:

openstack network qos policy show [-h]

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

Display QoS policy details

Expand
Table 48.167. Positional Arguments
ValueSummary

<qos-policy>

Qos policy to display (name or id)

Expand
Table 48.168. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.169. Output Formatters
ValueSummary

-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

Expand
Table 48.170. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.171. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.172. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.45. network qos rule create

Usage:

openstack network qos rule create [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       [--type <type>]
                                       [--max-kbps <max-kbps>]
                                       [--max-burst-kbits <max-burst-kbits>]
                                       [--dscp-mark <dscp-mark>]
                                       [--min-kbps <min-kbps>]
                                       [--ingress | --egress]
                                       <qos-policy>

Create new Network QoS rule

Expand
Table 48.173. Positional Arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

Expand
Table 48.174. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--type <type>

Qos rule type (dscp-marking, minimum-bandwidth, bandwidth-limit)

--max-kbps <max-kbps>

Maximum bandwidth in kbps

--max-burst-kbits <max-burst-kbits>

Maximum burst in kilobits, 0 means automatic

--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

Expand
Table 48.175. Output Formatters
ValueSummary

-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

Expand
Table 48.176. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.177. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.178. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.46. network qos rule delete

Usage:

openstack network qos rule delete [-h] <qos-policy> <rule-id>

Delete Network QoS rule

Expand
Table 48.179. Positional Arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

<rule-id>

Network qos rule to delete (id)

Expand
Table 48.180. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.47. network qos rule list

Usage:

openstack network qos rule list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     <qos-policy>

List Network QoS rules

Expand
Table 48.181. Positional Arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

Expand
Table 48.182. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.183. Output Formatters
ValueSummary

-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

Expand
Table 48.184. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.185. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.186. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.48. network qos rule set

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>

Set Network QoS rule properties

Expand
Table 48.187. Positional Arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

<rule-id>

Network qos rule to delete (id)

Expand
Table 48.188. Optional Arguments
ValueSummary

-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 means automatic

--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

48.49. network qos rule show

Usage:

openstack network qos rule show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <qos-policy> <rule-id>

Display Network QoS rule details

Expand
Table 48.189. Positional Arguments
ValueSummary

<qos-policy>

Qos policy that contains the rule (name or id)

<rule-id>

Network qos rule to delete (id)

Expand
Table 48.190. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.191. Output Formatters
ValueSummary

-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

Expand
Table 48.192. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.193. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.194. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.50. network qos rule type list

Usage:

openstack network qos rule type list [-h]

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

List QoS rule types

Expand
Table 48.195. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.196. Output Formatters
ValueSummary

-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

Expand
Table 48.197. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.198. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.199. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.51. network qos rule type show

Usage:

openstack network qos rule type show [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          <qos-rule-type-name>

Show details about supported QoS rule type

Expand
Table 48.200. Positional Arguments
ValueSummary

<qos-rule-type-name>

Name of qos rule type

Expand
Table 48.201. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.202. Output Formatters
ValueSummary

-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

Expand
Table 48.203. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.204. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.205. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.52. network rbac create

Usage:

openstack network rbac create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX] --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>

Create network RBAC policy

Expand
Table 48.206. Positional Arguments
ValueSummary

<rbac-object>

The object to which this rbac policy affects (name or ID)

Expand
Table 48.207. Optional Arguments
ValueSummary

-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.

Expand
Table 48.208. Output Formatters
ValueSummary

-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

Expand
Table 48.209. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.210. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.211. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.53. network rbac delete

Usage:

openstack network rbac delete [-h] <rbac-policy> [<rbac-policy> ...]

Delete network RBAC policy(s)

Expand
Table 48.212. Positional Arguments
ValueSummary

<rbac-policy>

Rbac policy(s) to delete (id only)

Expand
Table 48.213. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.54. network rbac list

Usage:

openstack network rbac list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN] [--type <type>]
                                 [--action <action>] [--long]

List network RBAC policies

Expand
Table 48.214. Optional Arguments
ValueSummary

-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

Expand
Table 48.215. Output Formatters
ValueSummary

-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

Expand
Table 48.216. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.217. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.218. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.55. network rbac set

Usage:

openstack network rbac set [-h] [--target-project <target-project>]

                                [--target-project-domain <target-project-domain>]
                                <rbac-policy>

Set network RBAC policy properties

Expand
Table 48.219. Positional Arguments
ValueSummary

<rbac-policy>

Rbac policy to be modified (id only)

Expand
Table 48.220. Optional Arguments
ValueSummary

-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.

48.56. network rbac show

Usage:

openstack network rbac show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 <rbac-policy>

Display network RBAC policy details

Expand
Table 48.221. Positional Arguments
ValueSummary

<rbac-policy>

Rbac policy (id only)

Expand
Table 48.222. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.223. Output Formatters
ValueSummary

-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

Expand
Table 48.224. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.225. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.226. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.57. network segment create

Usage:

openstack network segment create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--description <description>]
                                      [--physical-network <physical-network>]
                                      [--segment <segment>] --network
                                      <network> --network-type
                                      <network-type>
                                      <name>

Create new network segment

Expand
Table 48.227. Positional Arguments
ValueSummary

<name>

New network segment name

Expand
Table 48.228. Optional Arguments
ValueSummary

-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)

Expand
Table 48.229. Output Formatters
ValueSummary

-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

Expand
Table 48.230. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.231. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.232. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.58. network segment delete

Usage:

openstack network segment delete [-h]

                                      <network-segment>
                                      [<network-segment> ...]

Delete network segment(s)

Expand
Table 48.233. Positional Arguments
ValueSummary

<network-segment>

Network segment(s) to delete (name or id)

Expand
Table 48.234. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

48.59. network segment list

Usage:

openstack network segment list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN] [--long]
                                    [--network <network>]

List network segments

Expand
Table 48.235. Optional Arguments
ValueSummary

-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)

Expand
Table 48.236. Output Formatters
ValueSummary

-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

Expand
Table 48.237. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.238. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.239. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.60. network segment set

Usage:

openstack network segment set [-h] [--description <description>]

                                   [--name <name>]
                                   <network-segment>

Set network segment properties

Expand
Table 48.240. Positional Arguments
ValueSummary

<network-segment>

Network segment to modify (name or id)

Expand
Table 48.241. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Set network segment description

--name <name>

Set network segment name

48.61. network segment show

Usage:

openstack network segment show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <network-segment>

Display network segment details

Expand
Table 48.242. Positional Arguments
ValueSummary

<network-segment>

Network segment to display (name or id)

Expand
Table 48.243. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.244. Output Formatters
ValueSummary

-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

Expand
Table 48.245. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.246. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.247. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.62. network service provider list

Usage:

openstack network service provider list [-h]

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

List Service Providers

Expand
Table 48.248. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.249. Output Formatters
ValueSummary

-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

Expand
Table 48.250. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.251. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.252. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

48.63. network set

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>]
                           <network>

Set network properties

Expand
Table 48.253. Positional Arguments
ValueSummary

<network>

Network to modify (name or id)

Expand
Table 48.254. Optional Arguments
ValueSummary

-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

48.64. network show

Usage:

openstack network show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX]
                            <network>

Show network details

Expand
Table 48.255. Positional Arguments
ValueSummary

<network>

Network to display (name or id)

Expand
Table 48.256. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.257. Output Formatters
ValueSummary

-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

Expand
Table 48.258. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.259. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.260. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

48.65. network subport list

Usage:

openstack network subport list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN] --trunk
                                    <trunk>

List all subports for a given network trunk

Expand
Table 48.261. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--trunk <trunk>

List subports belonging to this trunk (name or id)

Expand
Table 48.262. Output Formatters
ValueSummary

-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

Expand
Table 48.263. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.264. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.265. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

48.66. network trunk create

Usage:

openstack network trunk create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--description <description>]
                                    --parent-port <parent-port>
                                    [--subport <port=,segmentation-type=,segmentation-id=>]
                                    [--enable | --disable]
                                    [--project <project>]
                                    [--project-domain <project-domain>]
                                    <name>

Create a network trunk for a given project

Expand
Table 48.266. Positional Arguments
ValueSummary

<name>

Name of the trunk to create

Expand
Table 48.267. Optional Arguments
ValueSummary

-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.

Expand
Table 48.268. Output Formatters
ValueSummary

-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

Expand
Table 48.269. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.270. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.271. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

48.67. network trunk delete

Usage:

openstack network trunk delete [-h] <trunk> [<trunk> ...]

Delete a given network trunk

Expand
Table 48.272. Positional Arguments
ValueSummary

<trunk>

Trunk(s) to delete (name or id)

Expand
Table 48.273. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

48.68. network trunk list

Usage:

openstack network trunk list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN] [--long]

List all network trunks

Expand
Table 48.274. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 48.275. Output Formatters
ValueSummary

-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

Expand
Table 48.276. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.277. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.278. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

48.69. network trunk set

Usage:

openstack network trunk set [-h] [--name <name>]

                                 [--description <description>]
                                 [--subport <port=,segmentation-type=,segmentation-id=>]
                                 [--enable | --disable]
                                 <trunk>

Set network trunk properties

Expand
Table 48.279. Positional Arguments
ValueSummary

<trunk>

Trunk to modify (name or id)

Expand
Table 48.280. Optional Arguments
ValueSummary

-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

This command is provided by the python-neutronclient plugin.

48.70. network trunk show

Usage:

openstack network trunk show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <trunk>

Show information of a given network trunk

Expand
Table 48.281. Positional Arguments
ValueSummary

<trunk>

Trunk to display (name or id)

Expand
Table 48.282. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 48.283. Output Formatters
ValueSummary

-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

Expand
Table 48.284. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 48.285. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 48.286. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

48.71. network trunk unset

Usage:

openstack network trunk unset [-h] --subport <subport> <trunk>

Unset subports from a given network trunk

Expand
Table 48.287. Positional Arguments
ValueSummary

<trunk>

Unset subports from this trunk (name or id)

Expand
Table 48.288. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--subport <subport>

Subport to delete (name or id of the port) (--subport) option can be repeated

This command is provided by the python-neutronclient plugin.

48.72. network unset

Usage:

openstack network unset [-h] [--tag <tag> | --all-tag] <network>

Unset network properties

Expand
Table 48.289. Positional Arguments
ValueSummary

<network>

Network to modify (name or id)

Expand
Table 48.290. Optional Arguments
ValueSummary

-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 49. object

This chapter describes the commands under the object command.

49.1. object create

Usage:

openstack object create [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN] [--name <name>]
                             <container> <filename> [<filename> ...]

Upload object to container

Expand
Table 49.1. Positional Arguments
ValueSummary

<container>

Container for new object

<filename>

Local filename(s) to upload

Expand
Table 49.2. Optional Arguments
ValueSummary

-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

Expand
Table 49.3. Output Formatters
ValueSummary

-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

Expand
Table 49.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 49.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 49.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

49.2. object delete

Usage:

openstack object delete [-h] <container> <object> [<object> ...]

Delete object from container

Expand
Table 49.7. Positional Arguments
ValueSummary

<container>

Delete object(s) from <container>

<object>

Object(s) to delete

Expand
Table 49.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

49.3. object list

Usage:

openstack object list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--prefix <prefix>]
                           [--delimiter <delimiter>] [--marker <marker>]
                           [--end-marker <end-marker>]
                           [--limit <num-objects>] [--long] [--all]
                           <container>

List objects

Expand
Table 49.9. Positional Arguments
ValueSummary

<container>

Container to list

Expand
Table 49.10. Optional Arguments
ValueSummary

-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)

Expand
Table 49.11. Output Formatters
ValueSummary

-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

Expand
Table 49.12. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 49.13. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 49.14. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

49.4. object save

Usage:

openstack object save [-h] [--file <filename>] <container> <object>

Save object locally

Expand
Table 49.15. Positional Arguments
ValueSummary

<container>

Download <object> from <container>

<object>

Object to save

Expand
Table 49.16. Optional Arguments
ValueSummary

-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

49.5. object set

Usage:

openstack object set [-h] --property <key=value> <container> <object>

Set object properties

Expand
Table 49.17. Positional Arguments
ValueSummary

<container>

Modify <object> from <container>

<object>

Object to modify

Expand
Table 49.18. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key=value>

Set a property on this object (repeat option to set multiple properties)

49.6. object show

Usage:

openstack object show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           <container> <object>

Display object details

Expand
Table 49.19. Positional Arguments
ValueSummary

<container>

Display <object> from <container>

<object>

Object to display

Expand
Table 49.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 49.21. Output Formatters
ValueSummary

-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

Expand
Table 49.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 49.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 49.24. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

49.7. object store account set

Usage:

openstack object store account set [-h] --property <key=value>

Set account properties

Expand
Table 49.25. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key=value>

Set a property on this account (repeat option to set multiple properties)

49.8. object store account show

Usage:

openstack object store account show [-h]

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

Display account details

Expand
Table 49.26. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 49.27. Output Formatters
ValueSummary

-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

Expand
Table 49.28. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 49.29. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 49.30. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

49.9. object store account unset

Usage:

openstack object store account unset [-h] --property <key>

Unset account properties

Expand
Table 49.31. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from account (repeat option to remove multiple properties)

49.10. object unset

Usage:

openstack object unset [-h] --property <key> <container> <object>

Unset object properties

Expand
Table 49.32. Positional Arguments
ValueSummary

<container>

Modify <object> from <container>

<object>

Object to modify

Expand
Table 49.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from object (repeat option to remove multiple properties)

Chapter 50. orchestration

This chapter describes the commands under the orchestration command.

50.1. orchestration build info

Usage:

openstack orchestration build info [-h]

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

Retrieve build information.

Expand
Table 50.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 50.2. Output Formatters
ValueSummary

-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

Expand
Table 50.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

50.2. orchestration resource type list

Usage:

openstack orchestration resource type list [-h]

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

List resource types.

Expand
Table 50.6. Optional Arguments
ValueSummary

-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.

Expand
Table 50.7. Output Formatters
ValueSummary

-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

Expand
Table 50.8. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.9. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.10. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

50.3. orchestration resource type show

Usage:

openstack orchestration resource type show [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                [--template-type <template-type>]
                                                [--long]
                                                <resource-type>

Show details and optionally generate a template for a resource type.

Expand
Table 50.11. Positional Arguments
ValueSummary

<resource-type>

Resource type to show details for

Expand
Table 50.12. Optional Arguments
ValueSummary

-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.

Expand
Table 50.13. Output Formatters
ValueSummary

-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

Expand
Table 50.14. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.15. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.16. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

50.4. orchestration service list

Usage:

openstack orchestration service list [-h]

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

List the Heat engines.

Expand
Table 50.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 50.18. Output Formatters
ValueSummary

-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

Expand
Table 50.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.21. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

50.5. orchestration template function list

Usage:

openstack orchestration template function list [-h]

                                                    [-f {csv,json,table,value,yaml}]
                                                    [-c COLUMN]
                                                    [--max-width <integer>]
                                                    [--fit-width]
                                                    [--print-empty]
                                                    [--noindent]
                                                    [--quote {all,minimal,none,nonnumeric}]
                                                    [--sort-column SORT_COLUMN]
                                                    [--with_conditions]
                                                    <template-version>

List the available functions.

Expand
Table 50.22. Positional Arguments
ValueSummary

<template-version>

Template version to get the functions for

Expand
Table 50.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--with_conditions

Show condition functions for template.

Expand
Table 50.24. Output Formatters
ValueSummary

-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

Expand
Table 50.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.27. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

50.6. orchestration template validate

Usage:

openstack orchestration template validate [-h]

                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--prefix PREFIX]
                                               [-e <environment>]
                                               [--show-nested]
                                               [--parameter <key=value>]
                                               [--ignore-errors <error1,error2,...>]
                                               -t <template>

Validate a template

Expand
Table 50.28. Optional Arguments
ValueSummary

-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

Expand
Table 50.29. Output Formatters
ValueSummary

-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

Expand
Table 50.30. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.31. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.32. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

50.7. orchestration template version list

Usage:

openstack orchestration template version list [-h]

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

List the available template versions.

Expand
Table 50.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 50.34. Output Formatters
ValueSummary

-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

Expand
Table 50.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 50.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 50.37. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

Chapter 51. port

This chapter describes the commands under the port command.

51.1. port create

Usage:

openstack port create [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           --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] [--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>

Create a new port

Expand
Table 51.1. Positional Arguments
ValueSummary

<name>

Name of this port

Expand
Table 51.2. Optional Arguments
ValueSummary

-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 to 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

--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

Expand
Table 51.3. Output Formatters
ValueSummary

-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

Expand
Table 51.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 51.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 51.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

51.2. port delete

Usage:

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

Delete port(s)

Expand
Table 51.7. Positional Arguments
ValueSummary

<port>

Port(s) to delete (name or id)

Expand
Table 51.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

51.3. port list

Usage:

openstack port list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--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>,...]]

List ports

Expand
Table 51.9. Optional Arguments
ValueSummary

-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)

Expand
Table 51.10. Output Formatters
ValueSummary

-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

Expand
Table 51.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 51.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 51.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

51.4. port set

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>

Set port properties

Expand
Table 51.14. Positional Arguments
ValueSummary

<port>

Port to modify (name or id)

Expand
Table 51.15. Optional Arguments
ValueSummary

-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 to 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 associatedwith this port.(Specify both --allowed-address and --no- allowed-addressto 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

 

51.5. port show

Usage:

openstack port show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent] [--prefix PREFIX]
                         <port>

Display port details

Expand
Table 51.16. Positional Arguments
ValueSummary

<port>

Port to display (name or id)

Expand
Table 51.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 51.18. Output Formatters
ValueSummary

-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

Expand
Table 51.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 51.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 51.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

51.6. port unset

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>

Unset port properties

Expand
Table 51.22. Positional Arguments
ValueSummary

<port>

Port to modify (name or id)

Expand
Table 51.23. Optional Arguments
ValueSummary

-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 set 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 52. project

This chapter describes the commands under the project command.

52.1. project create

Usage:

openstack project create [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              [--description <description>]
                              [--enable | --disable]
                              [--property <key=value>] [--or-show]
                              <project-name>

Create new project

Expand
Table 52.1. Positional Arguments
ValueSummary

<project-name>

New project name

Expand
Table 52.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Project description

--enable

Enable project (default)

--disable

Disable project

--property <key=value>

Add a property to <name> (repeat option to set multiple properties)

--or-show

Return existing project

Expand
Table 52.3. Output Formatters
ValueSummary

-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

Expand
Table 52.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 52.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 52.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

52.2. project delete

Usage:

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

Delete project(s)

Expand
Table 52.7. Positional Arguments
ValueSummary

<project>

Project(s) to delete (name or id)

Expand
Table 52.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

52.3. project list

Usage:

openstack project list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--long]
                            [--sort <key>[:<direction>]]

List projects

Expand
Table 52.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--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.

Expand
Table 52.10. Output Formatters
ValueSummary

-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

Expand
Table 52.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 52.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 52.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

52.4. project purge

Usage:

openstack project purge [-h] [--dry-run] [--keep-project]

                             (--auth-project | --project <project>)
                             [--project-domain <project-domain>]

Clean resources associated with a project

Expand
Table 52.14. Optional Arguments
ValueSummary

-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.

52.5. project set

Usage:

openstack project set [-h] [--name <name>]

                           [--description <description>]
                           [--enable | --disable] [--property <key=value>]
                           <project>

Set project properties

Expand
Table 52.15. Positional Arguments
ValueSummary

<project>

Project to modify (name or id)

Expand
Table 52.16. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set project name

--description <description>

Set project description

--enable

Enable project

--disable

Disable project

--property <key=value>

Set a project property (repeat option to set multiple properties)

52.6. project show

Usage:

openstack project show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX]
                            <project>

Display project details

Expand
Table 52.17. Positional Arguments
ValueSummary

<project>

Project to display (name or id)

Expand
Table 52.18. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 52.19. Output Formatters
ValueSummary

-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

Expand
Table 52.20. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 52.21. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 52.22. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

52.7. project unset

Usage:

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

Unset project properties

Expand
Table 52.23. Positional Arguments
ValueSummary

<project>

Project to modify (name or id)

Expand
Table 52.24. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Unset a project property (repeat option to unset multiple properties)

Chapter 53. ptr

This chapter describes the commands under the ptr command.

53.1. ptr record list

Usage:

openstack ptr record list [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN] [--all-projects]
                               [--edit-managed]
                               [--sudo-project-id SUDO_PROJECT_ID]

List floatingip ptr records

Expand
Table 53.1. Optional Arguments
ValueSummary

-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

Expand
Table 53.2. Output Formatters
ValueSummary

-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

Expand
Table 53.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 53.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 53.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

53.2. ptr record set

Usage:

openstack ptr record set [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX]
                              [--description DESCRIPTION | --no-description]
                              [--ttl TTL | --no-ttl] [--all-projects]
                              [--edit-managed]
                              [--sudo-project-id SUDO_PROJECT_ID]
                              floatingip_id ptrdname

Set floatingip ptr record

Expand
Table 53.6. Positional Arguments
ValueSummary

floatingip_id

Floating ip id in format region:floatingip_id

ptrdname

Ptrd name

Expand
Table 53.7. Optional Arguments
ValueSummary

-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

Expand
Table 53.8. Output Formatters
ValueSummary

-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

Expand
Table 53.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 53.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 53.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

53.3. ptr record show

Usage:

openstack ptr record show [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] [--all-projects]
                               [--edit-managed]
                               [--sudo-project-id SUDO_PROJECT_ID]
                               floatingip_id

Show floatingip ptr record details

Expand
Table 53.12. Positional Arguments
ValueSummary

floatingip_id

Floating ip id in format region:floatingip_id

Expand
Table 53.13. Optional Arguments
ValueSummary

-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

Expand
Table 53.14. Output Formatters
ValueSummary

-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

Expand
Table 53.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 53.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 53.17. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

53.4. ptr record unset

Usage:

openstack ptr record unset [-h] [--all-projects] [--edit-managed]

                                [--sudo-project-id SUDO_PROJECT_ID]
                                floatingip_id

Unset floatingip ptr record

Expand
Table 53.18. Positional Arguments
ValueSummary

floatingip_id

Floating ip id in format region:floatingip_id

Expand
Table 53.19. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

Chapter 54. quota

This chapter describes the commands under the quota command.

54.1. quota list

Usage:

openstack quota list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                          [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}]
                          [--sort-column SORT_COLUMN] [--project <project>]
                          [--detail] (--compute | --volume | --network)

List quotas for all projects with non-default quota values or list detailed quota informations for requested project

Expand
Table 54.1. Optional Arguments
ValueSummary

-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

Expand
Table 54.2. Output Formatters
ValueSummary

-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

Expand
Table 54.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 54.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 54.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

54.2. quota set

Usage:

openstack quota set [-h] [--class] [--properties <properties>]

                         [--server-groups <server-groups>] [--ram <ram>]
                         [--key-pairs <key-pairs>] [--instances <instances>]
                         [--fixed-ips <fixed-ips>]
                         [--injected-file-size <injected-file-size>]
                         [--server-group-members <server-group-members>]
                         [--injected-files <injected-files>]
                         [--cores <cores>]
                         [--injected-path-size <injected-path-size>]
                         [--per-volume-gigabytes <per-volume-gigabytes>]
                         [--gigabytes <gigabytes>]
                         [--backup-gigabytes <backup-gigabytes>]
                         [--snapshots <snapshots>] [--volumes <volumes>]
                         [--backups <backups>] [--l7policies <l7policies>]
                         [--subnetpools <subnetpools>] [--vips <vips>]
                         [--ports <ports>] [--subnets <subnets>]
                         [--networks <networks>]
                         [--floating-ips <floating-ips>]
                         [--secgroup-rules <secgroup-rules>]
                         [--health-monitors <health-monitors>]
                         [--secgroups <secgroups>] [--routers <routers>]
                         [--rbac-policies <rbac-policies>]
                         [--volume-type <volume-type>]
                         <project/class>

Set quotas for project or class

Expand
Table 54.6. Positional Arguments
ValueSummary

<project/class>

Set quotas for this project or class (name/id)

Expand
Table 54.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--class

Set quotas for <class>

--properties <properties>

New value for the properties quota

--server-groups <server-groups>

New value for the server-groups quota

--ram <ram>

New value for the ram quota

--key-pairs <key-pairs>

New value for the key-pairs quota

--instances <instances>

New value for the instances 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

--server-group-members <server-group-members>

New value for the server-group-members quota

--injected-files <injected-files>

New value for the injected-files quota

--cores <cores>

New value for the cores quota

--injected-path-size <injected-path-size>

New value for the injected-path-size quota

--per-volume-gigabytes <per-volume-gigabytes>

New value for the per-volume-gigabytes quota

--gigabytes <gigabytes>

New value for the gigabytes quota

--backup-gigabytes <backup-gigabytes>

New value for the backup-gigabytes quota

--snapshots <snapshots>

New value for the snapshots quota

--volumes <volumes>

New value for the volumes quota

--backups <backups>

New value for the backups quota

--l7policies <l7policies>

New value for the l7policies quota

--subnetpools <subnetpools>

New value for the subnetpools quota

--vips <vips>

New value for the vips quota

--ports <ports>

New value for the ports quota

--subnets <subnets>

New value for the subnets quota

--networks <networks>

New value for the networks quota

--floating-ips <floating-ips>

New value for the floating-ips quota

--secgroup-rules <secgroup-rules>

New value for the secgroup-rules quota

--health-monitors <health-monitors>

New value for the health-monitors quota

--secgroups <secgroups>

New value for the secgroups quota

--routers <routers>

New value for the routers quota

--rbac-policies <rbac-policies>

New value for the rbac-policies quota

--volume-type <volume-type>

Set quotas for a specific <volume-type>

54.3. quota show

Usage:

openstack quota show [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          [--class | --default]
                          [<project/class>]

Show quotas for project or class

Expand
Table 54.8. Positional Arguments
ValueSummary

<project/class>

Show quotas for this project or class (name or id)

Expand
Table 54.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--class

Show quotas for <class>

--default

Show default quotas for <project>

Expand
Table 54.10. Output Formatters
ValueSummary

-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

Expand
Table 54.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 54.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 54.13. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 55. recordset

This chapter describes the commands under the recordset command.

55.1. recordset create

Usage:

openstack recordset create [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX] --record RECORD --type
                                TYPE [--ttl TTL] [--description DESCRIPTION]
                                [--all-projects] [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]
                                zone_id name

Create new recordset

Expand
Table 55.1. Positional Arguments
ValueSummary

zone_id

Zone id

name

Recordset name

Expand
Table 55.2. Optional Arguments
ValueSummary

-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

Expand
Table 55.3. Output Formatters
ValueSummary

-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

Expand
Table 55.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 55.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 55.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

55.2. recordset delete

Usage:

openstack recordset delete [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]
                                zone_id id

Delete recordset

Expand
Table 55.7. Positional Arguments
ValueSummary

zone_id

Zone id

id

Recordset id

Expand
Table 55.8. Optional Arguments
ValueSummary

-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

Expand
Table 55.9. Output Formatters
ValueSummary

-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

Expand
Table 55.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 55.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 55.12. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

55.3. recordset list

Usage:

openstack recordset list [-h] [-f {csv,json,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--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

List recordsets

Expand
Table 55.13. Positional Arguments
ValueSummary

zone_id

Zone id. to list all recordsets specify 'all'

Expand
Table 55.14. Optional Arguments
ValueSummary

-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

Expand
Table 55.15. Output Formatters
ValueSummary

-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

Expand
Table 55.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 55.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 55.18. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

55.4. recordset set

Usage:

openstack recordset set [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--record RECORD]
                             [--description DESCRIPTION | --no-description]
                             [--ttl TTL | --no-ttl] [--all-projects]
                             [--edit-managed]
                             [--sudo-project-id SUDO_PROJECT_ID]
                             zone_id id

Set recordset properties

Expand
Table 55.19. Positional Arguments
ValueSummary

zone_id

Zone id

id

Recordset id

Expand
Table 55.20. Optional Arguments
ValueSummary

-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

Expand
Table 55.21. Output Formatters
ValueSummary

-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

Expand
Table 55.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 55.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 55.24. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

55.5. recordset show

Usage:

openstack recordset show [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX] [--all-projects]
                              [--edit-managed]
                              [--sudo-project-id SUDO_PROJECT_ID]
                              zone_id id

Show recordset details

Expand
Table 55.25. Positional Arguments
ValueSummary

zone_id

Zone id

id

Recordset id

Expand
Table 55.26. Optional Arguments
ValueSummary

-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

Expand
Table 55.27. Output Formatters
ValueSummary

-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

Expand
Table 55.28. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 55.29. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 55.30. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

Chapter 56. resource

This chapter describes the commands under the resource command.

56.1. resource member create

Usage:

openstack resource member create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      resource_id resource_type member_id

Shares a resource to another tenant.

Expand
Table 56.1. Positional Arguments
ValueSummary

resource_id

Resource id to be shared.

resource_type

Resource type.

member_id

Project id to whom the resource is shared to.

Expand
Table 56.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 56.3. Output Formatters
ValueSummary

-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

Expand
Table 56.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 56.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 56.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

56.2. resource member delete

Usage:

openstack resource member delete [-h] resource resource_type member_id

Delete a resource sharing relationship.

Expand
Table 56.7. Positional Arguments
ValueSummary

resource

Resource id to be shared.

resource_type

Resource type.

member_id

Project id to whom the resource is shared to.

Expand
Table 56.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

56.3. resource member list

Usage:

openstack resource member list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    resource_id resource_type

List all members.

Expand
Table 56.9. Positional Arguments
ValueSummary

resource_id

Resource id to be shared.

resource_type

Resource type.

Expand
Table 56.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 56.11. Output Formatters
ValueSummary

-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

Expand
Table 56.12. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 56.13. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 56.14. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

56.4. resource member show

Usage:

openstack resource member show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [-m MEMBER_ID]
                                    resource resource_type

Show specific member information.

Expand
Table 56.15. Positional Arguments
ValueSummary

resource

Resource id to be shared.

resource_type

Resource type.

Expand
Table 56.16. Optional Arguments
ValueSummary

-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.

Expand
Table 56.17. Output Formatters
ValueSummary

-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

Expand
Table 56.18. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 56.19. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 56.20. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

56.5. resource member update

Usage:

openstack resource member update [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [-m MEMBER_ID]
                                      [-s {pending,accepted,rejected}]
                                      resource_id resource_type

Update resource sharing status.

Expand
Table 56.21. Positional Arguments
ValueSummary

resource_id

Resource id to be shared.

resource_type

Resource type.

Expand
Table 56.22. Optional Arguments
ValueSummary

-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.

Expand
Table 56.23. Output Formatters
ValueSummary

-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

Expand
Table 56.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 56.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 56.26. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 57. role

This chapter describes the commands under the role command.

57.1. role add

Usage:

openstack role add [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                        [--max-width <integer>] [--fit-width]
                        [--print-empty] [--noindent] [--prefix PREFIX]
                        --project <project> --user <user>
                        <role>

Add role to project:user

Expand
Table 57.1. Positional Arguments
ValueSummary

<role>

Role to add to <project>:<user> (name or id)

Expand
Table 57.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Include <project> (name or id)

--user <user>

Include <user> (name or id)

Expand
Table 57.3. Output Formatters
ValueSummary

-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

Expand
Table 57.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 57.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 57.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

57.2. role assignment list

Usage:

openstack role assignment list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--user <user>] [--project <project>]
                                    [--names] [--auth-user] [--auth-project]

List role assignments

Expand
Table 57.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--user <user>

User to filter (name or id)

--project <project>

Project to filter (name or id)

--names

Display names instead of ids

--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

Expand
Table 57.8. Output Formatters
ValueSummary

-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

Expand
Table 57.9. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 57.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 57.11. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

57.3. role create

Usage:

openstack role create [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--or-show]
                           <name>

Create new role

Expand
Table 57.12. Positional Arguments
ValueSummary

<name>

New role name

Expand
Table 57.13. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--or-show

Return existing role

Expand
Table 57.14. Output Formatters
ValueSummary

-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

Expand
Table 57.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 57.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 57.17. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

57.4. role delete

Usage:

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

Delete role(s)

Expand
Table 57.18. Positional Arguments
ValueSummary

<role>

Role(s) to delete (name or id)

Expand
Table 57.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

57.5. role list

Usage:

openstack role list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--sort-column SORT_COLUMN] [--project <project>]
                         [--user <user>]

List roles

Expand
Table 57.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Filter roles by <project> (name or id)

--user <user>

Filter roles by <user> (name or id)

Expand
Table 57.21. Output Formatters
ValueSummary

-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

Expand
Table 57.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 57.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 57.24. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

57.6. role remove

Usage:

openstack role remove [-h] --project <project> --user <user> <role>

Remove role from project : user

Expand
Table 57.25. Positional Arguments
ValueSummary

<role>

Role to remove (name or id)

Expand
Table 57.26. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Include <project> (name or id)

--user <user>

Include <user> (name or id)

57.7. role show

Usage:

openstack role show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent] [--prefix PREFIX]
                         <role>

Display role details

Expand
Table 57.27. Positional Arguments
ValueSummary

<role>

Role to display (name or id)

Expand
Table 57.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 57.29. Output Formatters
ValueSummary

-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

Expand
Table 57.30. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 57.31. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 57.32. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 58. router

This chapter describes the commands under the router command.

58.1. router add port

Usage:

openstack router add port [-h] <router> <port>

Add a port to a router

Expand
Table 58.1. Positional Arguments
ValueSummary

<router>

Router to which port will be added (name or id)

<port>

Port to be added (name or id)

Expand
Table 58.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

58.2. router add subnet

Usage:

openstack router add subnet [-h] <router> <subnet>

Add a subnet to a router

Expand
Table 58.3. Positional Arguments
ValueSummary

<router>

Router to which subnet will be added (name or id)

<subnet>

Subnet to be added (name or id)

Expand
Table 58.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

58.3. router create

Usage:

openstack router create [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--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>

Create a new router

Expand
Table 58.5. Positional Arguments
ValueSummary

<name>

New router name

Expand
Table 58.6. Optional Arguments
ValueSummary

-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

Expand
Table 58.7. Output Formatters
ValueSummary

-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

Expand
Table 58.8. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 58.9. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 58.10. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

58.4. router delete

Usage:

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

Delete router(s)

Expand
Table 58.11. Positional Arguments
ValueSummary

<router>

Router(s) to delete (name or id)

Expand
Table 58.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

58.5. router list

Usage:

openstack router list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--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>,...]]

List routers

Expand
Table 58.13. Optional Arguments
ValueSummary

-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)

Expand
Table 58.14. Output Formatters
ValueSummary

-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

Expand
Table 58.15. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 58.16. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 58.17. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

58.6. router remove port

Usage:

openstack router remove port [-h] <router> <port>

Remove a port from a router

Expand
Table 58.18. Positional Arguments
ValueSummary

<router>

Router from which port will be removed (name or id)

<port>

Port to be removed and deleted (name or id)

Expand
Table 58.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

58.7. router remove subnet

Usage:

openstack router remove subnet [-h] <router> <subnet>

Remove a subnet from a router

Expand
Table 58.20. Positional Arguments
ValueSummary

<router>

Router from which the subnet will be removed (name or id)

<subnet>

Subnet to be removed (name or id)

Expand
Table 58.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

58.8. router set

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] [--tag <tag>]
                          [--no-tag]
                          <router>

Set router properties

Expand
Table 58.22. Positional Arguments
ValueSummary

<router>

Router to modify (name or id)

Expand
Table 58.23. Optional Arguments
ValueSummary

-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

--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

 

58.9. router show

Usage:

openstack router show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           <router>

Display router details

Expand
Table 58.24. Positional Arguments
ValueSummary

<router>

Router to display (name or id)

Expand
Table 58.25. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 58.26. Output Formatters
ValueSummary

-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

Expand
Table 58.27. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 58.28. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 58.29. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

58.10. router unset

Usage:

openstack router unset [-h]

                            [--route destination=<subnet>,gateway=<ip-address>]
                            [--external-gateway] [--tag <tag> | --all-tag]
                            <router>

Unset router properties

Expand
Table 58.30. Positional Arguments
ValueSummary

<router>

Router to modify (name or id)

Expand
Table 58.31. Optional Arguments
ValueSummary

-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

--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 59. secret

This chapter describes the commands under the secret command.

59.1. secret container create

Usage:

openstack secret container create [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       [--name NAME] [--type TYPE]
                                       [--secret SECRET]

Store a container in Barbican.

Expand
Table 59.1. Optional Arguments
ValueSummary

-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"

Expand
Table 59.2. Output Formatters
ValueSummary

-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

Expand
Table 59.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

59.2. secret container delete

Usage:

openstack secret container delete [-h] URI

Delete a container by providing its href.

Expand
Table 59.6. Positional Arguments
ValueSummary

URI

The uri reference for the container

Expand
Table 59.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-barbicanclient plugin.

59.3. secret container get

Usage:

openstack secret container get [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    URI

Retrieve a container by providing its URI.

Expand
Table 59.8. Positional Arguments
ValueSummary

URI

The uri reference for the container.

Expand
Table 59.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 59.10. Output Formatters
ValueSummary

-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

Expand
Table 59.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.13. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

59.4. secret container list

Usage:

openstack secret container list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN]
                                     [--limit LIMIT] [--offset OFFSET]
                                     [--name NAME] [--type TYPE]

List containers.

Expand
Table 59.14. Optional Arguments
ValueSummary

-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).

Expand
Table 59.15. Output Formatters
ValueSummary

-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

Expand
Table 59.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.18. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

59.5. secret delete

Usage:

openstack secret delete [-h] URI

Delete a secret by providing its URI.

Expand
Table 59.19. Positional Arguments
ValueSummary

URI

The uri reference for the secret

Expand
Table 59.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-barbicanclient plugin.

59.6. secret get

Usage:

openstack secret get [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          [--decrypt | --payload | --file <filename>]
                          [--payload_content_type PAYLOAD_CONTENT_TYPE]
                          URI

Retrieve a secret by providing its URI.

Expand
Table 59.21. Positional Arguments
ValueSummary

URI

The uri reference for the secret.

Expand
Table 59.22. Optional Arguments
ValueSummary

-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).

Expand
Table 59.23. Output Formatters
ValueSummary

-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

Expand
Table 59.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.26. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

59.7. secret list

Usage:

openstack secret list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--limit LIMIT]
                           [--offset OFFSET] [--name NAME]
                           [--algorithm ALGORITHM] [--bit-length BIT_LENGTH]
                           [--mode MODE] [--secret-type SECRET_TYPE]

List secrets.

Expand
Table 59.27. Optional Arguments
ValueSummary

-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 secret name (default: none)

--algorithm ALGORITHM, -a ALGORITHM

the algorithm filter for the list(default: None).

--bit-length BIT_LENGTH, -b BIT_LENGTH

the bit length filter for the list (default: 0).

--mode MODE, -m MODE

The algorithm mode filter for the list (default: None).

--secret-type SECRET_TYPE, -s SECRET_TYPE

specify the secret type (default: None).

Expand
Table 59.28. Output Formatters
ValueSummary

-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

Expand
Table 59.29. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.30. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.31. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

59.8. secret order create

Usage:

openstack secret order create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--name NAME] [--algorithm ALGORITHM]
                                   [--bit-length BIT_LENGTH] [--mode MODE]
                                   [--payload-content-type PAYLOAD_CONTENT_TYPE]
                                   [--expiration EXPIRATION]
                                   [--request-type REQUEST_TYPE]
                                   [--subject-dn SUBJECT_DN]
                                   [--source-container-ref SOURCE_CONTAINER_REF]
                                   [--ca-id CA_ID] [--profile PROFILE]
                                   [--request-file REQUEST_FILE]
                                   type

Create a new order.

Expand
Table 59.32. Positional Arguments
ValueSummary

type

The type of the order (key, asymmetric, certificate) to create.

Expand
Table 59.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME, -n NAME

A human-friendly name.

--algorithm ALGORITHM, -a ALGORITHM

the algorithm to be used with the requested key (default: aes).

--bit-length BIT_LENGTH, -b BIT_LENGTH

the bit length of the requested secret key (default: 256).

--mode MODE, -m MODE

The algorithm mode to be used with the requested key (default: cbc).

--payload-content-type PAYLOAD_CONTENT_TYPE, -t PAYLOAD_CONTENT_TYPE

the type/format of the secret to be generated (default: application/octet-stream).

--expiration EXPIRATION, -x EXPIRATION

the expiration time for the secret in ISO 8601 format.

--request-type REQUEST_TYPE

the type of the certificate request.

--subject-dn SUBJECT_DN

the subject of the certificate.

--source-container-ref SOURCE_CONTAINER_REF

the source of the certificate when using stored-key requests.

--ca-id CA_ID

The identifier of the ca to use for the certificate request.

--profile PROFILE

The profile of certificate to use.

--request-file REQUEST_FILE

the file containing the CSR.

Expand
Table 59.34. Output Formatters
ValueSummary

-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

Expand
Table 59.35. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.36. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.37. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

59.9. secret order delete

Usage:

openstack secret order delete [-h] URI

Delete an order by providing its href.

Expand
Table 59.38. Positional Arguments
ValueSummary

URI

The uri reference for the order

Expand
Table 59.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-barbicanclient plugin.

59.10. secret order get

Usage:

openstack secret order get [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                URI

Retrieve an order by providing its URI.

Expand
Table 59.40. Positional Arguments
ValueSummary

URI

The uri reference order.

Expand
Table 59.41. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 59.42. Output Formatters
ValueSummary

-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

Expand
Table 59.43. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.44. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.45. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

59.11. secret order list

Usage:

openstack secret order list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN] [--limit LIMIT]
                                 [--offset OFFSET]

List orders.

Expand
Table 59.46. Optional Arguments
ValueSummary

-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)

Expand
Table 59.47. Output Formatters
ValueSummary

-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

Expand
Table 59.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.50. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-barbicanclient plugin.

59.12. secret store

Usage:

openstack secret store [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--name NAME]
                            [--secret-type SECRET_TYPE]
                            [--payload-content-type PAYLOAD_CONTENT_TYPE]
                            [--payload-content-encoding PAYLOAD_CONTENT_ENCODING]
                            [--algorithm ALGORITHM]
                            [--bit-length BIT_LENGTH] [--mode MODE]
                            [--expiration EXPIRATION]
                            [--payload PAYLOAD | --file <filename>]

Store a secret in Barbican.

Expand
Table 59.51. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME, -n NAME

A human-friendly name.

--secret-type SECRET_TYPE, -s SECRET_TYPE

the secret type; must be one of symmetric, public, private, certificate, passphrase, opaque (default)

--payload-content-type PAYLOAD_CONTENT_TYPE, -t PAYLOAD_CONTENT_TYPE

the type/format of the provided secret data; "text/plain" is assumed to be UTF-8; required when

--payload is supplied.

 

--payload-content-encoding PAYLOAD_CONTENT_ENCODING, -e PAYLOAD_CONTENT_ENCODING

required if --payload-content-type is "application /octet-stream".

--algorithm ALGORITHM, -a ALGORITHM

the algorithm (default: aes).

--bit-length BIT_LENGTH, -b BIT_LENGTH

the bit length (default: 256).

--mode MODE, -m MODE

The algorithm mode; used only for reference (default: cbc)

--expiration EXPIRATION, -x EXPIRATION

the expiration time for the secret in ISO 8601 format.

--payload PAYLOAD, -p PAYLOAD

the unencrypted secret data.

--file <filename>, -F <filename>

file containing the secret payload

Expand
Table 59.52. Output Formatters
ValueSummary

-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

Expand
Table 59.53. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 59.54. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 59.55. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-barbicanclient plugin.

59.13. secret update

Usage:

openstack secret update [-h] URI payload

Update a secret with no payload in Barbican.

Expand
Table 59.56. Positional Arguments
ValueSummary

URI

The uri reference for the secret.

payload

The unencrypted secret

Expand
Table 59.57. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-barbicanclient plugin.

Chapter 60. security

This chapter describes the commands under the security command.

60.1. security group create

Usage:

openstack security group create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--description <description>]
                                     [--project <project>]
                                     [--project-domain <project-domain>]
                                     [--tag <tag> | --no-tag]
                                     <name>

Create a new security group

Expand
Table 60.1. Positional Arguments
ValueSummary

<name>

New security group name

Expand
Table 60.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Security group 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.

--tag <tag>

Tag to be added to the security group (repeat option to set multiple tags)

--no-tag

No tags associated with the security group

Expand
Table 60.3. Output Formatters
ValueSummary

-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

Expand
Table 60.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 60.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 60.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

60.2. security group delete

Usage:

openstack security group delete [-h] <group> [<group> ...]

Delete security group(s)

Expand
Table 60.7. Positional Arguments
ValueSummary

<group>

Security group(s) to delete (name or id)

Expand
Table 60.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

60.3. security group list

Usage:

openstack security group list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--project <project>]
                                   [--project-domain <project-domain>]
                                   [--tags <tag>[,<tag>,...]]
                                   [--any-tags <tag>[,<tag>,...]]
                                   [--not-tags <tag>[,<tag>,...]]
                                   [--not-any-tags <tag>[,<tag>,...]]

List security groups

Expand
Table 60.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

List security groups according to the 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.

--tags <tag>[,<tag>,…​]

List security group which have all given tag(s) (Comma-separated list of tags)

--any-tags <tag>[,<tag>,…​]

List security group which have any given tag(s) (Comma-separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude security group which have all given tag(s) (Comma-separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude security group which have any given tag(s) (Comma-separated list of tags)

Expand
Table 60.10. Output Formatters
ValueSummary

-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

Expand
Table 60.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 60.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 60.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

60.4. security group rule create

Usage:

openstack security group rule create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--remote-ip <ip-address> | --remote-group <group>]
                                          [--description <description>]
                                          [--dst-port <port-range>]
                                          [--icmp-type <icmp-type>]
                                          [--icmp-code <icmp-code>]
                                          [--protocol <protocol>]
                                          [--ingress | --egress]
                                          [--ethertype <ethertype>]
                                          [--project <project>]
                                          [--project-domain <project-domain>]
                                          <group>

Create a new security group rule

Expand
Table 60.14. Positional Arguments
ValueSummary

<group>

Create rule in this security group (name or id)

Expand
Table 60.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--remote-ip <ip-address>

Remote IP address block (may use CIDR notation; default for IPv4 rule: 0.0.0.0/0)

--remote-group <group>

Remote security group (name or ID)

--description <description>

Set security group rule description

--dst-port <port-range>

Destination port, may be a single port or a starting and ending port range: 137:139. Required for IP protocols TCP and UDP. Ignored for ICMP IP protocols.

--icmp-type <icmp-type>

ICMP type for ICMP IP protocols

--icmp-code <icmp-code>

ICMP code for ICMP IP protocols

--protocol <protocol>

IP protocol (ah, dccp, egp, esp, gre, icmp, igmp, ipv6-encap, ipv6-frag, ipv6-icmp, ipv6-nonxt, ipv6-opts, ipv6-route, ospf, pgm, rsvp, sctp, tcp, udp, udplite, vrrp and integer representations [0-255] or any; default: tcp)

--ingress

Rule applies to incoming network traffic (default)

--egress

Rule applies to outgoing network traffic

--ethertype <ethertype>

Ethertype of network traffic (IPv4, IPv6; default: based on IP protocol)

--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.

Expand
Table 60.16. Output Formatters
ValueSummary

-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

Expand
Table 60.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 60.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 60.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

60.5. security group rule delete

Usage:

openstack security group rule delete [-h] <rule> [<rule> ...]

Delete security group rule(s)

Expand
Table 60.20. Positional Arguments
ValueSummary

<rule>

Security group rule(s) to delete (id only)

Expand
Table 60.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

60.6. security group rule list

Usage:

openstack security group rule list [-h]

                                        [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--sort-column SORT_COLUMN]
                                        [--protocol <protocol>]
                                        [--ingress | --egress] [--long]
                                        [<group>]

List security group rules

Expand
Table 60.22. Positional Arguments
ValueSummary

<group>

List all rules in this security group (name or id)

Expand
Table 60.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--protocol <protocol>

List rules by the IP protocol (ah, dhcp, egp, esp, gre, icmp, igmp, ipv6-encap, ipv6-frag, ipv6-icmp, ipv6-nonxt, ipv6-opts, ipv6-route, ospf, pgm, rsvp, sctp, tcp, udp, udplite, vrrp and integer representations [0-255]).

--ingress

List rules applied to incoming network traffic

--egress

List rules applied to outgoing network traffic

--long

List additional fields in output

Expand
Table 60.24. Output Formatters
ValueSummary

-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

Expand
Table 60.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 60.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 60.27. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

60.7. security group rule show

Usage:

openstack security group rule show [-h]

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

Display security group rule details

Expand
Table 60.28. Positional Arguments
ValueSummary

<rule>

Security group rule to display (id only)

Expand
Table 60.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 60.30. Output Formatters
ValueSummary

-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

Expand
Table 60.31. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 60.32. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 60.33. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

60.8. security group set

Usage:

openstack security group set [-h] [--name <new-name>]

                                  [--description <description>]
                                  [--tag <tag>] [--no-tag]
                                  <group>

Set security group properties

Expand
Table 60.34. Positional Arguments
ValueSummary

<group>

Security group to modify (name or id)

Expand
Table 60.35. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <new-name>

New security group name

--description <description>

New security group description

--tag <tag>

Tag to be added to the security group (repeat option to set multiple tags)

--no-tag

Clear tags associated with the security group. specify both --tag and --no-tag to overwrite current tags

60.9. security group show

Usage:

openstack security group show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <group>

Display security group details

Expand
Table 60.36. Positional Arguments
ValueSummary

<group>

Security group to display (name or id)

Expand
Table 60.37. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 60.38. Output Formatters
ValueSummary

-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

Expand
Table 60.39. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 60.40. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 60.41. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

60.10. security group unset

Usage:

openstack security group unset [-h] [--tag <tag> | --all-tag] <group>

Unset security group properties

Expand
Table 60.42. Positional Arguments
ValueSummary

<group>

Security group to modify (name or id)

Expand
Table 60.43. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--tag <tag>

Tag to be removed from the security group (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the security group

Chapter 61. server

This chapter describes the commands under the server command.

61.1. server add fixed ip

Usage:

openstack server add fixed ip [-h] [--fixed-ip-address <ip-address>]

                                   <server> <network>

Add fixed IP address to server

Expand
Table 61.1. Positional Arguments
ValueSummary

<server>

Server to receive the fixed ip address (name or id)

<network>

Network to allocate the fixed ip address from (name or ID)

Expand
Table 61.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--fixed-ip-address <ip-address>

Requested fixed IP address

61.2. server add floating ip

Usage:

openstack server add floating ip [-h] [--fixed-ip-address <ip-address>]

                                      <server> <ip-address>

Add floating IP address to server

Expand
Table 61.3. Positional Arguments
ValueSummary

<server>

Server to receive the floating ip address (name or id)

<ip-address>

Floating ip address to assign to the first available server port (IP only)

Expand
Table 61.4. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--fixed-ip-address <ip-address>

Fixed IP address to associate with this floating IP address. The first server port containing the fixed IP address will be used

61.3. server add network

Usage:

openstack server add network [-h] <server> <network>

Add network to server

Expand
Table 61.5. Positional Arguments
ValueSummary

<server>

Server to add the network to (name or id)

<network>

Network to add to the server (name or id)

Expand
Table 61.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.4. server add port

Usage:

openstack server add port [-h] <server> <port>

Add port to server

Expand
Table 61.7. Positional Arguments
ValueSummary

<server>

Server to add the port to (name or id)

<port>

Port to add to the server (name or id)

Expand
Table 61.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.5. server add security group

Usage:

openstack server add security group [-h] <server> <group>

Add security group to server

Expand
Table 61.9. Positional Arguments
ValueSummary

<server>

Server (name or id)

<group>

Security group to add (name or id)

Expand
Table 61.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.6. server add volume

Usage:

openstack server add volume [-h] [--device <device>] <server> <volume>

Add volume to server

Expand
Table 61.11. Positional Arguments
ValueSummary

<server>

Server (name or id)

<volume>

Volume to add (name or id)

Expand
Table 61.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--device <device>

Server internal device name for volume

61.7. server backup create

Usage:

openstack server backup create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--name <image-name>]
                                    [--type <backup-type>]
                                    [--rotate <count>] [--wait]
                                    <server>

Create a server backup image

Expand
Table 61.13. Positional Arguments
ValueSummary

<server>

Server to back up (name or id)

Expand
Table 61.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <image-name>

Name of the backup image (default: server name)

--type <backup-type>

Used to populate the backup_type property of the backup image (default: empty)

--rotate <count>

Number of backups to keep (default: 1)

--wait

Wait for backup image create to complete

Expand
Table 61.15. Output Formatters
ValueSummary

-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

Expand
Table 61.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.18. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.8. server create

Usage:

openstack server create [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]
                             (--image <image> | --image-property <key=value> | --volume <volume>)
                             --flavor <flavor>
                             [--security-group <security-group>]
                             [--key-name <key-name>]
                             [--property <key=value>]
                             [--file <dest-filename=source-filename>]
                             [--user-data <user-data>]
                             [--availability-zone <zone-name>]
                             [--block-device-mapping <dev-name=mapping>]
                             [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid,auto,none>]
                             [--network <network>] [--port <port>]
                             [--hint <key=value>]
                             [--config-drive <config-drive-volume>|True]
                             [--min <count>] [--max <count>] [--wait]
                             <server-name>

Create a new server

Expand
Table 61.19. Positional Arguments
ValueSummary

<server-name>

New server name

Expand
Table 61.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--image <image>

Create server boot disk from this image (name or id)

--image-property <key=value>

Image property to be matched

--volume <volume>

Create server using this volume as the boot disk (name or ID). This option automatically creates a block device mapping with a boot index of 0. On many hypervisors (libvirt/kvm for example) this will be device vda. Do not create a duplicate mapping using --block-device- mapping for this volume.

--flavor <flavor>

Create server with this flavor (name or id)

--security-group <security-group>

Security group to assign to this server (name or ID) (repeat option to set multiple groups)

--key-name <key-name>

Keypair to inject into this server (optional extension)

--property <key=value>

Set a property on this server (repeat option to set multiple values)

--file <dest-filename=source-filename>

File to inject into image before boot (repeat option to set multiple files)

--user-data <user-data>

User data file to serve from the metadata server

--availability-zone <zone-name>

Select an availability zone for the server

--block-device-mapping <dev-name=mapping>

Create a block device on the server. Block device mapping in the format

<dev-name>=<id>:<type>:<size(GB)>:<delete-on-

terminate>

<dev-name>: block device name, like: vdb, xvdc

(required)

<id>: UUID of the volume or snapshot (required)

 

<type>: volume or snapshot; default: volume (optional)

 

<size(GB)>: volume size if create from snapshot

(optional)

<delete-on-terminate>: true or false; default: false

(optional) (optional extension)

--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,v6-fixed-ip=ip-addr,port-id=port-uuid,auto,none>

Create a NIC on the server. Specify option multiple times to create multiple NICs. Either net-id or port- id must be provided, but not both. net-id: attach NIC to network with this UUID, port-id: attach NIC to port with this UUID, v4-fixed-ip: IPv4 fixed address for NIC (optional), v6-fixed-ip: IPv6 fixed address for NIC (optional), none: (v2.37+) no network is attached, auto: (v2.37+) the compute service will automatically allocate a network. Specifying a --nic of auto or none cannot be used with any other --nic value.

--network <network>

Create a nic on the server and connect it to network. Specify option multiple times to create multiple NICs. This is a wrapper for the '--nic net-id=<network>' parameter that provides simple syntax for the standard use case of connecting a new server to a given network. For more advanced use cases, refer to the '-- nic' parameter.

--port <port>

Create a nic on the server and connect it to port. Specify option multiple times to create multiple NICs. This is a wrapper for the '--nic port-id=<pord>' parameter that provides simple syntax for the standard use case of connecting a new server to a given port. For more advanced use cases, refer to the '--nic' parameter.

--hint <key=value>

Hints for the scheduler (optional extension)

--config-drive <config-drive-volume>

True

Use specified volume as the config drive, or 'True' to use an ephemeral drive

--min <count>

Minimum number of servers to launch (default=1)

--max <count>

Maximum number of servers to launch (default=1)

--wait

Expand
Table 61.21. Output Formatters
ValueSummary

-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

Expand
Table 61.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.24. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.9. server delete

Usage:

openstack server delete [-h] [--wait] <server> [<server> ...]

Delete server(s)

Expand
Table 61.25. Positional Arguments
ValueSummary

<server>

Server(s) to delete (name or id)

Expand
Table 61.26. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for delete to complete

61.10. server dump create

Usage:

openstack server dump create [-h] <server> [<server> ...]

Create a dump file in server(s) Trigger crash dump in server(s) with features like kdump in Linux. It will create a dump file in the server(s) dumping the server(s)' memory, and also crash the server(s). OSC sees the dump file (server dump) as a kind of resource.

Expand
Table 61.27. Positional Arguments
ValueSummary

<server>

Server(s) to create dump file (name or id)

Expand
Table 61.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.11. server event list

Usage:

openstack server event list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN] [--long]
                                 <server>

List recent events of a server

Expand
Table 61.29. Positional Arguments
ValueSummary

<server>

Server to list events (name or id)

Expand
Table 61.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 61.31. Output Formatters
ValueSummary

-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

Expand
Table 61.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.34. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

61.12. server event show

Usage:

openstack server event show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 <server> <request-id>

Show server event details

Expand
Table 61.35. Positional Arguments
ValueSummary

<server>

Server to show event details (name or id)

<request-id>

Request id of the event to show (id only)

Expand
Table 61.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 61.37. Output Formatters
ValueSummary

-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

Expand
Table 61.38. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.39. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.40. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.13. server group create

Usage:

openstack server group create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--policy <policy>]
                                   <name>

Create a new server group.

Expand
Table 61.41. Positional Arguments
ValueSummary

<name>

New server group name

Expand
Table 61.42. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--policy <policy>

Add a policy to <name> ('affinity' or 'anti-affinity', defaults to 'affinity'). Specify --os-compute-api- version 2.15 or higher for the 'soft-affinity' or 'soft-anti-affinity' policy.

Expand
Table 61.43. Output Formatters
ValueSummary

-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

Expand
Table 61.44. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.45. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.46. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.14. server group delete

Usage:

openstack server group delete [-h] <server-group> [<server-group> ...]

Delete existing server group(s).

Expand
Table 61.47. Positional Arguments
ValueSummary

<server-group>

Server group(s) to delete (name or id)

Expand
Table 61.48. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.15. server group list

Usage:

openstack server group list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]
                                 [--all-projects] [--long]

List all server groups.

Expand
Table 61.49. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all-projects

Display information from all projects (admin only)

--long

List additional fields in output

Expand
Table 61.50. Output Formatters
ValueSummary

-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

Expand
Table 61.51. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.52. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.53. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

61.16. server group show

Usage:

openstack server group show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 <server-group>

Display server group details.

Expand
Table 61.54. Positional Arguments
ValueSummary

<server-group>

Server group to display (name or id)

Expand
Table 61.55. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 61.56. Output Formatters
ValueSummary

-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

Expand
Table 61.57. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.58. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.59. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.17. server image create

Usage:

openstack server image create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--name <image-name>] [--wait]
                                   <server>

Create a new server disk image from an existing server

Expand
Table 61.60. Positional Arguments
ValueSummary

<server>

Server to create image (name or id)

Expand
Table 61.61. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <image-name>

Name of new disk image (default: server name)

--wait

Wait for operation to complete

Expand
Table 61.62. Output Formatters
ValueSummary

-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

Expand
Table 61.63. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.64. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.65. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.18. server list

Usage:

openstack server list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN]
                           [--reservation-id <reservation-id>]
                           [--ip <ip-address-regex>]
                           [--ip6 <ip-address-regex>] [--name <name-regex>]
                           [--instance-name <server-name>]
                           [--status <status>] [--flavor <flavor>]
                           [--image <image>] [--host <hostname>]
                           [--all-projects] [--project <project>]
                           [--project-domain <project-domain>]
                           [--user <user>] [--user-domain <user-domain>]
                           [--long] [-n] [--marker <server>]
                           [--limit <num-servers>] [--deleted]
                           [--changes-since <changes-since>]

List servers

Expand
Table 61.66. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--reservation-id <reservation-id>

Only return instances that match the reservation

--ip <ip-address-regex>

Regular expression to match IP addresses

--ip6 <ip-address-regex>

Regular expression to match IPv6 addresses

--name <name-regex>

Regular expression to match names

--instance-name <server-name>

Regular expression to match instance name (admin only)

--status <status>

Search by server status

--flavor <flavor>

Search by flavor (name or id)

--image <image>

Search by image (name or id)

--host <hostname>

Search by hostname

--all-projects

Include all projects (admin only)

--project <project>

Search by project (admin only) (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.

--user <user>

Search by user (admin only) (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

-n, --no-name-lookup

Skip flavor and image name lookup.

--marker <server>

The last server of the previous page. display list of servers after marker. Display all servers if not specified. (name or ID)

--limit <num-servers>

Maximum number of servers to display. If limit equals

-1, all servers will be displayed. If limit is greater

than 'osapi_max_limit' option of Nova API, 'osapi_max_limit' will be used instead.

--deleted

Only display deleted servers (admin only).

--changes-since <changes-since>

List only servers changed after a certain point of time. The provided time should be an ISO 8061 formatted time. ex 2016-03-04T06:27:59Z .

Expand
Table 61.67. Output Formatters
ValueSummary

-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

Expand
Table 61.68. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.69. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.70. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

61.19. server lock

Usage:

openstack server lock [-h] <server> [<server> ...]

Lock server(s). A non-admin user will not be able to execute actions

Expand
Table 61.71. Positional Arguments
ValueSummary

<server>

Server(s) to lock (name or id)

Expand
Table 61.72. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.20. server migrate

Usage:

openstack server migrate [-h] [--live <hostname>]

                              [--shared-migration | --block-migration]
                              [--disk-overcommit | --no-disk-overcommit]
                              [--wait]
                              <server>

Migrate server to different host

Expand
Table 61.73. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.74. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--live <hostname>

Target hostname

--shared-migration

Perform a shared live migration (default)

--block-migration

Perform a block live migration

--disk-overcommit

Allow disk over-commit on the destination host

--no-disk-overcommit

Do not over-commit disk on the destination host (default)

--wait

Wait for migrate to complete

61.21. server pause

Usage:

openstack server pause [-h] <server> [<server> ...]

Pause server(s)

Expand
Table 61.75. Positional Arguments
ValueSummary

<server>

Server(s) to pause (name or id)

Expand
Table 61.76. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.22. server reboot

Usage:

openstack server reboot [-h] [--hard | --soft] [--wait] <server>

Perform a hard or soft server reboot

Expand
Table 61.77. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.78. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--hard

Perform a hard reboot

--soft

Perform a soft reboot

--wait

Wait for reboot to complete

61.23. server rebuild

Usage:

openstack server rebuild [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX] [--image <image>]
                              [--password <password>] [--wait]
                              <server>

Rebuild server

Expand
Table 61.79. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.80. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--image <image>

Recreate server from the specified image (name or id). Defaults to the currently used one.

--password <password>

Set the password on the rebuilt instance

--wait

Wait for rebuild to complete

Expand
Table 61.81. Output Formatters
ValueSummary

-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

Expand
Table 61.82. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.83. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.84. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.24. server remove fixed ip

Usage:

openstack server remove fixed ip [-h] <server> <ip-address>

Remove fixed IP address from server

Expand
Table 61.85. Positional Arguments
ValueSummary

<server>

Server to remove the fixed ip address from (name or id)

<ip-address>

Fixed ip address to remove from the server (ip only)

Expand
Table 61.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.25. server remove floating ip

Usage:

openstack server remove floating ip [-h] <server> <ip-address>

Remove floating IP address from server

Expand
Table 61.87. Positional Arguments
ValueSummary

<server>

Server to remove the floating ip address from (name or id)

<ip-address>

Floating ip address to remove from server (ip only)

Expand
Table 61.88. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.26. server remove network

Usage:

openstack server remove network [-h] <server> <network>

Remove all ports of a network from server

Expand
Table 61.89. Positional Arguments
ValueSummary

<server>

Server to remove the port from (name or id)

<network>

Network to remove from the server (name or id)

Expand
Table 61.90. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.27. server remove port

Usage:

openstack server remove port [-h] <server> <port>

Remove port from server

Expand
Table 61.91. Positional Arguments
ValueSummary

<server>

Server to remove the port from (name or id)

<port>

Port to remove from the server (name or id)

Expand
Table 61.92. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.28. server remove security group

Usage:

openstack server remove security group [-h] <server> <group>

Remove security group from server

Expand
Table 61.93. Positional Arguments
ValueSummary

<server>

Name or id of server to use

<group>

Name or id of security group to remove from server

Expand
Table 61.94. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.29. server remove volume

Usage:

openstack server remove volume [-h] <server> <volume>

Remove volume from server

Expand
Table 61.95. Positional Arguments
ValueSummary

<server>

Server (name or id)

<volume>

Volume to remove (name or id)

Expand
Table 61.96. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.30. server rescue

Usage:

openstack server rescue [-h] [--image <image>] [--password <password>]

                             <server>

Put server in rescue mode

Expand
Table 61.97. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.98. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--image <image>

Image (name or id) to use for the rescue mode. Defaults to the currently used one.

--password <password>

Set the password on the rescued instance

61.31. server resize

Usage:

openstack server resize [-h] [--flavor <flavor> | --confirm | --revert]

                             [--wait]
                             <server>

Scale server to a new flavor. A resize operation is implemented by creating a new server and copying the contents of the original disk into a new one. It is also a two-step process for the user: the first is to perform the resize, the second is to either confirm (verify) success and release the old server, or to declare a revert to release the new server and restart the old one.

Expand
Table 61.99. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.100. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--flavor <flavor>

Resize server to specified flavor

--confirm

Confirm server resize is complete

--revert

Restore server state before resize

--wait

Wait for resize to complete

61.32. server restore

Usage:

openstack server restore [-h] <server> [<server> ...]

Restore server(s)

Expand
Table 61.101. Positional Arguments
ValueSummary

<server>

Server(s) to restore (name or id)

Expand
Table 61.102. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.33. server resume

Usage:

openstack server resume [-h] <server> [<server> ...]

Resume server(s)

Expand
Table 61.103. Positional Arguments
ValueSummary

<server>

Server(s) to resume (name or id)

Expand
Table 61.104. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.34. server set

Usage:

openstack server set [-h] [--name <new-name>] [--root-password]

                          [--property <key=value>] [--state <state>]
                          <server>

Set server properties

Expand
Table 61.105. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.106. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <new-name>

New server name

--root-password

Set new root password (interactive only)

--property <key=value>

Property to add/change for this server (repeat option to set multiple properties)

--state <state>

New server state (valid value: active, error)

61.35. server shelve

Usage:

openstack server shelve [-h] <server> [<server> ...]

Shelve server(s)

Expand
Table 61.107. Positional Arguments
ValueSummary

<server>

Server(s) to shelve (name or id)

Expand
Table 61.108. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.36. server show

Usage:

openstack server show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--diagnostics]
                           <server>

Show server details. Specify --os-compute-api-version 2.47 or higher to see the embedded flavor information for the server.

Expand
Table 61.109. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.110. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--diagnostics

Display server diagnostics information

Expand
Table 61.111. Output Formatters
ValueSummary

-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

Expand
Table 61.112. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 61.113. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 61.114. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

61.37. server ssh

Usage:

openstack server ssh [-h] [--login <login-name>] [--port <port>]

                          [--identity <keyfile>] [--option <config-options>]
                          [-4 | -6]
                          [--public | --private | --address-type <address-type>]
                          <server>

SSH to server

Expand
Table 61.115. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.116. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--login <login-name>

Login name (ssh -l option)

--port <port>

Destination port (ssh -p option)

--identity <keyfile>

Private key file (ssh -i option)

--option <config-options>

Options in ssh_config(5) format (ssh -o option)

-4

Use only ipv4 addresses

-6

Use only ipv6 addresses

--public

Use public ip address

--private

Use private ip address

--address-type <address-type>

Use other IP address (public, private, etc)

61.38. server start

Usage:

openstack server start [-h] <server> [<server> ...]

Start server(s).

Expand
Table 61.117. Positional Arguments
ValueSummary

<server>

Server(s) to start (name or id)

Expand
Table 61.118. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.39. server stop

Usage:

openstack server stop [-h] <server> [<server> ...]

Stop server(s).

Expand
Table 61.119. Positional Arguments
ValueSummary

<server>

Server(s) to stop (name or id)

Expand
Table 61.120. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.40. server suspend

Usage:

openstack server suspend [-h] <server> [<server> ...]

Suspend server(s)

Expand
Table 61.121. Positional Arguments
ValueSummary

<server>

Server(s) to suspend (name or id)

Expand
Table 61.122. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.41. server unlock

Usage:

openstack server unlock [-h] <server> [<server> ...]

Unlock server(s)

Expand
Table 61.123. Positional Arguments
ValueSummary

<server>

Server(s) to unlock (name or id)

Expand
Table 61.124. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.42. server unpause

Usage:

openstack server unpause [-h] <server> [<server> ...]

Unpause server(s)

Expand
Table 61.125. Positional Arguments
ValueSummary

<server>

Server(s) to unpause (name or id)

Expand
Table 61.126. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.43. server unrescue

Usage:

openstack server unrescue [-h] <server>

Restore server from rescue mode

Expand
Table 61.127. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.128. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

61.44. server unset

Usage:

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

Unset server properties

Expand
Table 61.129. Positional Arguments
ValueSummary

<server>

Server (name or id)

Expand
Table 61.130. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property key to remove from server (repeat option to remove multiple values)

61.45. server unshelve

Usage:

openstack server unshelve [-h] <server> [<server> ...]

Unshelve server(s)

Expand
Table 61.131. Positional Arguments
ValueSummary

<server>

Server(s) to unshelve (name or id)

Expand
Table 61.132. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Chapter 62. service

This chapter describes the commands under the service command.

62.1. service create

Usage:

openstack service create [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX] [--name <name>]
                              [--description <description>]
                              <type>

Create new service

Expand
Table 62.1. Positional Arguments
ValueSummary

<type>

New service type (compute, image, identity, volume, etc)

Expand
Table 62.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New service name

--description <description>

New service description

Expand
Table 62.3. Output Formatters
ValueSummary

-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

Expand
Table 62.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 62.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 62.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

62.2. service delete

Usage:

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

Delete service(s)

Expand
Table 62.7. Positional Arguments
ValueSummary

<service>

Service(s) to delete (type, name or id)

Expand
Table 62.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

62.3. service list

Usage:

openstack service list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--long]

List services

Expand
Table 62.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 62.10. Output Formatters
ValueSummary

-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

Expand
Table 62.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 62.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 62.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

62.4. service show

Usage:

openstack service show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--catalog]
                            <service>

Display service details

Expand
Table 62.14. Positional Arguments
ValueSummary

<service>

Service to display (type, name or id)

Expand
Table 62.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--catalog

Show service catalog information

Expand
Table 62.16. Output Formatters
ValueSummary

-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

Expand
Table 62.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 62.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 62.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 63. tld

This chapter describes the commands under the tld command.

63.1. tld set

Usage:

openstack tld set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                       [--max-width <integer>] [--fit-width] [--print-empty]
                       [--noindent] [--prefix PREFIX] [--name NAME]
                       [--description DESCRIPTION | --no-description]
                       [--all-projects] [--edit-managed]
                       [--sudo-project-id SUDO_PROJECT_ID]
                       id

Set tld properties

Expand
Table 63.1. Positional Arguments
ValueSummary

id

Tld id

Expand
Table 63.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Tld name

--description DESCRIPTION

Description

--no-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

Expand
Table 63.3. Output Formatters
ValueSummary

-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

Expand
Table 63.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 63.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 63.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

Chapter 64. sfc

This chapter describes the commands under the sfc command.

64.1. sfc flow classifier create

Usage:

openstack sfc flow classifier create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--description <description>]
                                          [--protocol <protocol>]
                                          [--ethertype {IPv4,IPv6}]
                                          [--source-port <min-port>:<max-port>]
                                          [--destination-port <min-port>:<max-port>]
                                          [--source-ip-prefix <source-ip-prefix>]
                                          [--destination-ip-prefix <destination-ip-prefix>]
                                          [--logical-source-port <logical-source-port>]
                                          [--logical-destination-port <logical-destination-port>]
                                          [--l7-parameters L7_PARAMETERS]
                                          <name>

Create a flow classifier

Expand
Table 64.1. Positional Arguments
ValueSummary

<name>

Name of the flow classifier

Expand
Table 64.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the flow classifier

--protocol <protocol>

IP protocol name. Protocol name should be as per IANA standard.

--ethertype {IPv4,IPv6}

L2 ethertype, default is IPv4

--source-port <min-port>:<max-port>

Source protocol port (allowed range [1,65535]. Must be specified as a:b, where a=min-port and b=max-port) in the allowed range.

--destination-port <min-port>:<max-port>

Destination protocol port (allowed range [1,65535]. Must be specified as a:b, where a=min-port and b=max- port) in the allowed range.

--source-ip-prefix <source-ip-prefix>

Source IP address in CIDR notation

--destination-ip-prefix <destination-ip-prefix>

Destination IP address in CIDR notation

--logical-source-port <logical-source-port>

Neutron source port (name or ID)

--logical-destination-port <logical-destination-port>

Neutron destination port (name or ID)

--l7-parameters L7_PARAMETERS

Dictionary of L7 parameters. Currently, no value is supported for this option.

Expand
Table 64.3. Output Formatters
ValueSummary

-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

Expand
Table 64.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.2. sfc flow classifier delete

Usage:

openstack sfc flow classifier delete [-h] <flow-classifier>

Delete a given flow classifier

Expand
Table 64.7. Positional Arguments
ValueSummary

<flow-classifier>

Flow classifier to delete (name or id)

Expand
Table 64.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

64.3. sfc flow classifier list

Usage:

openstack sfc flow classifier list [-h]

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

List flow classifiers

Expand
Table 64.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 64.10. Output Formatters
ValueSummary

-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

Expand
Table 64.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

64.4. sfc flow classifier set

Usage:

openstack sfc flow classifier set [-h] [--name <name>]

                                       [--description <description>]
                                       <flow-classifier>

Set flow classifier properties

Expand
Table 64.14. Positional Arguments
ValueSummary

<flow-classifier>

Flow classifier to modify (name or id)

Expand
Table 64.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the flow classifier

--description <description>

Description for the flow classifier

This command is provided by the python-neutronclient plugin.

64.5. sfc flow classifier show

Usage:

openstack sfc flow classifier show [-h]

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

Display flow classifier details

Expand
Table 64.16. Positional Arguments
ValueSummary

<flow-classifier>

Flow classifier to display (name or id)

Expand
Table 64.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 64.18. Output Formatters
ValueSummary

-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

Expand
Table 64.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.6. sfc port chain create

Usage:

openstack sfc port chain create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--description <description>]
                                     [--flow-classifier <flow-classifier>]
                                     [--chain-parameters correlation=<correlation-type>,symmetric=<boolean>]
                                     --port-pair-group <port-pair-group>
                                     <name>

Create a port chain

Expand
Table 64.22. Positional Arguments
ValueSummary

<name>

Name of the port chain

Expand
Table 64.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the port chain

--flow-classifier <flow-classifier>

Add flow classifier (name or ID). This option can be repeated.

--chain-parameters correlation=<correlation-type>,symmetric=<boolean>

Dictionary of chain parameters. Supports correlation=(mpls

nsh) (default is mpls) and symmetric=(true

false).

--port-pair-group <port-pair-group>

Add port pair group (name or ID). This option can be repeated.

Expand
Table 64.24. Output Formatters
ValueSummary

-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

Expand
Table 64.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.7. sfc port chain delete

Usage:

openstack sfc port chain delete [-h] <port-chain>

Delete a given port chain

Expand
Table 64.28. Positional Arguments
ValueSummary

<port-chain>

Port chain to delete (name or id)

Expand
Table 64.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

64.8. sfc port chain list

Usage:

openstack sfc port chain list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN] [--long]

List port chains

Expand
Table 64.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 64.31. Output Formatters
ValueSummary

-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

Expand
Table 64.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.34. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

64.9. sfc port chain set

Usage:

openstack sfc port chain set [-h] [--name <name>]

                                  [--description <description>]
                                  [--flow-classifier <flow-classifier>]
                                  [--no-flow-classifier]
                                  [--port-pair-group <port-pair-group>]
                                  [--no-port-pair-group]
                                  <port-chain>

Set port chain properties

Expand
Table 64.35. Positional Arguments
ValueSummary

<port-chain>

Port chain to modify (name or id)

Expand
Table 64.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the port chain

--description <description>

Description for the port chain

--flow-classifier <flow-classifier>

Add flow classifier (name or ID). This option can be repeated.

--no-flow-classifier

Remove associated flow classifiers from the port chain

--port-pair-group <port-pair-group>

Add port pair group (name or ID). Current port pair groups order is kept, the added port pair group will be placed at the end of the port chain. This option can be repeated.

--no-port-pair-group

Remove associated port pair groups from the port chain. At least one --port-pair-group must be specified together.

This command is provided by the python-neutronclient plugin.

64.10. sfc port chain show

Usage:

openstack sfc port chain show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <port-chain>

Display port chain details

Expand
Table 64.37. Positional Arguments
ValueSummary

<port-chain>

Port chain to display (name or id)

Expand
Table 64.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 64.39. Output Formatters
ValueSummary

-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

Expand
Table 64.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.11. sfc port chain unset

Usage:

openstack sfc port chain unset [-h]

                                    [--flow-classifier <flow-classifier> | --all-flow-classifier]
                                    [--port-pair-group <port-pair-group>]
                                    <port-chain>

Unset port chain properties

Expand
Table 64.43. Positional Arguments
ValueSummary

<port-chain>

Port chain to unset (name or id)

Expand
Table 64.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--flow-classifier <flow-classifier>

Remove flow classifier(s) from the port chain (name or ID). This option can be repeated.

--all-flow-classifier

Remove all flow classifiers from the port chain

--port-pair-group <port-pair-group>

Remove port pair group(s) from the port chain (name or ID). This option can be repeated.

This command is provided by the python-neutronclient plugin.

64.12. sfc port pair create

Usage:

openstack sfc port pair create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--description <description>]
                                    [--service-function-parameters correlation=<correlation-type>,weight=<weight>]
                                    --ingress <ingress> --egress <egress>
                                    <name>

Create a port pair

Expand
Table 64.45. Positional Arguments
ValueSummary

<name>

Name of the port pair

Expand
Table 64.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the port pair

--service-function-parameters correlation=<correlation-type>,weight=<weight>

Dictionary of service function parameters. Currently, correlation=(None

mpls

nsh) and weight are supported. Weight is an integer that influences the selection of a port pair within a port pair group for a flow. The higher the weight, the more flows will hash to the port pair. The default weight is 1.

--ingress <ingress>

Ingress neutron port (name or id)

--egress <egress>

Egress neutron port (name or id)

Expand
Table 64.47. Output Formatters
ValueSummary

-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

Expand
Table 64.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.50. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.13. sfc port pair delete

Usage:

openstack sfc port pair delete [-h] <port-pair>

Delete a given port pair

Expand
Table 64.51. Positional Arguments
ValueSummary

<port-pair>

Port pair to delete (name or id)

Expand
Table 64.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

64.14. sfc port pair group create

Usage:

openstack sfc port pair group create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--description <description>]
                                          [--port-pair <port-pair>]
                                          [--enable-tap | --disable-tap]
                                          [--port-pair-group-parameters lb-fields=<lb-fields>]
                                          <name>

Create a port pair group

Expand
Table 64.53. Positional Arguments
ValueSummary

<name>

Name of the port pair group

Expand
Table 64.54. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the port pair group

--port-pair <port-pair>

Port pair (name or ID). This option can be repeated.

--enable-tap

Port pairs of this port pair group are deployed as passive tap service function

--disable-tap

Port pairs of this port pair group are deployed as l3 service function (default)

--port-pair-group-parameters lb-fields=<lb-fields>

Dictionary of port pair group parameters. Currently only one parameter lb-fields is supported. <lb-fields> is a & separated list of load-balancing fields.

Expand
Table 64.55. Output Formatters
ValueSummary

-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

Expand
Table 64.56. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.57. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.58. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.15. sfc port pair group delete

Usage:

openstack sfc port pair group delete [-h] <port-pair-group>

Delete a given port pair group

Expand
Table 64.59. Positional Arguments
ValueSummary

<port-pair-group>

Port pair group to delete (name or id)

Expand
Table 64.60. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

64.16. sfc port pair group list

Usage:

openstack sfc port pair group list [-h]

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

List port pair group

Expand
Table 64.61. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 64.62. Output Formatters
ValueSummary

-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

Expand
Table 64.63. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.64. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.65. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

64.17. sfc port pair group set

Usage:

openstack sfc port pair group set [-h] [--name <name>]

                                       [--description <description>]
                                       [--port-pair <port-pair>]
                                       [--no-port-pair]
                                       <port-pair-group>

Set port pair group properties

Expand
Table 64.66. Positional Arguments
ValueSummary

<port-pair-group>

Port pair group to modify (name or id)

Expand
Table 64.67. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the port pair group

--description <description>

Description for the port pair group

--port-pair <port-pair>

Port pair (name or ID). This option can be repeated.

--no-port-pair

Remove all port pair from port pair group

This command is provided by the python-neutronclient plugin.

64.18. sfc port pair group show

Usage:

openstack sfc port pair group show [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        <port-pair-group>

Display port pair group details

Expand
Table 64.68. Positional Arguments
ValueSummary

<port-pair-group>

Port pair group to display (name or id)

Expand
Table 64.69. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 64.70. Output Formatters
ValueSummary

-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

Expand
Table 64.71. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.72. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.73. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.19. sfc port pair group unset

Usage:

openstack sfc port pair group unset [-h]

                                         [--port-pair <port-pair> | --all-port-pair]
                                         <port-pair-group>

Unset port pairs from port pair group

Expand
Table 64.74. Positional Arguments
ValueSummary

<port-pair-group>

Port pair group to unset (name or id)

Expand
Table 64.75. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--port-pair <port-pair>

Remove port pair(s) from the port pair group (name or ID). This option can be repeated.

--all-port-pair

Remove all port pairs from the port pair group

This command is provided by the python-neutronclient plugin.

64.20. sfc port pair list

Usage:

openstack sfc port pair list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN] [--long]

List port pairs

Expand
Table 64.76. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 64.77. Output Formatters
ValueSummary

-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

Expand
Table 64.78. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.79. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.80. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

64.21. sfc port pair set

Usage:

openstack sfc port pair set [-h] [--name <name>]

                                 [--description <description>]
                                 <port-pair>

Set port pair properties

Expand
Table 64.81. Positional Arguments
ValueSummary

<port-pair>

Port pair to modify (name or id)

Expand
Table 64.82. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the port pair

--description <description>

Description for the port pair

This command is provided by the python-neutronclient plugin.

64.22. sfc port pair show

Usage:

openstack sfc port pair show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <port-pair>

Display port pair details

Expand
Table 64.83. Positional Arguments
ValueSummary

<port-pair>

Port pair to display (name or id)

Expand
Table 64.84. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 64.85. Output Formatters
ValueSummary

-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

Expand
Table 64.86. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.87. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.88. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.23. sfc service graph create

Usage:

openstack sfc service graph create [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        [--description DESCRIPTION]
                                        --branching-point
                                        SRC_CHAIN:DST_CHAIN_1,DST_CHAIN_2,DST_CHAIN_N
                                        <name>

Create a service graph.

Expand
Table 64.89. Positional Arguments
ValueSummary

<name>

Name of the service graph.

Expand
Table 64.90. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description DESCRIPTION

Description for the service graph.

--branching-point SRC_CHAIN:DST_CHAIN_1,DST_CHAIN_2,DST_CHAIN_N

Service graph branching point: the key is the source Port Chain while the value is a list of destination Port Chains. This option can be repeated.

Expand
Table 64.91. Output Formatters
ValueSummary

-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

Expand
Table 64.92. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.93. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.94. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

64.24. sfc service graph delete

Usage:

openstack sfc service graph delete [-h] <service-graph>

Delete a given service graph.

Expand
Table 64.95. Positional Arguments
ValueSummary

<service-graph>

Id or name of the service graph to delete.

Expand
Table 64.96. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

64.25. sfc service graph list

Usage:

openstack sfc service graph list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN] [--long]

List service graphs

Expand
Table 64.97. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 64.98. Output Formatters
ValueSummary

-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

Expand
Table 64.99. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.100. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.101. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

64.26. sfc service graph set

Usage:

openstack sfc service graph set [-h] [--name <name>]

                                     [--description <description>]
                                     <service-graph>

Set service graph properties

Expand
Table 64.102. Positional Arguments
ValueSummary

<service-graph>

Service graph to modify (name or id)

Expand
Table 64.103. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the service graph

--description <description>

Description for the service graph

This command is provided by the python-neutronclient plugin.

64.27. sfc service graph show

Usage:

openstack sfc service graph show [-h]

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

Show information of a given service graph.

Expand
Table 64.104. Positional Arguments
ValueSummary

<service-graph>

Id or name of the service graph to display.

Expand
Table 64.105. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 64.106. Output Formatters
ValueSummary

-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

Expand
Table 64.107. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 64.108. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 64.109. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

Chapter 65. snapshot

This chapter describes the commands under the snapshot command.

65.1. snapshot create

Usage:

openstack snapshot create [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] [--name <name>]
                               [--description <description>] [--force]
                               [--property <key=value>]
                               <volume>

Create new snapshot

Expand
Table 65.1. Positional Arguments
ValueSummary

<volume>

Volume to snapshot (name or id)

Expand
Table 65.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the snapshot

--description <description>

Description of the snapshot

--force

Create a snapshot attached to an instance. default is False

--property <key=value>

Set a property to this snapshot (repeat option to set multiple properties)

Expand
Table 65.3. Output Formatters
ValueSummary

-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

Expand
Table 65.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 65.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 65.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

65.2. snapshot delete

Usage:

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

Delete volume snapshot(s)

Expand
Table 65.7. Positional Arguments
ValueSummary

<snapshot>

Snapshot(s) to delete (name or id)

Expand
Table 65.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

65.3. snapshot list

Usage:

openstack snapshot list [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN] [--all-projects]
                             [--long] [--marker <snapshot>]
                             [--limit <num-snapshots>]

List snapshots

Expand
Table 65.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all-projects

Include all projects (admin only)

--long

List additional fields in output

--marker <snapshot>

The last snapshot id of the previous page

--limit <num-snapshots>

Maximum number of snapshots to display

Expand
Table 65.10. Output Formatters
ValueSummary

-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

Expand
Table 65.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 65.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 65.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

65.4. snapshot set

Usage:

openstack snapshot set [-h] [--name <name>]

                            [--description <description>]
                            [--property <key=value>] [--state <state>]
                            <snapshot>

Set snapshot properties

Expand
Table 65.14. Positional Arguments
ValueSummary

<snapshot>

Snapshot to modify (name or id)

Expand
Table 65.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New snapshot name

--description <description>

New snapshot description

--property <key=value>

Property to add/change for this snapshot (repeat option to set multiple properties)

--state <state>

New snapshot state. ("available", "error", "creating", "deleting", or "error_deleting") (admin only) (This option simply changes the state of the snapshot in the database with no regard to actual status, exercise caution when using)

65.5. snapshot show

Usage:

openstack snapshot show [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]
                             <snapshot>

Display snapshot details

Expand
Table 65.16. Positional Arguments
ValueSummary

<snapshot>

Snapshot to display (name or id)

Expand
Table 65.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 65.18. Output Formatters
ValueSummary

-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

Expand
Table 65.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 65.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 65.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

65.6. snapshot unset

Usage:

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

Unset snapshot properties

Expand
Table 65.22. Positional Arguments
ValueSummary

<snapshot>

Snapshot to modify (name or id)

Expand
Table 65.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from snapshot (repeat option to remove multiple properties)

Chapter 66. software

This chapter describes the commands under the software command.

66.1. software config create

Usage:

openstack software config create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--config-file <config-file>]
                                      [--definition-file <destination-file>]
                                      [--group <group>]
                                      <config-name>

Create software config

Expand
Table 66.1. Positional Arguments
ValueSummary

<config-name>

Name of the software config to create

Expand
Table 66.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--config-file <config-file>

Path to JSON/YAML containing map defining <inputs>,

<outputs>, and <options>

 

--definition-file <destination-file>

Path to software config script/data

--group <group>

Group name of tool expected by the software config

Expand
Table 66.3. Output Formatters
ValueSummary

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

the output format, defaults to json

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 66.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 66.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 66.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

66.2. software config delete

Usage:

openstack software config delete [-h] <config> [<config> ...]

Delete software configs

Expand
Table 66.7. Positional Arguments
ValueSummary

<config>

Ids of the software configs to delete

Expand
Table 66.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-heatclient plugin.

66.3. software config list

Usage:

openstack software config list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--limit <limit>] [--marker <id>]

List software configs

Expand
Table 66.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--limit <limit>

Limit the number of configs returned

--marker <id>

Return configs that appear after the given config id

Expand
Table 66.10. Output Formatters
ValueSummary

-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

Expand
Table 66.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 66.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 66.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

66.4. software config show

Usage:

openstack software config show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--config-only]
                                    <config>

Show software config details

Expand
Table 66.14. Positional Arguments
ValueSummary

<config>

Id of the config

Expand
Table 66.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--config-only

Only display the value of the <config> property.

Expand
Table 66.16. Output Formatters
ValueSummary

-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

Expand
Table 66.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 66.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 66.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

66.5. software deployment create

Usage:

openstack software deployment create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--input-value <key=value>]
                                          [--action <action>]
                                          [--config <config>]
                                          [--signal-transport <signal-transport>]
                                          [--container <container>]
                                          [--timeout <timeout>] --server
                                          <server>
                                          <deployment-name>

Create a software deployment.

Expand
Table 66.20. Positional Arguments
ValueSummary

<deployment-name>

Name of the derived config associated with this deployment. This is used to apply a sort order to the list of configurations currently deployed to the server.

Expand
Table 66.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--input-value <key=value>

Input value to set on the deployment. This can be specified multiple times.

--action <action>

Name of an action for this deployment. this can be a custom action, or one of CREATE, UPDATE, DELETE, SUSPEND, RESUME. Default is UPDATE

--config <config>

Id of the configuration to deploy

--signal-transport <signal-transport>

How the server should signal to heat with the deployment output values. TEMP_URL_SIGNAL will create a Swift TempURL to be signaled via HTTP PUT. ZAQAR_SIGNAL will create a dedicated zaqar queue to be signaled using the provided keystone credentials.NO_SIGNAL will result in the resource going to the COMPLETE state without waiting for any signal

--container <container>

Optional name of container to store TEMP_URL_SIGNAL objects in. If not specified a container will be created with a name derived from the DEPLOY_NAME

--timeout <timeout>

Deployment timeout in minutes

--server <server>

Id of the server being deployed to

Expand
Table 66.22. Output Formatters
ValueSummary

-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

Expand
Table 66.23. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 66.24. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 66.25. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

66.6. software deployment delete

Usage:

openstack software deployment delete [-h]

                                          <deployment> [<deployment> ...]

Delete software deployment(s) and correlative config(s).

Expand
Table 66.26. Positional Arguments
ValueSummary

<deployment>

Id of the deployment(s) to delete.

Expand
Table 66.27. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-heatclient plugin.

66.7. software deployment list

Usage:

openstack software deployment list [-h]

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

List software deployments.

Expand
Table 66.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--server <server>

Id of the server to fetch deployments for

--long

List more fields in output

Expand
Table 66.29. Output Formatters
ValueSummary

-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

Expand
Table 66.30. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 66.31. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 66.32. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

66.8. software deployment metadata show

Usage:

openstack software deployment metadata show [-h] <server>

Get deployment configuration metadata for the specified server.

Expand
Table 66.33. Positional Arguments
ValueSummary

<server>

Id of the server to fetch deployments for

Expand
Table 66.34. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-heatclient plugin.

66.9. software deployment output show

Usage:

openstack software deployment output show [-h] [--all] [--long]

                                               <deployment> [<output-name>]

Show a specific deployment output.

Expand
Table 66.35. Positional Arguments
ValueSummary

<deployment>

Id of deployment to show the output for

<output-name>

Name of an output to display

Expand
Table 66.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all

Display all deployment outputs

--long

Show full deployment logs in output

This command is provided by the python-heatclient plugin.

66.10. software deployment show

Usage:

openstack software deployment show [-h]

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

Show SoftwareDeployment Details.

Expand
Table 66.37. Positional Arguments
ValueSummary

<deployment>

Id of the deployment

Expand
Table 66.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

Show more fields in output

Expand
Table 66.39. Output Formatters
ValueSummary

-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

Expand
Table 66.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 66.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 66.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

Chapter 67. stack

This chapter describes the commands under the stack command.

67.1. stack abandon

Usage:

openstack stack abandon [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--output-file <output-file>]
                             <stack>

Abandon stack and output results.

Expand
Table 67.1. Positional Arguments
ValueSummary

<stack>

Name or id of stack to abandon

Expand
Table 67.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--output-file <output-file>

File to output abandon results

Expand
Table 67.3. Output Formatters
ValueSummary

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

the output format, defaults to json

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 67.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.2. stack adopt

Usage:

openstack stack adopt [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [-e <environment>] [--timeout <timeout>]
                           [--enable-rollback] [--parameter <key=value>]
                           [--wait] --adopt-file <adopt-file>
                           <stack-name>

Adopt a stack.

Expand
Table 67.7. Positional Arguments
ValueSummary

<stack-name>

Name of the stack to adopt

Expand
Table 67.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-e <environment>, --environment <environment>

Path to the environment. Can be specified multiple times

--timeout <timeout>

Stack creation timeout in minutes

--enable-rollback

Enable rollback on create/update failure

--parameter <key=value>

Parameter values used to create the stack. Can be specified multiple times

--wait

Wait until stack adopt completes

--adopt-file <adopt-file>

Path to adopt stack data file

Expand
Table 67.9. Output Formatters
ValueSummary

-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

Expand
Table 67.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.12. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.3. stack cancel

Usage:

openstack stack cancel [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--wait]
                            [--no-rollback]
                            <stack> [<stack> ...]

Cancel current task for a stack. Supported tasks for cancellation: * update * create

Expand
Table 67.13. Positional Arguments
ValueSummary

<stack>

Stack(s) to cancel (name or id)

Expand
Table 67.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for cancel to complete

--no-rollback

Cancel without rollback

Expand
Table 67.15. Output Formatters
ValueSummary

-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

Expand
Table 67.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.18. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.4. stack check

Usage:

openstack stack check [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--wait]
                           <stack> [<stack> ...]

Check a stack.

Expand
Table 67.19. Positional Arguments
ValueSummary

<stack>

Stack(s) to check update (name or id)

Expand
Table 67.20. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for check to complete

Expand
Table 67.21. Output Formatters
ValueSummary

-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

Expand
Table 67.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.24. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.5. stack create

Usage:

openstack stack create [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [-e <environment>]
                            [--timeout <timeout>] [--pre-create <resource>]
                            [--enable-rollback] [--parameter <key=value>]
                            [--parameter-file <key=file>] [--wait]
                            [--tags <tag1,tag2...>] [--dry-run] -t
                            <template>
                            <stack-name>

Create a stack.

Expand
Table 67.25. Positional Arguments
ValueSummary

<stack-name>

Name of the stack to create

Expand
Table 67.26. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-e <environment>, --environment <environment>

Path to the environment. Can be specified multiple times

--timeout <timeout>

Stack creating timeout in minutes

--pre-create <resource>

Name of a resource to set a pre-create hook to. Resources in nested stacks can be set using slash as a separator: nested_stack/another/my_resource. You can use wildcards to match multiple stacks or resources: nested_stack/an*/*_resource. This can be specified multiple times

--enable-rollback

Enable rollback on create/update failure

--parameter <key=value>

Parameter values used to create the stack. This can be specified multiple times

--parameter-file <key=file>

Parameter values from file used to create the stack. This can be specified multiple times. Parameter values would be the content of the file

--wait

Wait until stack goes to create_complete or CREATE_FAILED

--tags <tag1,tag2…​>

A list of tags to associate with the stack

--dry-run

Do not actually perform the stack create, but show what would be created

-t <template>, --template <template>

Path to the template

Expand
Table 67.27. Output Formatters
ValueSummary

-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

Expand
Table 67.28. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.29. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.30. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.6. stack delete

Usage:

openstack stack delete [-h] [-y] [--wait] <stack> [<stack> ...]

Delete stack(s).

Expand
Table 67.31. Positional Arguments
ValueSummary

<stack>

Stack(s) to delete (name or id)

Expand
Table 67.32. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-y, --yes

Skip yes/no prompt (assume yes)

--wait

Wait for stack delete to complete

This command is provided by the python-heatclient plugin.

67.7. stack environment show

Usage:

openstack stack environment show [-h]

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

Show a stack’s environment.

Expand
Table 67.33. Positional Arguments
ValueSummary

<NAME or ID>

Name or id of stack to query

Expand
Table 67.34. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.35. Output Formatters
ValueSummary

-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

Expand
Table 67.36. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.38. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.8. stack event list

Usage:

openstack stack event list [-h] [-f {csv,json,log,table,value,yaml}]

                                [-c COLUMN] [--noindent]
                                [--max-width <integer>] [--fit-width]
                                [--print-empty]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN]
                                [--resource <resource>]
                                [--filter <key=value>] [--limit <limit>]
                                [--marker <id>] [--nested-depth <depth>]
                                [--sort <key>[:<direction>]] [--follow]
                                <stack>

List events.

Expand
Table 67.39. Positional Arguments
ValueSummary

<stack>

Name or id of stack to show events for

Expand
Table 67.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resource <resource>

Name of resource to show events for. Note: this cannot be specified with --nested-depth

--filter <key=value>

Filter parameters to apply on returned events

--limit <limit>

Limit the number of events returned

--marker <id>

Only return events that appear after the given id

--nested-depth <depth>

Depth of nested stacks from which to display events. Note: this cannot be specified with --resource

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

Sort output by selected keys and directions (asc or desc) (default: asc). Specify multiple times to sort on multiple keys. Sort key can be: "event_time" (default), "resource_name", "links", "logical_resource_id", "resource_status", "resource_status_reason", "physical_resource_id", or "id". You can leave the key empty and specify ":desc" for sorting by reverse time.

--follow

Print events until process is halted

Expand
Table 67.41. Output Formatters
ValueSummary

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

the output format, defaults to log

-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

Expand
Table 67.42. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.43. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.44. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.9. stack event show

Usage:

openstack stack event show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <stack> <resource> <event>

Show event details.

Expand
Table 67.45. Positional Arguments
ValueSummary

<stack>

Name or id of stack to show events for

<resource>

Name of the resource event belongs to

<event>

Id of event to display details for

Expand
Table 67.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.47. Output Formatters
ValueSummary

-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

Expand
Table 67.48. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.49. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.50. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.10. stack export

Usage:

openstack stack export [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--output-file <output-file>]
                            <stack>

Export stack data json.

Expand
Table 67.51. Positional Arguments
ValueSummary

<stack>

Name or id of stack to export

Expand
Table 67.52. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--output-file <output-file>

File to output export data

Expand
Table 67.53. Output Formatters
ValueSummary

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

the output format, defaults to json

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 67.54. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.55. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.56. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.11. stack failures list

Usage:

openstack stack failures list [-h] [--long] <stack>

Show information about failed stack resources.

Expand
Table 67.57. Positional Arguments
ValueSummary

<stack>

Stack to display (name or id)

Expand
Table 67.58. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

Show full deployment logs in output

This command is provided by the python-heatclient plugin.

67.12. stack file list

Usage:

openstack stack file list [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX]
                               <NAME or ID>

Show a stack’s files map.

Expand
Table 67.59. Positional Arguments
ValueSummary

<NAME or ID>

Name or id of stack to query

Expand
Table 67.60. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.61. Output Formatters
ValueSummary

-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

Expand
Table 67.62. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.63. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.64. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.13. stack hook clear

Usage:

openstack stack hook clear [-h] [--pre-create] [--pre-update]

                                [--pre-delete]
                                <stack> <resource> [<resource> ...]

Clear resource hooks on a given stack.

Expand
Table 67.65. Positional Arguments
ValueSummary

<stack>

Stack to display (name or id)

<resource>

Resource names with hooks to clear. resources in nested stacks can be set using slash as a separator: nested_stack/another/my_resource. You can use wildcards to match multiple stacks or resources: nested_stack/an*/*_resource

Expand
Table 67.66. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--pre-create

Clear the pre-create hooks

--pre-update

Clear the pre-update hooks

--pre-delete

Clear the pre-delete hooks

This command is provided by the python-heatclient plugin.

67.14. stack hook poll

Usage:

openstack stack hook poll [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN]
                               [--nested-depth <nested-depth>]
                               <stack>

List resources with pending hook for a stack.

Expand
Table 67.67. Positional Arguments
ValueSummary

<stack>

Stack to display (name or id)

Expand
Table 67.68. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--nested-depth <nested-depth>

Depth of nested stacks from which to display hooks

Expand
Table 67.69. Output Formatters
ValueSummary

-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

Expand
Table 67.70. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.71. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.72. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.15. stack list

Usage:

openstack stack list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                          [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}]
                          [--sort-column SORT_COLUMN] [--deleted] [--nested]
                          [--hidden] [--property <key=value>]
                          [--tags <tag1,tag2...>] [--tag-mode <mode>]
                          [--limit <limit>] [--marker <id>]
                          [--sort <key>[:<direction>]] [--all-projects]
                          [--short] [--long]

List stacks.

Expand
Table 67.73. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--deleted

Include soft-deleted stacks in the stack listing

--nested

Include nested stacks in the stack listing

--hidden

Include hidden stacks in the stack listing

--property <key=value>

Filter properties to apply on returned stacks (repeat to filter on multiple properties)

--tags <tag1,tag2…​>

List of tags to filter by. Can be combined with --tag- mode to specify how to filter tags

--tag-mode <mode>

Method of filtering tags. must be one of "any", "not", or "not-any". If not specified, multiple tags will be combined with the boolean AND expression

--limit <limit>

The number of stacks returned

--marker <id>

Only return stacks that appear after the given id

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

Sort output by selected keys and directions (asc or desc) (default: asc). Specify multiple times to sort on multiple properties

--all-projects

Include all projects (admin only)

--short

List fewer fields in output

--long

List additional fields in output, this is implied by

--all-projects

 
Expand
Table 67.74. Output Formatters
ValueSummary

-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

Expand
Table 67.75. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.76. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.77. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.16. stack output list

Usage:

openstack stack output list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]
                                 <stack>

List stack outputs.

Expand
Table 67.78. Positional Arguments
ValueSummary

<stack>

Name or id of stack to query

Expand
Table 67.79. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.80. Output Formatters
ValueSummary

-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

Expand
Table 67.81. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.82. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.83. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.17. stack output show

Usage:

openstack stack output show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX] [--all]
                                 <stack> [<output>]

Show stack output.

Expand
Table 67.84. Positional Arguments
ValueSummary

<stack>

Name or id of stack to query

<output>

Name of an output to display

Expand
Table 67.85. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all

Display all stack outputs

Expand
Table 67.86. Output Formatters
ValueSummary

-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

Expand
Table 67.87. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.88. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.89. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.18. stack resource list

Usage:

openstack stack resource list [-h] [-f {csv,dot,json,table,value,yaml}]

                                   [-c COLUMN] [--noindent]
                                   [--max-width <integer>] [--fit-width]
                                   [--print-empty]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN] [--long]
                                   [-n <nested-depth>]
                                   [--filter <key=value>]
                                   <stack>

List stack resources.

Expand
Table 67.90. Positional Arguments
ValueSummary

<stack>

Name or id of stack to query

Expand
Table 67.91. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

Enable detailed information presented for each resource in resource list

-n <nested-depth>, --nested-depth <nested-depth>

Depth of nested stacks from which to display resources

--filter <key=value>

Filter parameters to apply on returned resources based on their name, status, type, action, id and physical_resource_id

Expand
Table 67.92. Output Formatters
ValueSummary

-f {csv,dot,json,table,value,yaml}, --format {csv,dot,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

Expand
Table 67.93. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.94. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.95. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.19. stack resource mark unhealthy

Usage:

openstack stack resource mark unhealthy [-h] [--reset]

                                             <stack> <resource> [reason]

Set resource’s health.

Expand
Table 67.96. Positional Arguments
ValueSummary

<stack>

Name or id of stack the resource belongs to

<resource>

Name of the resource

reason

Reason for state change

Expand
Table 67.97. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--reset

Set the resource as healthy

This command is provided by the python-heatclient plugin.

67.20. stack resource metadata

Usage:

openstack stack resource metadata [-h]

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

Show resource metadata

Expand
Table 67.98. Positional Arguments
ValueSummary

<stack>

Stack to display (name or id)

<resource>

Name of the resource to show the metadata for

Expand
Table 67.99. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.100. Output Formatters
ValueSummary

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

the output format, defaults to json

-c COLUMN, --column COLUMN

specify the column(s) to include, can be repeated

Expand
Table 67.101. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.102. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.103. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.21. stack resource show

Usage:

openstack stack resource show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--with-attr <attribute>]
                                   <stack> <resource>

Display stack resource.

Expand
Table 67.104. Positional Arguments
ValueSummary

<stack>

Name or id of stack to query

<resource>

Name of resource

Expand
Table 67.105. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--with-attr <attribute>

Attribute to show, can be specified multiple times

Expand
Table 67.106. Output Formatters
ValueSummary

-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

Expand
Table 67.107. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.108. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.109. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.22. stack resource signal

Usage:

openstack stack resource signal [-h] [--data <data>]

                                     [--data-file <data-file>]
                                     <stack> <resource>

Signal a resource with optional data.

Expand
Table 67.110. Positional Arguments
ValueSummary

<stack>

Name or id of stack the resource belongs to

<resource>

Name of the resoure to signal

Expand
Table 67.111. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--data <data>

Json data to send to the signal handler

--data-file <data-file>

File containing JSON data to send to the signal handler

This command is provided by the python-heatclient plugin.

67.23. stack resume

Usage:

openstack stack resume [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--wait]
                            <stack> [<stack> ...]

Resume a stack.

Expand
Table 67.112. Positional Arguments
ValueSummary

<stack>

Stack(s) to resume (name or id)

Expand
Table 67.113. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for resume to complete

Expand
Table 67.114. Output Formatters
ValueSummary

-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

Expand
Table 67.115. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.116. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.117. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.24. stack show

Usage:

openstack stack show [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          [--no-resolve-outputs]
                          <stack>

Show stack details.

Expand
Table 67.118. Positional Arguments
ValueSummary

<stack>

Stack to display (name or id)

Expand
Table 67.119. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--no-resolve-outputs

Do not resolve outputs of the stack.

Expand
Table 67.120. Output Formatters
ValueSummary

-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

Expand
Table 67.121. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.122. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.123. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.25. stack snapshot create

Usage:

openstack stack snapshot create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--name <name>]
                                     <stack>

Create stack snapshot.

Expand
Table 67.124. Positional Arguments
ValueSummary

<stack>

Name or id of stack

Expand
Table 67.125. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of snapshot

Expand
Table 67.126. Output Formatters
ValueSummary

-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

Expand
Table 67.127. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.128. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.129. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.26. stack snapshot delete

Usage:

openstack stack snapshot delete [-h] [-y] <stack> <snapshot>

Delete stack snapshot.

Expand
Table 67.130. Positional Arguments
ValueSummary

<stack>

Name or id of stack

<snapshot>

Id of stack snapshot

Expand
Table 67.131. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-y, --yes

Skip yes/no prompt (assume yes)

This command is provided by the python-heatclient plugin.

67.27. stack snapshot list

Usage:

openstack stack snapshot list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   <stack>

List stack snapshots.

Expand
Table 67.132. Positional Arguments
ValueSummary

<stack>

Name or id of stack containing the snapshots

Expand
Table 67.133. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.134. Output Formatters
ValueSummary

-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

Expand
Table 67.135. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.136. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.137. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.28. stack snapshot restore

Usage:

openstack stack snapshot restore [-h] <stack> <snapshot>

Restore stack snapshot

Expand
Table 67.138. Positional Arguments
ValueSummary

<stack>

Name or id of stack containing the snapshot

<snapshot>

Id of the snapshot to restore

Expand
Table 67.139. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-heatclient plugin.

67.29. stack snapshot show

Usage:

openstack stack snapshot show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <stack> <snapshot>

Show stack snapshot.

Expand
Table 67.140. Positional Arguments
ValueSummary

<stack>

Name or id of stack containing the snapshot

<snapshot>

Id of the snapshot to show

Expand
Table 67.141. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.142. Output Formatters
ValueSummary

-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

Expand
Table 67.143. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.144. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.145. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.30. stack suspend

Usage:

openstack stack suspend [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN] [--wait]
                             <stack> [<stack> ...]

Suspend a stack.

Expand
Table 67.146. Positional Arguments
ValueSummary

<stack>

Stack(s) to suspend (name or id)

Expand
Table 67.147. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for suspend to complete

Expand
Table 67.148. Output Formatters
ValueSummary

-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

Expand
Table 67.149. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.150. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.151. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-heatclient plugin.

67.31. stack template show

Usage:

openstack stack template show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <stack>

Display stack template.

Expand
Table 67.152. Positional Arguments
ValueSummary

<stack>

Name or id of stack to query

Expand
Table 67.153. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 67.154. Output Formatters
ValueSummary

-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

Expand
Table 67.155. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.156. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.157. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

67.32. stack update

Usage:

openstack stack update [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [-t <template>]
                            [-e <environment>] [--pre-update <resource>]
                            [--timeout <timeout>] [--rollback <value>]
                            [--dry-run] [--show-nested]
                            [--parameter <key=value>]
                            [--parameter-file <key=file>] [--existing]
                            [--clear-parameter <parameter>]
                            [--tags <tag1,tag2...>] [--wait] [--converge]
                            <stack>

Update a stack.

Expand
Table 67.158. Positional Arguments
ValueSummary

<stack>

Name or id of stack to update

Expand
Table 67.159. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

-t <template>, --template <template>

Path to the template

-e <environment>, --environment <environment>

Path to the environment. Can be specified multiple times

--pre-update <resource>

Name of a resource to set a pre-update hook to. Resources in nested stacks can be set using slash as a separator: nested_stack/another/my_resource. You can use wildcards to match multiple stacks or resources: nested_stack/an*/*_resource. This can be specified multiple times

--timeout <timeout>

Stack update timeout in minutes

--rollback <value>

Set rollback on update failure. value "enabled" sets rollback to enabled. Value "disabled" sets rollback to disabled. Value "keep" uses the value of existing stack to be updated (default)

--dry-run

Do not actually perform the stack update, but show what would be changed

--show-nested

Show nested stacks when performing --dry-run

--parameter <key=value>

Parameter values used to create the stack. This can be specified multiple times

--parameter-file <key=file>

Parameter values from file used to create the stack. This can be specified multiple times. Parameter value would be the content of the file

--existing

Re-use the template, parameters and environment of the current stack. If the template argument is omitted then the existing template is used. If no

--environment is specified then the existing

environment is used. Parameters specified in

--parameter will patch over the existing values in the

current stack. Parameters omitted will keep the existing values

--clear-parameter <parameter>

Remove the parameters from the set of parameters of current stack for the stack-update. The default value in the template will be used. This can be specified multiple times

--tags <tag1,tag2…​>

An updated list of tags to associate with the stack

--wait

Wait until stack goes to update_complete or UPDATE_FAILED

--converge

Stack update with observe on reality.

Expand
Table 67.160. Output Formatters
ValueSummary

-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

Expand
Table 67.161. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 67.162. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 67.163. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-heatclient plugin.

Chapter 68. subnet

This chapter describes the commands under the subnet command.

68.1. subnet create

Usage:

openstack subnet create [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--project <project>]
                             [--project-domain <project-domain>]
                             [--subnet-pool <subnet-pool> | --use-prefix-delegation USE_PREFIX_DELEGATION | --use-default-subnet-pool]
                             [--prefix-length <prefix-length>]
                             [--subnet-range <subnet-range>]
                             [--dhcp | --no-dhcp] [--gateway <gateway>]
                             [--ip-version {4,6}]
                             [--ipv6-ra-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}]
                             [--ipv6-address-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}]
                             [--network-segment <network-segment>] --network
                             <network> [--description <description>]
                             [--allocation-pool start=<ip-address>,end=<ip-address>]
                             [--dns-nameserver <dns-nameserver>]
                             [--host-route destination=<subnet>,gateway=<ip-address>]
                             [--service-type <service-type>]
                             [--tag <tag> | --no-tag]
                             name

Create a subnet

Expand
Table 68.1. Positional Arguments
ValueSummary

name

New subnet name

Expand
Table 68.2. Optional Arguments
ValueSummary

-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.

--subnet-pool <subnet-pool>

Subnet pool from which this subnet will obtain a CIDR (Name or ID)

--use-prefix-delegation USE_PREFIX_DELEGATION

Use 'prefix-delegation' if IP is IPv6 format and IP would be delegated externally

--use-default-subnet-pool

Use default subnet pool for --ip-version

--prefix-length <prefix-length>

Prefix length for subnet allocation from subnet pool

--subnet-range <subnet-range>

Subnet range in CIDR notation (required if --subnet- pool is not specified, optional otherwise)

--dhcp

Enable dhcp (default)

--no-dhcp

Disable dhcp

--gateway <gateway>

Specify a gateway for the subnet. the three options are: <ip-address>: Specific IP address to use as the gateway, 'auto': Gateway address should automatically be chosen from within the subnet itself, 'none': This subnet will not use a gateway, e.g.: --gateway 192.168.9.1, --gateway auto, --gateway none (default is 'auto').

--ip-version {4,6}

Ip version (default is 4). note that when subnet pool is specified, IP version is determined from the subnet pool and this option is ignored.

--ipv6-ra-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}

IPv6 RA (Router Advertisement) mode, valid modes: [dhcpv6-stateful, dhcpv6-stateless, slaac]

--ipv6-address-mode {dhcpv6-stateful,dhcpv6-stateless,slaac}

IPv6 address mode, valid modes: [dhcpv6-stateful, dhcpv6-stateless, slaac]

--network-segment <network-segment>

Network segment to associate with this subnet (name or ID)

--network <network>

Network this subnet belongs to (name or id)

--description <description>

Set subnet description

--allocation-pool start=<ip-address>,end=<ip-address>

Allocation pool IP addresses for this subnet e.g.: start=192.168.199.2,end=192.168.199.254 (repeat option to add multiple IP addresses)

--dns-nameserver <dns-nameserver>

DNS server for this subnet (repeat option to set multiple DNS servers)

--host-route destination=<subnet>,gateway=<ip-address>

Additional route for this subnet e.g.: destination=10.10.0.0/16,gateway=192.168.71.254 destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to add multiple routes)

--service-type <service-type>

Service type for this subnet e.g.: network:floatingip_agent_gateway. Must be a valid device owner value for a network port (repeat option to set multiple service types)

--tag <tag>

Tag to be added to the subnet (repeat option to set multiple tags)

--no-tag

No tags associated with the subnet

Expand
Table 68.3. Output Formatters
ValueSummary

-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

Expand
Table 68.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 68.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 68.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

68.2. subnet delete

Usage:

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

Delete subnet(s)

Expand
Table 68.7. Positional Arguments
ValueSummary

<subnet>

Subnet(s) to delete (name or id)

Expand
Table 68.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

68.3. subnet list

Usage:

openstack subnet list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--long]
                           [--ip-version <ip-version>] [--dhcp | --no-dhcp]
                           [--service-type <service-type>]
                           [--project <project>]
                           [--project-domain <project-domain>]
                           [--network <network>] [--gateway <gateway>]
                           [--name <name>] [--subnet-range <subnet-range>]
                           [--tags <tag>[,<tag>,...]]
                           [--any-tags <tag>[,<tag>,...]]
                           [--not-tags <tag>[,<tag>,...]]
                           [--not-any-tags <tag>[,<tag>,...]]

List subnets

Expand
Table 68.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--ip-version <ip-version>

List only subnets of given IP version in output.Allowed values for IP version are 4 and 6.

--dhcp

List subnets which have dhcp enabled

--no-dhcp

List subnets which have dhcp disabled

--service-type <service-type>

List only subnets of a given service type in output e.g.: network:floatingip_agent_gateway. Must be a valid device owner value for a network port (repeat option to list multiple service types)

--project <project>

List only subnets which belong to a given project in output (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.

--network <network>

List only subnets which belong to a given network in output (name or ID)

--gateway <gateway>

List only subnets of given gateway ip in output

--name <name>

List only subnets of given name in output

--subnet-range <subnet-range>

List only subnets of given subnet range (in CIDR notation) in output e.g.: --subnet-range 10.10.0.0/16

--tags <tag>[,<tag>,…​]

List subnets which have all given tag(s) (Comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List subnets which have any given tag(s) (Comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude subnets which have all given tag(s) (Comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude subnets which have any given tag(s) (Comma- separated list of tags)

Expand
Table 68.10. Output Formatters
ValueSummary

-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

Expand
Table 68.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 68.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 68.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

68.4. subnet pool create

Usage:

openstack subnet pool create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] --pool-prefix
                                  <pool-prefix>
                                  [--default-prefix-length <default-prefix-length>]
                                  [--min-prefix-length <min-prefix-length>]
                                  [--max-prefix-length <max-prefix-length>]
                                  [--project <project>]
                                  [--project-domain <project-domain>]
                                  [--address-scope <address-scope>]
                                  [--default | --no-default]
                                  [--share | --no-share]
                                  [--description <description>]
                                  [--default-quota <num-ip-addresses>]
                                  [--tag <tag> | --no-tag]
                                  <name>

Create subnet pool

Expand
Table 68.14. Positional Arguments
ValueSummary

<name>

Name of the new subnet pool

Expand
Table 68.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--pool-prefix <pool-prefix>

Set subnet pool prefixes (in CIDR notation) (repeat option to set multiple prefixes)

--default-prefix-length <default-prefix-length>

Set subnet pool default prefix length

--min-prefix-length <min-prefix-length>

Set subnet pool minimum prefix length

--max-prefix-length <max-prefix-length>

Set subnet pool maximum prefix length

--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.

--address-scope <address-scope>

Set address scope associated with the subnet pool (name or ID), prefixes must be unique across address scopes

--default

Set this as a default subnet pool

--no-default

Set this as a non-default subnet pool

--share

Set this subnet pool as shared

--no-share

Set this subnet pool as not shared

--description <description>

Set subnet pool description

--default-quota <num-ip-addresses>

Set default quota for subnet pool as the number ofIP addresses allowed in a subnet

--tag <tag>

Tag to be added to the subnet pool (repeat option to set multiple tags)

--no-tag

No tags associated with the subnet pool

Expand
Table 68.16. Output Formatters
ValueSummary

-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

Expand
Table 68.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 68.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 68.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

68.5. subnet pool delete

Usage:

openstack subnet pool delete [-h] <subnet-pool> [<subnet-pool> ...]

Delete subnet pool(s)

Expand
Table 68.20. Positional Arguments
ValueSummary

<subnet-pool>

Subnet pool(s) to delete (name or id)

Expand
Table 68.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

68.6. subnet pool list

Usage:

openstack subnet pool list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN] [--long]
                                [--share | --no-share]
                                [--default | --no-default]
                                [--project <project>]
                                [--project-domain <project-domain>]
                                [--name <name>]
                                [--address-scope <address-scope>]
                                [--tags <tag>[,<tag>,...]]
                                [--any-tags <tag>[,<tag>,...]]
                                [--not-tags <tag>[,<tag>,...]]
                                [--not-any-tags <tag>[,<tag>,...]]

List subnet pools

Expand
Table 68.22. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--share

List subnet pools shared between projects

--no-share

List subnet pools not shared between projects

--default

List subnet pools used as the default external subnet pool

--no-default

List subnet pools not used as the default external subnet pool

--project <project>

List subnet pools 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.

--name <name>

List only subnet pools of given name in output

--address-scope <address-scope>

List only subnet pools of given address scope in output (name or ID)

--tags <tag>[,<tag>,…​]

List subnet pools which have all given tag(s) (Comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List subnet pools which have any given tag(s) (Comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude subnet pools which have all given tag(s) (Comma-separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude subnet pools which have any given tag(s) (Comma-separated list of tags)

Expand
Table 68.23. Output Formatters
ValueSummary

-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

Expand
Table 68.24. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 68.25. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 68.26. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

68.7. subnet pool set

Usage:

openstack subnet pool set [-h] [--name <name>]

                               [--pool-prefix <pool-prefix>]
                               [--default-prefix-length <default-prefix-length>]
                               [--min-prefix-length <min-prefix-length>]
                               [--max-prefix-length <max-prefix-length>]
                               [--address-scope <address-scope> | --no-address-scope]
                               [--default | --no-default]
                               [--description <description>]
                               [--default-quota <num-ip-addresses>]
                               [--tag <tag>] [--no-tag]
                               <subnet-pool>

Set subnet pool properties

Expand
Table 68.27. Positional Arguments
ValueSummary

<subnet-pool>

Subnet pool to modify (name or id)

Expand
Table 68.28. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set subnet pool name

--pool-prefix <pool-prefix>

Set subnet pool prefixes (in CIDR notation) (repeat option to set multiple prefixes)

--default-prefix-length <default-prefix-length>

Set subnet pool default prefix length

--min-prefix-length <min-prefix-length>

Set subnet pool minimum prefix length

--max-prefix-length <max-prefix-length>

Set subnet pool maximum prefix length

--address-scope <address-scope>

Set address scope associated with the subnet pool (name or ID), prefixes must be unique across address scopes

--no-address-scope

Remove address scope associated with the subnet pool

--default

Set this as a default subnet pool

--no-default

Set this as a non-default subnet pool

--description <description>

Set subnet pool description

--default-quota <num-ip-addresses>

Set default quota for subnet pool as the number ofIP addresses allowed in a subnet

--tag <tag>

Tag to be added to the subnet pool (repeat option to set multiple tags)

--no-tag

Clear tags associated with the subnet pool. specify both --tag and --no-tag to overwrite current tags

68.8. subnet pool show

Usage:

openstack subnet pool show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <subnet-pool>

Display subnet pool details

Expand
Table 68.29. Positional Arguments
ValueSummary

<subnet-pool>

Subnet pool to display (name or id)

Expand
Table 68.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 68.31. Output Formatters
ValueSummary

-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

Expand
Table 68.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 68.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 68.34. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

68.9. subnet pool unset

Usage:

openstack subnet pool unset [-h] [--pool-prefix <pool-prefix>]

                                 [--tag <tag> | --all-tag]
                                 <subnet-pool>

Unset subnet pool properties

Expand
Table 68.35. Positional Arguments
ValueSummary

<subnet-pool>

Subnet pool to modify (name or id)

Expand
Table 68.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--pool-prefix <pool-prefix>

Remove subnet pool prefixes (in CIDR notation). (repeat option to unset multiple prefixes).

--tag <tag>

Tag to be removed from the subnet pool (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the subnet pool

68.10. subnet set

Usage:

openstack subnet set [-h] [--name <name>] [--dhcp | --no-dhcp]

                          [--gateway <gateway>]
                          [--network-segment <network-segment>]
                          [--description <description>] [--tag <tag>]
                          [--no-tag]
                          [--allocation-pool start=<ip-address>,end=<ip-address>]
                          [--no-allocation-pool]
                          [--dns-nameserver <dns-nameserver>]
                          [--no-dns-nameservers]
                          [--host-route destination=<subnet>,gateway=<ip-address>]
                          [--no-host-route] [--service-type <service-type>]
                          <subnet>

Set subnet properties

Expand
Table 68.37. Positional Arguments
ValueSummary

<subnet>

Subnet to modify (name or id)

Expand
Table 68.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Updated name of the subnet

--dhcp

Enable dhcp

--no-dhcp

Disable dhcp

--gateway <gateway>

Specify a gateway for the subnet. the options are:

<ip-address>: Specific IP address to use as the

gateway, 'none': This subnet will not use a gateway, e.g.: --gateway 192.168.9.1, --gateway none.

--network-segment <network-segment>

Network segment to associate with this subnet (name or ID). It is only allowed to set the segment if the current value is None, the network must also have only one segment and only one subnet can exist on the network.

--description <description>

Set subnet description

--tag <tag>

Tag to be added to the subnet (repeat option to set multiple tags)

--no-tag

Clear tags associated with the subnet. specify both

--tag and --no-tag to overwrite current tags

 

--allocation-pool start=<ip-address>,end=<ip-address>

Allocation pool IP addresses for this subnet e.g.: start=192.168.199.2,end=192.168.199.254 (repeat option to add multiple IP addresses)

--no-allocation-pool

Clear associated allocation-pools from the subnet. Specify both --allocation-pool and --no-allocation- pool to overwrite the current allocation pool information.

--dns-nameserver <dns-nameserver>

DNS server for this subnet (repeat option to set multiple DNS servers)

--no-dns-nameservers

Clear existing information of dns nameservers. specify both --dns-nameserver and --no-dns-nameserver to overwrite the current DNS Nameserver information.

--host-route destination=<subnet>,gateway=<ip-address>

Additional route for this subnet e.g.: destination=10.10.0.0/16,gateway=192.168.71.254 destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to add multiple routes)

--no-host-route

Clear associated host-routes from the subnet. specify both --host-route and --no-host-route to overwrite the current host route information.

--service-type <service-type>

Service type for this subnet e.g.: network:floatingip_agent_gateway. Must be a valid device owner value for a network port (repeat option to set multiple service types)

68.11. subnet show

Usage:

openstack subnet show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           <subnet>

Display subnet details

Expand
Table 68.39. Positional Arguments
ValueSummary

<subnet>

Subnet to display (name or id)

Expand
Table 68.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 68.41. Output Formatters
ValueSummary

-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

Expand
Table 68.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 68.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 68.44. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

68.12. subnet unset

Usage:

openstack subnet unset [-h]

                            [--allocation-pool start=<ip-address>,end=<ip-address>]
                            [--dns-nameserver <dns-nameserver>]
                            [--host-route destination=<subnet>,gateway=<ip-address>]
                            [--service-type <service-type>]
                            [--tag <tag> | --all-tag]
                            <subnet>

Unset subnet properties

Expand
Table 68.45. Positional Arguments
ValueSummary

<subnet>

Subnet to modify (name or id)

Expand
Table 68.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--allocation-pool start=<ip-address>,end=<ip-address>

Allocation pool IP addresses to be removed from this subnet e.g.: start=192.168.199.2,end=192.168.199.254 (repeat option to unset multiple allocation pools)

--dns-nameserver <dns-nameserver>

DNS server to be removed from this subnet (repeat option to unset multiple DNS servers)

--host-route destination=<subnet>,gateway=<ip-address>

Route to be removed from this subnet e.g.: destination=10.10.0.0/16,gateway=192.168.71.254 destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to unset multiple host routes)

--service-type <service-type>

Service type to be removed from this subnet e.g.: network:floatingip_agent_gateway. Must be a valid device owner value for a network port (repeat option to unset multiple service types)

--tag <tag>

Tag to be removed from the subnet (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the subnet

Chapter 69. task

This chapter describes the commands under the task command.

69.1. task execution list

Usage:

openstack task execution list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--filter FILTERS] [--limit [LIMIT]]
                                   [workflow_execution]

List all tasks.

Expand
Table 69.1. Positional Arguments
ValueSummary

workflow_execution

Workflow execution id associated with list of tasks.

Expand
Table 69.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--filter FILTERS

Filters. can be repeated.

--limit [LIMIT]

Maximum number of tasks to return in a single result. limit is set to 100 by default. Use --limit -1 to fetch the full result set.

Expand
Table 69.3. Output Formatters
ValueSummary

-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

Expand
Table 69.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 69.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 69.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

69.2. task execution published show

Usage:

openstack task execution published show [-h] id

Show task published variables.

Expand
Table 69.7. Positional Arguments
ValueSummary

id

Task id

Expand
Table 69.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

69.3. task execution rerun

Usage:

openstack task execution rerun [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--resume] [-e ENV]
                                    id

Rerun an existing task.

Expand
Table 69.9. Positional Arguments
ValueSummary

id

Task identifier

Expand
Table 69.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--resume

Rerun only failed or unstarted action executions for with-items task

-e ENV, --env ENV

Environment variables

Expand
Table 69.11. Output Formatters
ValueSummary

-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

Expand
Table 69.12. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 69.13. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 69.14. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

69.4. task execution result show

Usage:

openstack task execution result show [-h] id

Show task output data.

Expand
Table 69.15. Positional Arguments
ValueSummary

id

Task id

Expand
Table 69.16. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

69.5. task execution show

Usage:

openstack task execution show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   task

Show specific task.

Expand
Table 69.17. Positional Arguments
ValueSummary

task

Task identifier

Expand
Table 69.18. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 69.19. Output Formatters
ValueSummary

-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

Expand
Table 69.20. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 69.21. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 69.22. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 70. tld

This chapter describes the commands under the tld command.

70.1. tld create

Usage:

openstack tld create [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          --name NAME [--description DESCRIPTION]
                          [--all-projects] [--edit-managed]
                          [--sudo-project-id SUDO_PROJECT_ID]

Create new tld

Expand
Table 70.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Tld name

--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

Expand
Table 70.2. Output Formatters
ValueSummary

-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

Expand
Table 70.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 70.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 70.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

70.2. tld delete

Usage:

openstack tld delete [-h] [--all-projects] [--edit-managed]

                          [--sudo-project-id SUDO_PROJECT_ID]
                          id

Delete tld

Expand
Table 70.6. Positional Arguments
ValueSummary

id

Tld id

Expand
Table 70.7. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

70.3. tld list

Usage:

openstack tld list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                        [--max-width <integer>] [--fit-width]
                        [--print-empty] [--noindent]
                        [--quote {all,minimal,none,nonnumeric}]
                        [--sort-column SORT_COLUMN] [--name NAME]
                        [--description DESCRIPTION] [--all-projects]
                        [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID]

List tlds

Expand
Table 70.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Tld name

--description DESCRIPTION

TLD 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

Expand
Table 70.9. Output Formatters
ValueSummary

-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

Expand
Table 70.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 70.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 70.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

70.4. tld show

Usage:

openstack tld show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                        [--max-width <integer>] [--fit-width]
                        [--print-empty] [--noindent] [--prefix PREFIX]
                        [--all-projects] [--edit-managed]
                        [--sudo-project-id SUDO_PROJECT_ID]
                        id

Show tld details

Expand
Table 70.13. Positional Arguments
ValueSummary

id

Tld id

Expand
Table 70.14. Optional Arguments
ValueSummary

-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

Expand
Table 70.15. Output Formatters
ValueSummary

-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

Expand
Table 70.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 70.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 70.18. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

Chapter 71. token

This chapter describes the commands under the token command.

71.1. token issue

Usage:

openstack token issue [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]

Issue new token

Expand
Table 71.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 71.2. Output Formatters
ValueSummary

-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

Expand
Table 71.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 71.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 71.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

71.2. token revoke

Usage:

openstack token revoke [-h] <token>

Revoke existing token

Expand
Table 71.6. Positional Arguments
ValueSummary

<token>

Token to be deleted

Expand
Table 71.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Chapter 72. tsigkey

This chapter describes the commands under the tsigkey command.

72.1. tsigkey create

Usage:

openstack tsigkey create [-h] [-f {json,shell,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--prefix PREFIX] --name NAME --algorithm
                              ALGORITHM --secret SECRET --scope SCOPE
                              --resource-id RESOURCE_ID [--all-projects]
                              [--edit-managed]
                              [--sudo-project-id SUDO_PROJECT_ID]

Create new tsigkey

Expand
Table 72.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Tsigkey name

--algorithm ALGORITHM

TSIGKey algorithm

--secret SECRET

Tsigkey secret

--scope SCOPE

Tsigkey scope

--resource-id RESOURCE_ID

TSIGKey resource_id

--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

Expand
Table 72.2. Output Formatters
ValueSummary

-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

Expand
Table 72.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 72.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 72.5. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

72.2. tsigkey delete

Usage:

openstack tsigkey delete [-h] [--all-projects] [--edit-managed]

                              [--sudo-project-id SUDO_PROJECT_ID]
                              id

Delete tsigkey

Expand
Table 72.6. Positional Arguments
ValueSummary

id

Tsigkey id

Expand
Table 72.7. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

72.3. tsigkey list

Usage:

openstack tsigkey list [-h] [-f {csv,json,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--quote {all,minimal,none,nonnumeric}]
                            [--sort-column SORT_COLUMN] [--name NAME]
                            [--algorithm ALGORITHM] [--scope SCOPE]
                            [--all-projects] [--edit-managed]
                            [--sudo-project-id SUDO_PROJECT_ID]

List tsigkeys

Expand
Table 72.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Tsigkey name

--algorithm ALGORITHM

TSIGKey algorithm

--scope SCOPE

Tsigkey scope

--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

Expand
Table 72.9. Output Formatters
ValueSummary

-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

Expand
Table 72.10. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 72.11. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 72.12. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

72.4. tsigkey set

Usage:

openstack tsigkey set [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--name NAME] [--algorithm ALGORITHM]
                           [--secret SECRET] [--scope SCOPE]
                           [--all-projects] [--edit-managed]
                           [--sudo-project-id SUDO_PROJECT_ID]
                           id

Set tsigkey properties

Expand
Table 72.13. Positional Arguments
ValueSummary

id

Tsigkey id

Expand
Table 72.14. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Tsigkey name

--algorithm ALGORITHM

TSIGKey algorithm

--secret SECRET

Tsigkey secret

--scope SCOPE

Tsigkey scope

--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

Expand
Table 72.15. Output Formatters
ValueSummary

-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

Expand
Table 72.16. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 72.17. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 72.18. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

72.5. tsigkey show

Usage:

openstack tsigkey show [-h] [-f {json,shell,table,value,yaml}]

                            [-c COLUMN] [--max-width <integer>]
                            [--fit-width] [--print-empty] [--noindent]
                            [--prefix PREFIX] [--all-projects]
                            [--edit-managed]
                            [--sudo-project-id SUDO_PROJECT_ID]
                            id

Show tsigkey details

Expand
Table 72.19. Positional Arguments
ValueSummary

id

Tsigkey id

Expand
Table 72.20. Optional Arguments
ValueSummary

-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

Expand
Table 72.21. Output Formatters
ValueSummary

-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

Expand
Table 72.22. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 72.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 72.24. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

Chapter 73. usage

This chapter describes the commands under the usage command.

73.1. usage list

Usage:

openstack usage list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                          [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}]
                          [--sort-column SORT_COLUMN] [--start <start>]
                          [--end <end>]

List resource usage per project

Expand
Table 73.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--start <start>

Usage range start date, ex 2012-01-20 (default: 4 weeks ago)

--end <end>

Usage range end date, ex 2012-01-20 (default: tomorrow)

Expand
Table 73.2. Output Formatters
ValueSummary

-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

Expand
Table 73.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 73.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 73.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

73.2. usage show

Usage:

openstack usage show [-h] [-f {json,shell,table,value,yaml}]

                          [-c COLUMN] [--max-width <integer>] [--fit-width]
                          [--print-empty] [--noindent] [--prefix PREFIX]
                          [--project <project>] [--start <start>]
                          [--end <end>]

Show resource usage for a single project

Expand
Table 73.6. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Name or id of project to show usage for

--start <start>

Usage range start date, ex 2012-01-20 (default: 4 weeks ago)

--end <end>

Usage range end date, ex 2012-01-20 (default: tomorrow)

Expand
Table 73.7. Output Formatters
ValueSummary

-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

Expand
Table 73.8. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 73.9. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 73.10. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 74. user

This chapter describes the commands under the user command.

74.1. user create

Usage:

openstack user create [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--project <project>] [--password <password>]
                           [--password-prompt] [--email <email-address>]
                           [--enable | --disable] [--or-show]
                           <name>

Create new user

Expand
Table 74.1. Positional Arguments
ValueSummary

<name>

New user name

Expand
Table 74.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Default project (name or id)

--password <password>

Set user password

--password-prompt

Prompt interactively for password

--email <email-address>

Set user email address

--enable

Enable user (default)

--disable

Disable user

--or-show

Return existing user

Expand
Table 74.3. Output Formatters
ValueSummary

-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

Expand
Table 74.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 74.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 74.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

74.2. user delete

Usage:

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

Delete user(s)

Expand
Table 74.7. Positional Arguments
ValueSummary

<user>

User(s) to delete (name or id)

Expand
Table 74.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

74.3. user list

Usage:

openstack user list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--sort-column SORT_COLUMN] [--project <project>]
                         [--long]

List users

Expand
Table 74.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Filter users by project (name or id)

--long

List additional fields in output

Expand
Table 74.10. Output Formatters
ValueSummary

-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

Expand
Table 74.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 74.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 74.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

74.4. user role list

Usage:

openstack user role list [-h] [-f {csv,json,table,value,yaml}]

                              [-c COLUMN] [--max-width <integer>]
                              [--fit-width] [--print-empty] [--noindent]
                              [--quote {all,minimal,none,nonnumeric}]
                              [--sort-column SORT_COLUMN]
                              [--project <project>]
                              [<user>]

List user-role assignments

Expand
Table 74.14. Positional Arguments
ValueSummary

<user>

User to list (name or id)

Expand
Table 74.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Filter users by <project> (name or id)

Expand
Table 74.16. Output Formatters
ValueSummary

-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

Expand
Table 74.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 74.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 74.19. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

74.5. user set

Usage:

openstack user set [-h] [--name <name>] [--project <project>]

                        [--password <user-password>] [--password-prompt]
                        [--email <email-address>] [--enable | --disable]
                        <user>

Set user properties

Expand
Table 74.20. Positional Arguments
ValueSummary

<user>

User to modify (name or id)

Expand
Table 74.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set user name

--project <project>

Set default project (name or id)

--password <user-password>

Set user password

--password-prompt

Prompt interactively for password

--email <email-address>

Set user email address

--enable

Enable user (default)

--disable

Disable user

74.6. user show

Usage:

openstack user show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent] [--prefix PREFIX]
                         <user>

Display user details

Expand
Table 74.22. Positional Arguments
ValueSummary

<user>

User to display (name or id)

Expand
Table 74.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 74.24. Output Formatters
ValueSummary

-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

Expand
Table 74.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 74.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 74.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Chapter 75. versions

This chapter describes the commands under the versions command.

75.1. versions show

Usage:

openstack versions show [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN]
                             [--all-interfaces | --interface <interface>]
                             [--region-name <region_name>]
                             [--service <region_name>]
                             [--status <region_name>]

Show available versions of services

Expand
Table 75.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all-interfaces

Show values for all interfaces

--interface <interface>

Show versions for a specific interface.

--region-name <region_name>

Show versions for a specific region.

--service <region_name>

Show versions for a specific service.

--status <region_name>

Show versions for a specific status. [Valid values are SUPPORTED, CURRENT, DEPRECATED, EXPERIMENTAL]

Expand
Table 75.2. Output Formatters
ValueSummary

-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

Expand
Table 75.3. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 75.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 75.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

Chapter 76. volume

This chapter describes the commands under the volume command.

76.1. volume backup create

Usage:

openstack volume backup create [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--name <name>]
                                    [--description <description>]
                                    [--container <container>]
                                    [--snapshot <snapshot>] [--force]
                                    [--incremental]
                                    <volume>

Create new volume backup

Expand
Table 76.1. Positional Arguments
ValueSummary

<volume>

Volume to backup (name or id)

Expand
Table 76.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the backup

--description <description>

Description of the backup

--container <container>

Optional backup container name

--snapshot <snapshot>

Snapshot to backup (name or ID)

--force

Allow to back up an in-use volume

--incremental

Perform an incremental backup

Expand
Table 76.3. Output Formatters
ValueSummary

-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

Expand
Table 76.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.2. volume backup delete

Usage:

openstack volume backup delete [-h] [--force] <backup> [<backup> ...]

Delete volume backup(s)

Expand
Table 76.7. Positional Arguments
ValueSummary

<backup>

Backup(s) to delete (name or id)

Expand
Table 76.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Allow delete in state other than error or available

76.3. volume backup list

Usage:

openstack volume backup list [-h] [-f {csv,json,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--sort-column SORT_COLUMN] [--long]
                                  [--name <name>] [--status <status>]
                                  [--volume <volume>]
                                  [--marker <volume-backup>]
                                  [--limit <num-backups>] [--all-projects]

List volume backups

Expand
Table 76.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--name <name>

Filters results by the backup name

--status <status>

Filters results by the backup status ('creating', 'available', 'deleting', 'error', 'restoring' or 'error_restoring')

--volume <volume>

Filters results by the volume which they backup (name or ID)

--marker <volume-backup>

The last backup of the previous page (name or ID)

--limit <num-backups>

Maximum number of backups to display

--all-projects

Include all projects (admin only)

Expand
Table 76.10. Output Formatters
ValueSummary

-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

Expand
Table 76.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.4. volume backup restore

Usage:

openstack volume backup restore [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <backup> <volume>

Restore volume backup

Expand
Table 76.14. Positional Arguments
ValueSummary

<backup>

Backup to restore (name or id)

<volume>

Volume to restore to (name or id)

Expand
Table 76.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.16. Output Formatters
ValueSummary

-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

Expand
Table 76.17. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.18. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.19. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.5. volume backup set

Usage:

openstack volume backup set [-h] [--name <name>]

                                 [--description <description>]
                                 [--state <state>]
                                 <backup>

Set volume backup properties

Expand
Table 76.20. Positional Arguments
ValueSummary

<backup>

Backup to modify (name or id)

Expand
Table 76.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New backup name

--description <description>

New backup description

--state <state>

New backup state ("available" or "error") (admin only) (This option simply changes the state of the backup in the database with no regard to actual status, exercise caution when using)

76.6. volume backup show

Usage:

openstack volume backup show [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  <backup>

Display volume backup details

Expand
Table 76.22. Positional Arguments
ValueSummary

<backup>

Backup to display (name or id)

Expand
Table 76.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.24. Output Formatters
ValueSummary

-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

Expand
Table 76.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.7. volume create

Usage:

openstack volume create [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--size <size>]
                             [--type <volume-type>]
                             [--image <image> | --snapshot <snapshot> | --source <volume>]
                             [--description <description>] [--user <user>]
                             [--project <project>]
                             [--availability-zone <availability-zone>]
                             [--consistency-group consistency-group>]
                             [--property <key=value>] [--hint <key=value>]
                             [--multi-attach] [--bootable | --non-bootable]
                             [--read-only | --read-write]
                             <name>

Create new volume

Expand
Table 76.28. Positional Arguments
ValueSummary

<name>

Volume name

Expand
Table 76.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--size <size>

Volume size in gb (required unless --snapshot or

--source is specified)

 

--type <volume-type>

Set the type of volume

--image <image>

Use <image> as source of volume (name or id)

--snapshot <snapshot>

Use <snapshot> as source of volume (name or ID)

--source <volume>

Volume to clone (name or id)

--description <description>

Volume description

--user <user>

Specify an alternate user (name or id)

--project <project>

Specify an alternate project (name or id)

--availability-zone <availability-zone>

Create volume in <availability-zone>

--consistency-group consistency-group>

Consistency group where the new volume belongs to

--property <key=value>

Set a property to this volume (repeat option to set multiple properties)

--hint <key=value>

Arbitrary scheduler hint key-value pairs to help boot an instance (repeat option to set multiple hints)

--multi-attach

Allow volume to be attached more than once (default to False)

--bootable

Mark volume as bootable

--non-bootable

Mark volume as non-bootable (default)

--read-only

Set volume to read-only access mode

--read-write

Set volume to read-write access mode (default)

Expand
Table 76.30. Output Formatters
ValueSummary

-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

Expand
Table 76.31. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.32. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.33. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.8. volume delete

Usage:

openstack volume delete [-h] [--force | --purge]

                             <volume> [<volume> ...]

Delete volume(s)

Expand
Table 76.34. Positional Arguments
ValueSummary

<volume>

Volume(s) to delete (name or id)

Expand
Table 76.35. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Attempt forced removal of volume(s), regardless of state (defaults to False)

--purge

Remove any snapshots along with volume(s) (defaults to false)

76.9. volume host failover

Usage:

openstack volume host failover [-h] --volume-backend <backend-id>

                                    <host-name>

Failover volume host to different backend

Expand
Table 76.36. Positional Arguments
ValueSummary

<host-name>

Name of volume host

Expand
Table 76.37. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--volume-backend <backend-id>

The ID of the volume backend replication target where the host will failover to (required)

76.10. volume host set

Usage:

openstack volume host set [-h] [--disable | --enable] <host-name>

Set volume host properties

Expand
Table 76.38. Positional Arguments
ValueSummary

<host-name>

Name of volume host

Expand
Table 76.39. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--disable

Freeze and disable the specified volume host

--enable

Thaw and enable the specified volume host

76.11. volume list

Usage:

openstack volume list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                           [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--sort-column SORT_COLUMN] [--project <project>]
                           [--project-domain <project-domain>]
                           [--user <user>] [--user-domain <user-domain>]
                           [--name <name>] [--status <status>]
                           [--all-projects] [--long] [--marker <volume>]
                           [--limit <num-volumes>]

List volumes

Expand
Table 76.40. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project>

Filter results by 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.

--user <user>

Filter results by user (name or id) (admin only)

--user-domain <user-domain>

Domain the user belongs to (name or ID). This can be used in case collisions between user names exist.

--name <name>

Filter results by volume name

--status <status>

Filter results by status

--all-projects

Include all projects (admin only)

--long

List additional fields in output

--marker <volume>

The last volume id of the previous page

--limit <num-volumes>

Maximum number of volumes to display

Expand
Table 76.41. Output Formatters
ValueSummary

-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

Expand
Table 76.42. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.43. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.44. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.12. volume migrate

Usage:

openstack volume migrate [-h] --host <host> [--force-host-copy]

                              [--lock-volume | --unlock-volume]
                              <volume>

Migrate volume to a new host

Expand
Table 76.45. Positional Arguments
ValueSummary

<volume>

Volume to migrate (name or id)

Expand
Table 76.46. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--host <host>

Destination host (takes the form: host@backend-name#pool)

--force-host-copy

Enable generic host-based force-migration, which bypasses driver optimizations

--lock-volume

If specified, the volume state will be locked and will not allow a migration to be aborted (possibly by another operation)

--unlock-volume

If specified, the volume state will not be locked and the a migration can be aborted (default) (possibly by another operation)

76.13. volume qos associate

Usage:

openstack volume qos associate [-h] <qos-spec> <volume-type>

Associate a QoS specification to a volume type

Expand
Table 76.47. Positional Arguments
ValueSummary

<qos-spec>

Qos specification to modify (name or id)

<volume-type>

Volume type to associate the qos (name or id)

Expand
Table 76.48. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

76.14. volume qos create

Usage:

openstack volume qos create [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX] [--consumer <consumer>]
                                 [--property <key=value>]
                                 <name>

Create new QoS specification

Expand
Table 76.49. Positional Arguments
ValueSummary

<name>

New qos specification name

Expand
Table 76.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--consumer <consumer>

Consumer of the QoS. Valid consumers: back-end, both, front-end (defaults to 'both')

--property <key=value>

Set a QoS specification property (repeat option to set multiple properties)

Expand
Table 76.51. Output Formatters
ValueSummary

-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

Expand
Table 76.52. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.53. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.54. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.15. volume qos delete

Usage:

openstack volume qos delete [-h] [--force] <qos-spec> [<qos-spec> ...]

Delete QoS specification

Expand
Table 76.55. Positional Arguments
ValueSummary

<qos-spec>

Qos specification(s) to delete (name or id)

Expand
Table 76.56. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Allow to delete in-use qos specification(s)

76.16. volume qos disassociate

Usage:

openstack volume qos disassociate [-h]

                                       [--volume-type <volume-type> | --all]
                                       <qos-spec>

Disassociate a QoS specification from a volume type

Expand
Table 76.57. Positional Arguments
ValueSummary

<qos-spec>

Qos specification to modify (name or id)

Expand
Table 76.58. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--volume-type <volume-type>

Volume type to disassociate the QoS from (name or ID)

--all

Disassociate the qos from every volume type

76.17. volume qos list

Usage:

openstack volume qos list [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN]

List QoS specifications

Expand
Table 76.59. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.60. Output Formatters
ValueSummary

-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

Expand
Table 76.61. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.62. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.63. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.18. volume qos set

Usage:

openstack volume qos set [-h] [--property <key=value>] <qos-spec>

Set QoS specification properties

Expand
Table 76.64. Positional Arguments
ValueSummary

<qos-spec>

Qos specification to modify (name or id)

Expand
Table 76.65. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key=value>

Property to add or modify for this QoS specification (repeat option to set multiple properties)

76.19. volume qos show

Usage:

openstack volume qos show [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX]
                               <qos-spec>

Display QoS specification details

Expand
Table 76.66. Positional Arguments
ValueSummary

<qos-spec>

Qos specification to display (name or id)

Expand
Table 76.67. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.68. Output Formatters
ValueSummary

-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

Expand
Table 76.69. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.70. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.71. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.20. volume qos unset

Usage:

openstack volume qos unset [-h] [--property <key>] <qos-spec>

Unset QoS specification properties

Expand
Table 76.72. Positional Arguments
ValueSummary

<qos-spec>

Qos specification to modify (name or id)

Expand
Table 76.73. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from the qos specification. (repeat option to unset multiple properties)

76.21. volume service list

Usage:

openstack volume service list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--host <host>] [--service <service>]
                                   [--long]

List service command

Expand
Table 76.74. Optional Arguments
ValueSummary

-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

Expand
Table 76.75. Output Formatters
ValueSummary

-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

Expand
Table 76.76. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.77. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.78. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.22. volume service set

Usage:

openstack volume service set [-h] [--enable | --disable]

                                  [--disable-reason <reason>]
                                  <host> <service>

Set volume service properties

Expand
Table 76.79. Positional Arguments
ValueSummary

<host>

Name of host

<service>

Name of service (binary name)

Expand
Table 76.80. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--enable

Enable volume service

--disable

Disable volume service

--disable-reason <reason>

Reason for disabling the service (should be used with

--disable option)

 

76.23. volume set

Usage:

openstack volume set [-h] [--name <name>] [--size <size>]

                          [--description <description>] [--no-property]
                          [--property <key=value>]
                          [--image-property <key=value>] [--state <state>]
                          [--type <volume-type>]
                          [--retype-policy <retype-policy>]
                          [--bootable | --non-bootable]
                          [--read-only | --read-write]
                          <volume>

Set volume properties

Expand
Table 76.81. Positional Arguments
ValueSummary

<volume>

Volume to modify (name or id)

Expand
Table 76.82. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New volume name

--size <size>

Extend volume size in gb

--description <description>

New volume description

--no-property

Remove all properties from <volume> (specify both

--no-property and --property to remove the current

properties before setting new properties.)

--property <key=value>

Set a property on this volume (repeat option to set multiple properties)

--image-property <key=value>

Set an image property on this volume (repeat option to set multiple image properties)

--state <state>

New volume state ("available", "error", "creating", "deleting", "in-use", "attaching", "detaching", "error_deleting" or "maintenance") (admin only) (This option simply changes the state of the volume in the database with no regard to actual status, exercise caution when using)

--type <volume-type>

New volume type (name or id)

--retype-policy <retype-policy>

Migration policy while re-typing volume ("never" or "on-demand", default is "never" ) (available only when

--type option is specified)

 

--bootable

Mark volume as bootable

--non-bootable

Mark volume as non-bootable

--read-only

Set volume to read-only access mode

--read-write

Set volume to read-write access mode

76.24. volume show

Usage:

openstack volume show [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           <volume>

Display volume details

Expand
Table 76.83. Positional Arguments
ValueSummary

<volume>

Volume to display (name or id)

Expand
Table 76.84. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.85. Output Formatters
ValueSummary

-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

Expand
Table 76.86. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.87. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.88. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.25. volume snapshot create

Usage:

openstack volume snapshot create [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--volume <volume>]
                                      [--description <description>]
                                      [--force] [--property <key=value>]
                                      [--remote-source <key=value>]
                                      <snapshot-name>

Create new volume snapshot

Expand
Table 76.89. Positional Arguments
ValueSummary

<snapshot-name>

Name of the new snapshot

Expand
Table 76.90. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--volume <volume>

Volume to snapshot (name or id) (default is <snapshot- name>)

--description <description>

Description of the snapshot

--force

Create a snapshot attached to an instance. default is False

--property <key=value>

Set a property to this snapshot (repeat option to set multiple properties)

--remote-source <key=value>

The attribute(s) of the exsiting remote volume snapshot (admin required) (repeat option to specify multiple attributes) e.g.: '--remote-source source- name=test_name --remote-source source-id=test_id'

Expand
Table 76.91. Output Formatters
ValueSummary

-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

Expand
Table 76.92. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.93. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.94. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.26. volume snapshot delete

Usage:

openstack volume snapshot delete [-h] [--force]

                                      <snapshot> [<snapshot> ...]

Delete volume snapshot(s)

Expand
Table 76.95. Positional Arguments
ValueSummary

<snapshot>

Snapshot(s) to delete (name or id)

Expand
Table 76.96. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Attempt forced removal of snapshot(s), regardless of state (defaults to False)

76.27. volume snapshot list

Usage:

openstack volume snapshot list [-h] [-f {csv,json,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent]
                                    [--quote {all,minimal,none,nonnumeric}]
                                    [--sort-column SORT_COLUMN]
                                    [--all-projects] [--project <project>]
                                    [--project-domain <project-domain>]
                                    [--long] [--marker <volume-snapshot>]
                                    [--limit <num-snapshots>]
                                    [--name <name>] [--status <status>]
                                    [--volume <volume>]

List volume snapshots

Expand
Table 76.97. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all-projects

Include all projects (admin only)

--project <project>

Filter results by 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.

--long

List additional fields in output

--marker <volume-snapshot>

The last snapshot ID of the previous page

--limit <num-snapshots>

Maximum number of snapshots to display

--name <name>

Filters results by a name.

--status <status>

Filters results by a status. ('available', 'error', 'creating', 'deleting' or 'error-deleting')

--volume <volume>

Filters results by a volume (name or id).

Expand
Table 76.98. Output Formatters
ValueSummary

-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

Expand
Table 76.99. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.100. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.101. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.28. volume snapshot set

Usage:

openstack volume snapshot set [-h] [--name <name>]

                                   [--description <description>]
                                   [--no-property] [--property <key=value>]
                                   [--state <state>]
                                   <snapshot>

Set volume snapshot properties

Expand
Table 76.102. Positional Arguments
ValueSummary

<snapshot>

Snapshot to modify (name or id)

Expand
Table 76.103. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New snapshot name

--description <description>

New snapshot description

--no-property

Remove all properties from <snapshot> (specify both

--no-property and --property to remove the current

properties before setting new properties.)

--property <key=value>

Property to add/change for this snapshot (repeat option to set multiple properties)

--state <state>

New snapshot state. ("available", "error", "creating", "deleting", or "error_deleting") (admin only) (This option simply changes the state of the snapshot in the database with no regard to actual status, exercise caution when using)

76.29. volume snapshot show

Usage:

openstack volume snapshot show [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    <snapshot>

Display volume snapshot details

Expand
Table 76.104. Positional Arguments
ValueSummary

<snapshot>

Snapshot to display (name or id)

Expand
Table 76.105. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.106. Output Formatters
ValueSummary

-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

Expand
Table 76.107. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.108. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.109. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.30. volume snapshot unset

Usage:

openstack volume snapshot unset [-h] [--property <key>] <snapshot>

Unset volume snapshot properties

Expand
Table 76.110. Positional Arguments
ValueSummary

<snapshot>

Snapshot to modify (name or id)

Expand
Table 76.111. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Property to remove from snapshot (repeat option to remove multiple properties)

76.31. volume transfer request accept

Usage:

openstack volume transfer request accept [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              [--auth-key <key>]
                                              <transfer-request-id>

Accept volume transfer request.

Expand
Table 76.112. Positional Arguments
ValueSummary

<transfer-request-id>

Volume transfer request to accept (ID only)

Expand
Table 76.113. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--auth-key <key>

Volume transfer request authentication key

Expand
Table 76.114. Output Formatters
ValueSummary

-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

Expand
Table 76.115. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.116. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.117. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.32. volume transfer request create

Usage:

openstack volume transfer request create [-h]

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

Create volume transfer request.

Expand
Table 76.118. Positional Arguments
ValueSummary

<volume>

Volume to transfer (name or id)

Expand
Table 76.119. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New transfer request name (default to none)

Expand
Table 76.120. Output Formatters
ValueSummary

-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

Expand
Table 76.121. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.122. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.123. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.33. volume transfer request delete

Usage:

openstack volume transfer request delete [-h]

                                              <transfer-request>
                                              [<transfer-request> ...]

Delete volume transfer request(s).

Expand
Table 76.124. Positional Arguments
ValueSummary

<transfer-request>

Volume transfer request(s) to delete (name or id)

Expand
Table 76.125. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

76.34. volume transfer request list

Usage:

openstack volume transfer request list [-h]

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

Lists all volume transfer requests.

Expand
Table 76.126. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--all-projects

Include all projects (admin only)

Expand
Table 76.127. Output Formatters
ValueSummary

-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

Expand
Table 76.128. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.129. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.130. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.35. volume transfer request show

Usage:

openstack volume transfer request show [-h]

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

Show volume transfer request details.

Expand
Table 76.131. Positional Arguments
ValueSummary

<transfer-request>

Volume transfer request to display (name or id)

Expand
Table 76.132. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 76.133. Output Formatters
ValueSummary

-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

Expand
Table 76.134. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.135. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.136. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.36. volume type create

Usage:

openstack volume type create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  [--description <description>]
                                  [--public | --private]
                                  [--property <key=value>]
                                  [--project <project>]
                                  [--encryption-provider <provider>]
                                  [--encryption-cipher <cipher>]
                                  [--encryption-key-size <key-size>]
                                  [--encryption-control-location <control-location>]
                                  [--project-domain <project-domain>]
                                  <name>

Create new volume type

Expand
Table 76.137. Positional Arguments
ValueSummary

<name>

Volume type name

Expand
Table 76.138. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Volume type description

--public

Volume type is accessible to the public

--private

Volume type is not accessible to the public

--property <key=value>

Set a property on this volume type (repeat option to set multiple properties)

--project <project>

Allow <project> to access private type (name or id) (Must be used with --private option)

--encryption-provider <provider>

Set the encryption provider format for this volume type (e.g "luks" or "plain") (admin only) (This option is required when setting encryption type of a volume. Consider using other encryption options such as: "--encryption-cipher", "--encryption-key-size" and "--encryption-control-location")

--encryption-cipher <cipher>

Set the encryption algorithm or mode for this volume type (e.g "aes-xts-plain64") (admin only)

--encryption-key-size <key-size>

Set the size of the encryption key of this volume type (e.g "128" or "256") (admin only)

--encryption-control-location <control-location>

Set the notional service where the encryption is performed ("front-end" or "back-end") (admin only) (The default value for this option is "front-end" when setting encryption type of a volume. Consider using other encryption options such as: "--encryption- cipher", "--encryption-key-size" and "--encryption- provider")

--project-domain <project-domain>

Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.

Expand
Table 76.139. Output Formatters
ValueSummary

-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

Expand
Table 76.140. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.141. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.142. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.37. volume type delete

Usage:

openstack volume type delete [-h] <volume-type> [<volume-type> ...]

Delete volume type(s)

Expand
Table 76.143. Positional Arguments
ValueSummary

<volume-type>

Volume type(s) to delete (name or id)

Expand
Table 76.144. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

76.38. volume type list

Usage:

openstack volume type list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN] [--long]
                                [--default | --public | --private]
                                [--encryption-type]

List volume types

Expand
Table 76.145. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

--default

List the default volume type

--public

List only public types

--private

List only private types (admin only)

--encryption-type

Display encryption information for each volume type (admin only)

Expand
Table 76.146. Output Formatters
ValueSummary

-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

Expand
Table 76.147. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.148. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.149. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

76.39. volume type set

Usage:

openstack volume type set [-h] [--name <name>]

                               [--description <description>]
                               [--property <key=value>]
                               [--project <project>]
                               [--project-domain <project-domain>]
                               [--encryption-provider <provider>]
                               [--encryption-cipher <cipher>]
                               [--encryption-key-size <key-size>]
                               [--encryption-control-location <control-location>]
                               <volume-type>

Set volume type properties

Expand
Table 76.150. Positional Arguments
ValueSummary

<volume-type>

Volume type to modify (name or id)

Expand
Table 76.151. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set volume type name

--description <description>

Set volume type description

--property <key=value>

Set a property on this volume type (repeat option to set multiple properties)

--project <project>

Set volume type access to 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.

--encryption-provider <provider>

Set the encryption provider format for this volume type (e.g "luks" or "plain") (admin only) (This option is required when setting encryption type of a volume for the first time. Consider using other encryption options such as: "--encryption-cipher", "--encryption- key-size" and "--encryption-control-location")

--encryption-cipher <cipher>

Set the encryption algorithm or mode for this volume type (e.g "aes-xts-plain64") (admin only)

--encryption-key-size <key-size>

Set the size of the encryption key of this volume type (e.g "128" or "256") (admin only)

--encryption-control-location <control-location>

Set the notional service where the encryption is performed ("front-end" or "back-end") (admin only) (The default value for this option is "front-end" when setting encryption type of a volume for the first time. Consider using other encryption options such as: "--encryption-cipher", "--encryption-key-size" and "--encryption-provider")

76.40. volume type show

Usage:

openstack volume type show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX] [--encryption-type]
                                <volume-type>

Display volume type details

Expand
Table 76.152. Positional Arguments
ValueSummary

<volume-type>

Volume type to display (name or id)

Expand
Table 76.153. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--encryption-type

Display encryption information of this volume type (admin only)

Expand
Table 76.154. Output Formatters
ValueSummary

-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

Expand
Table 76.155. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 76.156. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 76.157. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

76.41. volume type unset

Usage:

openstack volume type unset [-h] [--property <key>]

                                 [--project <project>]
                                 [--project-domain <project-domain>]
                                 [--encryption-type]
                                 <volume-type>

Unset volume type properties

Expand
Table 76.158. Positional Arguments
ValueSummary

<volume-type>

Volume type to modify (name or id)

Expand
Table 76.159. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Remove a property from this volume type (repeat option to remove multiple properties)

--project <project>

Removes volume type access to 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.

--encryption-type

Remove the encryption type for this volume type (admin only)

76.42. volume unset

Usage:

openstack volume unset [-h] [--property <key>] [--image-property <key>]

                            <volume>

Unset volume properties

Expand
Table 76.160. Positional Arguments
ValueSummary

<volume>

Volume to modify (name or id)

Expand
Table 76.161. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--property <key>

Remove a property from volume (repeat option to remove multiple properties)

--image-property <key>

Remove an image property from volume (repeat option to remove multiple image properties)

Chapter 77. vpn

This chapter describes the commands under the vpn command.

77.1. vpn endpoint group create

Usage:

openstack vpn endpoint group create [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--description <description>]
                                         --type TYPE --value ENDPOINTS
                                         [--project <project>]
                                         [--project-domain <project-domain>]
                                         <name>

Create an endpoint group

Expand
Table 77.1. Positional Arguments
ValueSummary

<name>

Name for the endpoint group

Expand
Table 77.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the endpoint group

--type TYPE

Type of endpoints in group (e.g. subnet, cidr)

--value ENDPOINTS

Endpoint(s) for the group. must all be of the same type. (--value) option can be repeated

--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.

Expand
Table 77.3. Output Formatters
ValueSummary

-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

Expand
Table 77.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.2. vpn endpoint group delete

Usage:

openstack vpn endpoint group delete [-h]

                                         <endpoint-group>
                                         [<endpoint-group> ...]

Delete endpoint group(s)

Expand
Table 77.7. Positional Arguments
ValueSummary

<endpoint-group>

Endpoint group(s) to delete (name or id)

Expand
Table 77.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

77.3. vpn endpoint group list

Usage:

openstack vpn endpoint group list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN] [--long]

List endpoint groups that belong to a given project

Expand
Table 77.9. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 77.10. Output Formatters
ValueSummary

-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

Expand
Table 77.11. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.12. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.13. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

77.4. vpn endpoint group set

Usage:

openstack vpn endpoint group set [-h] [--description <description>]

                                      [--name <name>]
                                      <endpoint-group>

Set endpoint group properties

Expand
Table 77.14. Positional Arguments
ValueSummary

<endpoint-group>

Endpoint group to set (name or id)

Expand
Table 77.15. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the endpoint group

--name <name>

Set a name for the endpoint group

This command is provided by the python-neutronclient plugin.

77.5. vpn endpoint group show

Usage:

openstack vpn endpoint group show [-h]

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

Display endpoint group details

Expand
Table 77.16. Positional Arguments
ValueSummary

<endpoint-group>

Endpoint group to display (name or id)

Expand
Table 77.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 77.18. Output Formatters
ValueSummary

-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

Expand
Table 77.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.6. vpn ike policy create

Usage:

openstack vpn ike policy create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     [--description <description>]
                                     [--auth-algorithm {sha1,sha256,sha384,sha512}]
                                     [--encryption-algorithm {aes-128,3des,aes-192,aes-256}]
                                     [--phase1-negotiation-mode {main}]
                                     [--ike-version {v1,v2}]
                                     [--pfs {group5,group2,group14}]
                                     [--lifetime units=UNITS,value=VALUE]
                                     [--project <project>]
                                     [--project-domain <project-domain>]
                                     <name>

Create an IKE policy

Expand
Table 77.22. Positional Arguments
ValueSummary

<name>

Name of the ike policy

Expand
Table 77.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the IKE policy

--auth-algorithm {sha1,sha256,sha384,sha512}

Authentication algorithm

--encryption-algorithm {aes-128,3des,aes-192,aes-256}

Encryption algorithm

--phase1-negotiation-mode {main}

IKE Phase1 negotiation mode

--ike-version {v1,v2}

IKE version for the policy

--pfs {group5,group2,group14}

Perfect Forward Secrecy

--lifetime units=UNITS,value=VALUE

IKE lifetime attributes. 'units'-seconds, default:seconds. 'value'-non negative integer, default:3600.

--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.

Expand
Table 77.24. Output Formatters
ValueSummary

-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

Expand
Table 77.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.7. vpn ike policy delete

Usage:

openstack vpn ike policy delete [-h] <ike-policy> [<ike-policy> ...]

Delete IKE policy (policies)

Expand
Table 77.28. Positional Arguments
ValueSummary

<ike-policy>

Ike policy to delete (name or id)

Expand
Table 77.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

77.8. vpn ike policy list

Usage:

openstack vpn ike policy list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN] [--long]

List IKE policies that belong to a given project

Expand
Table 77.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 77.31. Output Formatters
ValueSummary

-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

Expand
Table 77.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.34. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

77.9. vpn ike policy set

Usage:

openstack vpn ike policy set [-h] [--description <description>]

                                  [--auth-algorithm {sha1,sha256,sha384,sha512}]
                                  [--encryption-algorithm {aes-128,3des,aes-192,aes-256}]
                                  [--phase1-negotiation-mode {main}]
                                  [--ike-version {v1,v2}]
                                  [--pfs {group5,group2,group14}]
                                  [--lifetime units=UNITS,value=VALUE]
                                  [--name <name>]
                                  <ike-policy>

Set IKE policy properties

Expand
Table 77.35. Positional Arguments
ValueSummary

<ike-policy>

Ike policy to set (name or id)

Expand
Table 77.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the IKE policy

--auth-algorithm {sha1,sha256,sha384,sha512}

Authentication algorithm

--encryption-algorithm {aes-128,3des,aes-192,aes-256}

Encryption algorithm

--phase1-negotiation-mode {main}

IKE Phase1 negotiation mode

--ike-version {v1,v2}

IKE version for the policy

--pfs {group5,group2,group14}

Perfect Forward Secrecy

--lifetime units=UNITS,value=VALUE

IKE lifetime attributes. 'units'-seconds, default:seconds. 'value'-non negative integer, default:3600.

--name <name>

Name of the ike policy

This command is provided by the python-neutronclient plugin.

77.10. vpn ike policy show

Usage:

openstack vpn ike policy show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   <ike-policy>

Display IKE policy details

Expand
Table 77.37. Positional Arguments
ValueSummary

<ike-policy>

Ike policy to display (name or id)

Expand
Table 77.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 77.39. Output Formatters
ValueSummary

-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

Expand
Table 77.40. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.11. vpn ipsec policy create

Usage:

openstack vpn ipsec policy create [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       [--description <description>]
                                       [--auth-algorithm {sha1,sha256,sha384,sha512}]
                                       [--encapsulation-mode {tunnel,transport}]
                                       [--encryption-algorithm {3des,aes-128,aes-192,aes-256}]
                                       [--lifetime units=UNITS,value=VALUE]
                                       [--pfs {group2,group5,group14}]
                                       [--transform-protocol {esp,ah,ah-esp}]
                                       [--project <project>]
                                       [--project-domain <project-domain>]
                                       <name>

Create an IPsec policy

Expand
Table 77.43. Positional Arguments
ValueSummary

<name>

Name of the ipsec policy

Expand
Table 77.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the IPsec policy

--auth-algorithm {sha1,sha256,sha384,sha512}

Authentication algorithm for IPsec policy

--encapsulation-mode {tunnel,transport}

Encapsulation mode for IPsec policy

--encryption-algorithm {3des,aes-128,aes-192,aes-256}

Encryption algorithm for IPsec policy

--lifetime units=UNITS,value=VALUE

IPsec lifetime attributes. 'units'-seconds, default:seconds. 'value'-non negative integer, default:3600.

--pfs {group2,group5,group14}

Perfect Forward Secrecy for IPsec policy

--transform-protocol {esp,ah,ah-esp}

Transform protocol for IPsec policy

--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.

Expand
Table 77.45. Output Formatters
ValueSummary

-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

Expand
Table 77.46. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.48. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.12. vpn ipsec policy delete

Usage:

openstack vpn ipsec policy delete [-h]

                                       <ipsec-policy> [<ipsec-policy> ...]

Delete IPsec policy(policies)

Expand
Table 77.49. Positional Arguments
ValueSummary

<ipsec-policy>

Ipsec policy to delete (name or id)

Expand
Table 77.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

77.13. vpn ipsec policy list

Usage:

openstack vpn ipsec policy list [-h] [-f {csv,json,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent]
                                     [--quote {all,minimal,none,nonnumeric}]
                                     [--sort-column SORT_COLUMN] [--long]

List IPsec policies that belong to a given project

Expand
Table 77.51. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 77.52. Output Formatters
ValueSummary

-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

Expand
Table 77.53. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.54. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.55. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

77.14. vpn ipsec policy set

Usage:

openstack vpn ipsec policy set [-h] [--description <description>]

                                    [--auth-algorithm {sha1,sha256,sha384,sha512}]
                                    [--encapsulation-mode {tunnel,transport}]
                                    [--encryption-algorithm {3des,aes-128,aes-192,aes-256}]
                                    [--lifetime units=UNITS,value=VALUE]
                                    [--pfs {group2,group5,group14}]
                                    [--transform-protocol {esp,ah,ah-esp}]
                                    [--name <name>]
                                    <ipsec-policy>

Set IPsec policy properties

Expand
Table 77.56. Positional Arguments
ValueSummary

<ipsec-policy>

Ipsec policy to set (name or id)

Expand
Table 77.57. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description of the IPsec policy

--auth-algorithm {sha1,sha256,sha384,sha512}

Authentication algorithm for IPsec policy

--encapsulation-mode {tunnel,transport}

Encapsulation mode for IPsec policy

--encryption-algorithm {3des,aes-128,aes-192,aes-256}

Encryption algorithm for IPsec policy

--lifetime units=UNITS,value=VALUE

IPsec lifetime attributes. 'units'-seconds, default:seconds. 'value'-non negative integer, default:3600.

--pfs {group2,group5,group14}

Perfect Forward Secrecy for IPsec policy

--transform-protocol {esp,ah,ah-esp}

Transform protocol for IPsec policy

--name <name>

Name of the ipsec policy

This command is provided by the python-neutronclient plugin.

77.15. vpn ipsec policy show

Usage:

openstack vpn ipsec policy show [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     <ipsec-policy>

Display IPsec policy details

Expand
Table 77.58. Positional Arguments
ValueSummary

<ipsec-policy>

Ipsec policy to display (name or id)

Expand
Table 77.59. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 77.60. Output Formatters
ValueSummary

-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

Expand
Table 77.61. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.62. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.63. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.16. vpn ipsec site connection create

Usage:

openstack vpn ipsec site connection create [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                [--description <description>]
                                                [--dpd action=ACTION,interval=INTERVAL,timeout=TIMEOUT]
                                                [--mtu MTU]
                                                [--initiator {bi-directional,response-only}]
                                                [--peer-cidr PEER_CIDRS | --local-endpoint-group LOCAL_ENDPOINT_GROUP]
                                                [--peer-endpoint-group PEER_ENDPOINT_GROUP]
                                                [--enable | --disable]
                                                [--local-id LOCAL_ID]
                                                --peer-id PEER_ID
                                                --peer-address PEER_ADDRESS
                                                --psk PSK --vpnservice
                                                VPNSERVICE --ikepolicy
                                                IKEPOLICY --ipsecpolicy
                                                IPSECPOLICY
                                                [--project <project>]
                                                [--project-domain <project-domain>]
                                                <name>

Create an IPsec site connection

Expand
Table 77.64. Positional Arguments
ValueSummary

<name>

Set friendly name for the connection

Expand
Table 77.65. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the connection

--dpd action=ACTION,interval=INTERVAL,timeout=TIMEOUT

Ipsec connection Dead Peer Detection attributes. 'action'-hold,clear,disabled,restart,restart-by-peer. 'interval' and 'timeout' are non negative integers. 'interval' should be less than 'timeout' value. 'action', default:hold 'interval', default:30, 'timeout', default:120.

--mtu MTU

Mtu size for the connection

--initiator {bi-directional,response-only}

Initiator state

--peer-cidr PEER_CIDRS

Remote subnet(s) in CIDR format. Cannot be specified when using endpoint groups. Only applicable, if subnet provided for VPN service.

--local-endpoint-group LOCAL_ENDPOINT_GROUP

Local endpoint group (name or ID) with subnet(s) for IPsec connection

--peer-endpoint-group PEER_ENDPOINT_GROUP

Peer endpoint group (name or ID) with CIDR(s) for IPSec connection

--enable

Enable ipsec site connection

--disable

Disable ipsec site connection

--local-id LOCAL_ID

An id to be used instead of the external ip address for a virtual router

--peer-id PEER_ID

Peer router identity for authentication. can be IPv4/IPv6 address, e-mail address, key id, or FQDN

--peer-address PEER_ADDRESS

Peer gateway public IPv4/IPv6 address or FQDN

--psk PSK

Pre-shared key string.

--vpnservice VPNSERVICE

VPN service instance associated with this connection (name or ID)

--ikepolicy IKEPOLICY

IKE policy associated with this connection (name or ID)

--ipsecpolicy IPSECPOLICY

IPsec policy associated with this connection (name or ID)

--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.

Expand
Table 77.66. Output Formatters
ValueSummary

-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

Expand
Table 77.67. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.68. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.69. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.17. vpn ipsec site connection delete

Usage:

openstack vpn ipsec site connection delete [-h]

                                                <ipsec-site-connection>
                                                [<ipsec-site-connection> ...]

Delete IPsec site connection(s)

Expand
Table 77.70. Positional Arguments
ValueSummary

<ipsec-site-connection>

IPsec site connection to delete (name or ID)

Expand
Table 77.71. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

77.18. vpn ipsec site connection list

Usage:

openstack vpn ipsec site connection list [-h]

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

List IPsec site connections that belong to a given project

Expand
Table 77.72. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 77.73. Output Formatters
ValueSummary

-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

Expand
Table 77.74. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.75. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.76. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

77.19. vpn ipsec site connection set

Usage:

openstack vpn ipsec site connection set [-h]

                                             [--description <description>]
                                             [--dpd action=ACTION,interval=INTERVAL,timeout=TIMEOUT]
                                             [--mtu MTU]
                                             [--initiator {bi-directional,response-only}]
                                             [--peer-cidr PEER_CIDRS | --local-endpoint-group LOCAL_ENDPOINT_GROUP]
                                             [--peer-endpoint-group PEER_ENDPOINT_GROUP]
                                             [--enable | --disable]
                                             [--local-id LOCAL_ID]
                                             [--peer-id PEER_ID]
                                             [--peer-address PEER_ADDRESS]
                                             [--name <name>]
                                             <ipsec-site-connection>

Set IPsec site connection properties

Expand
Table 77.77. Positional Arguments
ValueSummary

<ipsec-site-connection>

IPsec site connection to set (name or ID)

Expand
Table 77.78. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the connection

--dpd action=ACTION,interval=INTERVAL,timeout=TIMEOUT

Ipsec connection Dead Peer Detection attributes. 'action'-hold,clear,disabled,restart,restart-by-peer. 'interval' and 'timeout' are non negative integers. 'interval' should be less than 'timeout' value. 'action', default:hold 'interval', default:30, 'timeout', default:120.

--mtu MTU

Mtu size for the connection

--initiator {bi-directional,response-only}

Initiator state

--peer-cidr PEER_CIDRS

Remote subnet(s) in CIDR format. Cannot be specified when using endpoint groups. Only applicable, if subnet provided for VPN service.

--local-endpoint-group LOCAL_ENDPOINT_GROUP

Local endpoint group (name or ID) with subnet(s) for IPsec connection

--peer-endpoint-group PEER_ENDPOINT_GROUP

Peer endpoint group (name or ID) with CIDR(s) for IPSec connection

--enable

Enable ipsec site connection

--disable

Disable ipsec site connection

--local-id LOCAL_ID

An id to be used instead of the external ip address for a virtual router

--peer-id PEER_ID

Peer router identity for authentication. can be IPv4/IPv6 address, e-mail address, key id, or FQDN

--peer-address PEER_ADDRESS

Peer gateway public IPv4/IPv6 address or FQDN

--name <name>

Set friendly name for the connection

This command is provided by the python-neutronclient plugin.

77.20. vpn ipsec site connection show

Usage:

openstack vpn ipsec site connection show [-h]

                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--noindent] [--prefix PREFIX]
                                              <ipsec-site-connection>

Show information of a given IPsec site connection

Expand
Table 77.79. Positional Arguments
ValueSummary

<ipsec-site-connection>

IPsec site connection to display (name or ID)

Expand
Table 77.80. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 77.81. Output Formatters
ValueSummary

-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

Expand
Table 77.82. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.83. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.84. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.21. vpn service create

Usage:

openstack vpn service create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX]
                                  [--description <description>]
                                  [--subnet <subnet>] [--flavor <flavor>]
                                  [--enable | --disable] --router ROUTER
                                  [--project <project>]
                                  [--project-domain <project-domain>]
                                  <name>

Create an VPN service

Expand
Table 77.85. Positional Arguments
ValueSummary

<name>

Name for the vpn service

Expand
Table 77.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the VPN service

--subnet <subnet>

Local private subnet (name or id)

--flavor <flavor>

Flavor for the vpn service (name or id)

--enable

Enable vpn service

--disable

Disable vpn service

--router ROUTER

Router for the vpn service (name or id)

--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.

Expand
Table 77.87. Output Formatters
ValueSummary

-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

Expand
Table 77.88. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.89. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.90. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

77.22. vpn service delete

Usage:

openstack vpn service delete [-h] <vpn-service> [<vpn-service> ...]

Delete VPN service(s)

Expand
Table 77.91. Positional Arguments
ValueSummary

<vpn-service>

Vpn service to delete (name or id)

Expand
Table 77.92. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-neutronclient plugin.

77.23. vpn service list

Usage:

openstack vpn service list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN] [--long]

List VPN services that belong to a given project

Expand
Table 77.93. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--long

List additional fields in output

Expand
Table 77.94. Output Formatters
ValueSummary

-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

Expand
Table 77.95. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.96. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.97. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-neutronclient plugin.

77.24. vpn service set

Usage:

openstack vpn service set [-h] [--description <description>]

                               [--subnet <subnet>] [--flavor <flavor>]
                               [--enable | --disable] [--name <name>]
                               <vpn-service>

Set VPN service properties

Expand
Table 77.98. Positional Arguments
ValueSummary

<vpn-service>

Vpn service to modify (name or id)

Expand
Table 77.99. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Description for the VPN service

--subnet <subnet>

Local private subnet (name or id)

--flavor <flavor>

Flavor for the vpn service (name or id)

--enable

Enable vpn service

--disable

Disable vpn service

--name <name>

Name for the vpn service

This command is provided by the python-neutronclient plugin.

77.25. vpn service show

Usage:

openstack vpn service show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX]
                                <vpn-service>

Display VPN service details

Expand
Table 77.100. Positional Arguments
ValueSummary

<vpn-service>

Vpn service to display (name or id)

Expand
Table 77.101. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 77.102. Output Formatters
ValueSummary

-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

Expand
Table 77.103. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 77.104. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 77.105. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-neutronclient plugin.

Chapter 78. workbook

This chapter describes the commands under the workbook command.

78.1. workbook create

Usage:

openstack workbook create [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] [--public]
                               definition

Create new workbook.

Expand
Table 78.1. Positional Arguments
ValueSummary

definition

Workbook definition file

Expand
Table 78.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--public

With this flag workbook will be marked as "public".

Expand
Table 78.3. Output Formatters
ValueSummary

-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

Expand
Table 78.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 78.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 78.6. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

78.2. workbook definition show

Usage:

openstack workbook definition show [-h] name

Show workbook definition.

Expand
Table 78.7. Positional Arguments
ValueSummary

name

Workbook name

Expand
Table 78.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

78.3. workbook delete

Usage:

openstack workbook delete [-h] workbook [workbook ...]

Delete workbook.

Expand
Table 78.9. Positional Arguments
ValueSummary

workbook

Name of workbook(s).

Expand
Table 78.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

78.4. workbook list

Usage:

openstack workbook list [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN]

List all workbooks.

Expand
Table 78.11. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 78.12. Output Formatters
ValueSummary

-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

Expand
Table 78.13. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 78.14. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 78.15. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

78.5. workbook show

Usage:

openstack workbook show [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX]
                             workbook

Show specific workbook.

Expand
Table 78.16. Positional Arguments
ValueSummary

workbook

Workbook name

Expand
Table 78.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 78.18. Output Formatters
ValueSummary

-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

Expand
Table 78.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 78.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 78.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

78.6. workbook update

Usage:

openstack workbook update [-h] [-f {json,shell,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--prefix PREFIX] [--public]
                               definition

Update workbook.

Expand
Table 78.22. Positional Arguments
ValueSummary

definition

Workbook definition file

Expand
Table 78.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--public

With this flag workbook will be marked as "public".

Expand
Table 78.24. Output Formatters
ValueSummary

-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

Expand
Table 78.25. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 78.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 78.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

78.7. workbook validate

Usage:

openstack workbook validate [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 definition

Validate workbook.

Expand
Table 78.28. Positional Arguments
ValueSummary

definition

Workbook definition file

Expand
Table 78.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 78.30. Output Formatters
ValueSummary

-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

Expand
Table 78.31. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 78.32. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 78.33. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 79. workflow

This chapter describes the commands under the workflow command.

79.1. workflow create

Usage:

openstack workflow create [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN]
                               [--namespace [NAMESPACE]] [--public]
                               definition

Create new workflow.

Expand
Table 79.1. Positional Arguments
ValueSummary

definition

Workflow definition file.

Expand
Table 79.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--namespace [NAMESPACE]

Namespace to create the workflow within.

--public

With this flag workflow will be marked as "public".

Expand
Table 79.3. Output Formatters
ValueSummary

-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

Expand
Table 79.4. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.5. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.6. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

79.2. workflow definition show

Usage:

openstack workflow definition show [-h] [--namespace [NAMESPACE]]

                                        identifier

Show workflow definition.

Expand
Table 79.7. Positional Arguments
ValueSummary

identifier

Workflow id or name.

Expand
Table 79.8. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--namespace [NAMESPACE]

Namespace to get the workflow from.

This command is provided by the python-mistralclient plugin.

79.3. workflow delete

Usage:

openstack workflow delete [-h] [--namespace [NAMESPACE]]

                               workflow [workflow ...]

Delete workflow.

Expand
Table 79.9. Positional Arguments
ValueSummary

workflow

Name or id of workflow(s).

Expand
Table 79.10. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--namespace [NAMESPACE]

Namespace to delete the workflow from.

This command is provided by the python-mistralclient plugin.

79.4. workflow engine service list

Usage:

openstack workflow engine service list [-h]

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

List all services.

Expand
Table 79.11. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 79.12. Output Formatters
ValueSummary

-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

Expand
Table 79.13. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.14. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.15. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

79.5. workflow env create

Usage:

openstack workflow env create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   file

Create new environment.

Expand
Table 79.16. Positional Arguments
ValueSummary

file

Environment configuration file in json or yaml

Expand
Table 79.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 79.18. Output Formatters
ValueSummary

-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

Expand
Table 79.19. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.20. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.21. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.6. workflow env delete

Usage:

openstack workflow env delete [-h] environment [environment ...]

Delete environment.

Expand
Table 79.22. Positional Arguments
ValueSummary

environment

Name of environment(s).

Expand
Table 79.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

79.7. workflow env list

Usage:

openstack workflow env list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN]

List all environments.

Expand
Table 79.24. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 79.25. Output Formatters
ValueSummary

-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

Expand
Table 79.26. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.27. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.28. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

79.8. workflow env show

Usage:

openstack workflow env show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX] [--export]
                                 environment

Show specific environment.

Expand
Table 79.29. Positional Arguments
ValueSummary

environment

Environment name

Expand
Table 79.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--export

Export the environment suitable for import

Expand
Table 79.31. Output Formatters
ValueSummary

-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

Expand
Table 79.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.34. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.9. workflow env update

Usage:

openstack workflow env update [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   file

Update environment.

Expand
Table 79.35. Positional Arguments
ValueSummary

file

Environment configuration file in json or yaml

Expand
Table 79.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 79.37. Output Formatters
ValueSummary

-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

Expand
Table 79.38. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.39. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.40. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.10. workflow execution create

Usage:

openstack workflow execution create [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--namespace [NAMESPACE]]
                                         [-d DESCRIPTION]
                                         [-s [SOURCE_EXECUTION_ID]]
                                         [workflow_identifier]
                                         [workflow_input] [params]

Create new execution.

Expand
Table 79.41. Positional Arguments
ValueSummary

workflow_identifier

Workflow id or name. workflow name will be deprecated since Mitaka.

workflow_input

Workflow input

params

Workflow additional parameters

Expand
Table 79.42. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--namespace [NAMESPACE]

Workflow namespace.

-d DESCRIPTION, --description DESCRIPTION

Execution description

-s [SOURCE_EXECUTION_ID]

Workflow Execution id which will allow operators to create a new workflow execution based on the previously successful executed workflow. Example: mistral execution-create -s 123e4567-e89b- 12d3-a456-426655440000

Expand
Table 79.43. Output Formatters
ValueSummary

-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

Expand
Table 79.44. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.45. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.46. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.11. workflow execution delete

Usage:

openstack workflow execution delete [-h] [--force]

                                         execution [execution ...]

Delete execution.

Expand
Table 79.47. Positional Arguments
ValueSummary

execution

Id of execution identifier(s).

Expand
Table 79.48. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Force the deletion of an execution. might cause a cascade of errors if used for running executions.

This command is provided by the python-mistralclient plugin.

79.12. workflow execution input show

Usage:

openstack workflow execution input show [-h] id

Show execution input data.

Expand
Table 79.49. Positional Arguments
ValueSummary

id

Execution id

Expand
Table 79.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

79.13. workflow execution list

Usage:

openstack workflow execution list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       [--task [TASK]] [--marker [MARKER]]
                                       [--limit [LIMIT]]
                                       [--sort_keys [SORT_KEYS]]
                                       [--sort_dirs [SORT_DIRS]]
                                       [--filter FILTERS]

List all executions.

Expand
Table 79.51. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--task [TASK]

Parent task execution id associated with workflow execution list.

--marker [MARKER]

The last execution uuid of the previous page, displays list of executions after "marker".

--limit [LIMIT]

Maximum number of executions to return in a single result. limit is set to 100 by default. Use --limit -1 to fetch the full result set.

--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.

Expand
Table 79.52. Output Formatters
ValueSummary

-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

Expand
Table 79.53. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.54. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.55. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

79.14. workflow execution output show

Usage:

openstack workflow execution output show [-h] id

Show execution output data.

Expand
Table 79.56. Positional Arguments
ValueSummary

id

Execution id

Expand
Table 79.57. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-mistralclient plugin.

79.15. workflow execution show

Usage:

openstack workflow execution show [-h]

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

Show specific execution.

Expand
Table 79.58. Positional Arguments
ValueSummary

execution

Execution identifier

Expand
Table 79.59. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 79.60. Output Formatters
ValueSummary

-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

Expand
Table 79.61. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.62. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.63. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.16. workflow execution update

Usage:

openstack workflow execution update [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [-s {RUNNING,PAUSED,SUCCESS,ERROR,CANCELLED}]
                                         [-e ENV] [-d DESCRIPTION]
                                         id

Update execution.

Expand
Table 79.64. Positional Arguments
ValueSummary

id

Execution identifier

Expand
Table 79.65. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

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

Execution state

-e ENV, --env ENV

Environment variables

-d DESCRIPTION, --description DESCRIPTION

Execution description

Expand
Table 79.66. Output Formatters
ValueSummary

-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

Expand
Table 79.67. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.68. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.69. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.17. workflow list

Usage:

openstack workflow list [-h] [-f {csv,json,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--sort-column SORT_COLUMN] [--filter FILTERS]

List all workflows.

Expand
Table 79.70. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--filter FILTERS

Filters. can be repeated.

Expand
Table 79.71. Output Formatters
ValueSummary

-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

Expand
Table 79.72. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.73. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.74. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

79.18. workflow show

Usage:

openstack workflow show [-h] [-f {json,shell,table,value,yaml}]

                             [-c COLUMN] [--max-width <integer>]
                             [--fit-width] [--print-empty] [--noindent]
                             [--prefix PREFIX] [--namespace [NAMESPACE]]
                             workflow

Show specific workflow.

Expand
Table 79.75. Positional Arguments
ValueSummary

workflow

Workflow id or name.

Expand
Table 79.76. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--namespace [NAMESPACE]

Namespace to get the workflow from.

Expand
Table 79.77. Output Formatters
ValueSummary

-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

Expand
Table 79.78. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.79. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.80. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

79.19. workflow update

Usage:

openstack workflow update [-h] [-f {csv,json,table,value,yaml}]

                               [-c COLUMN] [--max-width <integer>]
                               [--fit-width] [--print-empty] [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--sort-column SORT_COLUMN] [--id ID]
                               [--namespace [NAMESPACE]] [--public]
                               definition

Update workflow.

Expand
Table 79.81. Positional Arguments
ValueSummary

definition

Workflow definition

Expand
Table 79.82. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--id ID

Workflow id.

--namespace [NAMESPACE]

Namespace of the workflow.

--public

With this flag workflow will be marked as "public".

Expand
Table 79.83. Output Formatters
ValueSummary

-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

Expand
Table 79.84. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.85. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.86. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-mistralclient plugin.

79.20. workflow validate

Usage:

openstack workflow validate [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 definition

Validate workflow.

Expand
Table 79.87. Positional Arguments
ValueSummary

definition

Workflow definition file

Expand
Table 79.88. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 79.89. Output Formatters
ValueSummary

-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

Expand
Table 79.90. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 79.91. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 79.92. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-mistralclient plugin.

Chapter 80. zone

This chapter describes the commands under the zone command.

80.1. zone abandon

Usage:

openstack zone abandon [-h] [--all-projects] [--edit-managed]

                            [--sudo-project-id SUDO_PROJECT_ID]
                            id

Abandon a zone

Expand
Table 80.1. Positional Arguments
ValueSummary

id

Zone id

Expand
Table 80.2. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

80.2. zone axfr

Usage:

openstack zone axfr [-h] [--all-projects] [--edit-managed]

                         [--sudo-project-id SUDO_PROJECT_ID]
                         id

AXFR a zone

Expand
Table 80.3. Positional Arguments
ValueSummary

id

Zone id

Expand
Table 80.4. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

80.3. zone blacklist create

Usage:

openstack zone blacklist create [-h] [-f {json,shell,table,value,yaml}]

                                     [-c COLUMN] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--noindent] [--prefix PREFIX]
                                     --pattern PATTERN
                                     [--description DESCRIPTION]
                                     [--all-projects] [--edit-managed]
                                     [--sudo-project-id SUDO_PROJECT_ID]

Create new blacklist

Expand
Table 80.5. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--pattern PATTERN

Blacklist pattern

--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

Expand
Table 80.6. Output Formatters
ValueSummary

-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

Expand
Table 80.7. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.8. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.9. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.4. zone blacklist delete

Usage:

openstack zone blacklist delete [-h] [--all-projects] [--edit-managed]

                                     [--sudo-project-id SUDO_PROJECT_ID]
                                     id

Delete blacklist

Expand
Table 80.10. Positional Arguments
ValueSummary

id

Blacklist id

Expand
Table 80.11. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

80.5. zone blacklist list

Usage:

openstack zone blacklist list [-h] [-f {csv,json,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--sort-column SORT_COLUMN]
                                   [--all-projects] [--edit-managed]
                                   [--sudo-project-id SUDO_PROJECT_ID]

List blacklists

Expand
Table 80.12. Optional Arguments
ValueSummary

-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

Expand
Table 80.13. Output Formatters
ValueSummary

-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

Expand
Table 80.14. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.15. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.16. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

80.6. zone blacklist set

Usage:

openstack zone blacklist set [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] [--pattern PATTERN]
                                  [--description DESCRIPTION | --no-description]
                                  [--all-projects] [--edit-managed]
                                  [--sudo-project-id SUDO_PROJECT_ID]
                                  id

Set blacklist properties

Expand
Table 80.17. Positional Arguments
ValueSummary

id

Blacklist id

Expand
Table 80.18. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--pattern PATTERN

Blacklist pattern

--description DESCRIPTION

Description

--no-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

Expand
Table 80.19. Output Formatters
ValueSummary

-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

Expand
Table 80.20. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.21. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.22. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.7. zone blacklist show

Usage:

openstack zone blacklist show [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--all-projects] [--edit-managed]
                                   [--sudo-project-id SUDO_PROJECT_ID]
                                   id

Show blacklist details

Expand
Table 80.23. Positional Arguments
ValueSummary

id

Blacklist id

Expand
Table 80.24. Optional Arguments
ValueSummary

-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

Expand
Table 80.25. Output Formatters
ValueSummary

-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

Expand
Table 80.26. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.27. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.28. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.8. zone create

Usage:

openstack zone create [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--email EMAIL] [--type TYPE] [--ttl TTL]
                           [--description DESCRIPTION]
                           [--masters MASTERS [MASTERS ...]]
                           [--attributes ATTRIBUTES [ATTRIBUTES ...]]
                           [--all-projects] [--edit-managed]
                           [--sudo-project-id SUDO_PROJECT_ID]
                           name

Create new zone

Expand
Table 80.29. Positional Arguments
ValueSummary

name

Zone name

Expand
Table 80.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--email EMAIL

Zone email

--type TYPE

Zone type

--ttl TTL

Time to live (seconds)

--description DESCRIPTION

Description

--masters MASTERS [MASTERS …​]

Zone Masters

--attributes ATTRIBUTES [ATTRIBUTES …​]

Zone Attributes

--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

Expand
Table 80.31. Output Formatters
ValueSummary

-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

Expand
Table 80.32. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.34. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.9. zone delete

Usage:

openstack zone delete [-h] [-f {json,shell,table,value,yaml}]

                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--noindent] [--prefix PREFIX]
                           [--all-projects] [--edit-managed]
                           [--sudo-project-id SUDO_PROJECT_ID]
                           id

Delete zone

Expand
Table 80.35. Positional Arguments
ValueSummary

id

Zone id

Expand
Table 80.36. Optional Arguments
ValueSummary

-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

Expand
Table 80.37. Output Formatters
ValueSummary

-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

Expand
Table 80.38. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.39. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.40. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.10. zone export create

Usage:

openstack zone export create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] [--all-projects]
                                  [--edit-managed]
                                  [--sudo-project-id SUDO_PROJECT_ID]
                                  zone_id

Export a Zone

Expand
Table 80.41. Positional Arguments
ValueSummary

zone_id

Zone id

Expand
Table 80.42. Optional Arguments
ValueSummary

-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

Expand
Table 80.43. Output Formatters
ValueSummary

-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

Expand
Table 80.44. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.45. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.46. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.11. zone export delete

Usage:

openstack zone export delete [-h] [--all-projects] [--edit-managed]

                                  [--sudo-project-id SUDO_PROJECT_ID]
                                  zone_export_id

Delete a Zone Export

Expand
Table 80.47. Positional Arguments
ValueSummary

zone_export_id

Zone export id

Expand
Table 80.48. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

80.12. zone export list

Usage:

openstack zone export list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]

List Zone Exports

Expand
Table 80.49. Optional Arguments
ValueSummary

-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

Expand
Table 80.50. Output Formatters
ValueSummary

-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

Expand
Table 80.51. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.52. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.53. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

80.13. zone export show

Usage:

openstack zone export show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]
                                zone_export_id

Show a Zone Export

Expand
Table 80.54. Positional Arguments
ValueSummary

zone_export_id

Zone export id

Expand
Table 80.55. Optional Arguments
ValueSummary

-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

Expand
Table 80.56. Output Formatters
ValueSummary

-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

Expand
Table 80.57. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.58. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.59. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.14. zone export showfile

Usage:

openstack zone export showfile [-h] [-f {json,shell,table,value,yaml}]

                                    [-c COLUMN] [--max-width <integer>]
                                    [--fit-width] [--print-empty]
                                    [--noindent] [--prefix PREFIX]
                                    [--all-projects] [--edit-managed]
                                    [--sudo-project-id SUDO_PROJECT_ID]
                                    zone_export_id

Show the zone file for the Zone Export

Expand
Table 80.60. Positional Arguments
ValueSummary

zone_export_id

Zone export id

Expand
Table 80.61. Optional Arguments
ValueSummary

-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

Expand
Table 80.62. Output Formatters
ValueSummary

-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

Expand
Table 80.63. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.64. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.65. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.15. zone import create

Usage:

openstack zone import create [-h] [-f {json,shell,table,value,yaml}]

                                  [-c COLUMN] [--max-width <integer>]
                                  [--fit-width] [--print-empty] [--noindent]
                                  [--prefix PREFIX] [--all-projects]
                                  [--edit-managed]
                                  [--sudo-project-id SUDO_PROJECT_ID]
                                  zone_file_path

Import a Zone from a file on the filesystem

Expand
Table 80.66. Positional Arguments
ValueSummary

zone_file_path

Path to a zone file

Expand
Table 80.67. Optional Arguments
ValueSummary

-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

Expand
Table 80.68. Output Formatters
ValueSummary

-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

Expand
Table 80.69. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.70. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.71. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.16. zone import delete

Usage:

openstack zone import delete [-h] [--all-projects] [--edit-managed]

                                  [--sudo-project-id SUDO_PROJECT_ID]
                                  zone_import_id

Delete a Zone Import

Expand
Table 80.72. Positional Arguments
ValueSummary

zone_import_id

Zone import id

Expand
Table 80.73. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

80.17. zone import list

Usage:

openstack zone import list [-h] [-f {csv,json,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--quote {all,minimal,none,nonnumeric}]
                                [--sort-column SORT_COLUMN] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]

List Zone Imports

Expand
Table 80.74. Optional Arguments
ValueSummary

-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

Expand
Table 80.75. Output Formatters
ValueSummary

-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

Expand
Table 80.76. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.77. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.78. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

80.18. zone import show

Usage:

openstack zone import show [-h] [-f {json,shell,table,value,yaml}]

                                [-c COLUMN] [--max-width <integer>]
                                [--fit-width] [--print-empty] [--noindent]
                                [--prefix PREFIX] [--all-projects]
                                [--edit-managed]
                                [--sudo-project-id SUDO_PROJECT_ID]
                                zone_import_id

Show a Zone Import

Expand
Table 80.79. Positional Arguments
ValueSummary

zone_import_id

Zone import id

Expand
Table 80.80. Optional Arguments
ValueSummary

-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

Expand
Table 80.81. Output Formatters
ValueSummary

-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

Expand
Table 80.82. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.83. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.84. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.19. zone list

Usage:

openstack zone list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}]
                         [--sort-column SORT_COLUMN] [--name NAME]
                         [--email EMAIL] [--type TYPE] [--ttl TTL]
                         [--description DESCRIPTION] [--status STATUS]
                         [--all-projects] [--edit-managed]
                         [--sudo-project-id SUDO_PROJECT_ID]

List zones

Expand
Table 80.85. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name NAME

Zone name

--email EMAIL

Zone email

--type TYPE

Zone type

--ttl TTL

Time to live (seconds)

--description DESCRIPTION

Description

--status STATUS

Zone 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

Expand
Table 80.86. Output Formatters
ValueSummary

-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

Expand
Table 80.87. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.88. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.89. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

80.20. zone set

Usage:

openstack zone set [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                        [--max-width <integer>] [--fit-width]
                        [--print-empty] [--noindent] [--prefix PREFIX]
                        [--email EMAIL] [--ttl TTL]
                        [--description DESCRIPTION | --no-description]
                        [--masters MASTERS [MASTERS ...]] [--all-projects]
                        [--edit-managed] [--sudo-project-id SUDO_PROJECT_ID]
                        id

Set zone properties

Expand
Table 80.90. Positional Arguments
ValueSummary

id

Zone id

Expand
Table 80.91. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--email EMAIL

Zone email

--ttl TTL

Time to live (seconds)

--description DESCRIPTION

Description

--no-description

 

--masters MASTERS [MASTERS …​]

Zone Masters

--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

Expand
Table 80.92. Output Formatters
ValueSummary

-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

Expand
Table 80.93. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.94. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.95. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.21. zone show

Usage:

openstack zone show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]

                         [--max-width <integer>] [--fit-width]
                         [--print-empty] [--noindent] [--prefix PREFIX]
                         [--all-projects] [--edit-managed]
                         [--sudo-project-id SUDO_PROJECT_ID]
                         id

Show zone details

Expand
Table 80.96. Positional Arguments
ValueSummary

id

Zone id

Expand
Table 80.97. Optional Arguments
ValueSummary

-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

Expand
Table 80.98. Output Formatters
ValueSummary

-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

Expand
Table 80.99. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.100. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.101. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.22. zone transfer accept list

Usage:

openstack zone transfer accept list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--all-projects] [--edit-managed]
                                         [--sudo-project-id SUDO_PROJECT_ID]

List Zone Transfer Accepts

Expand
Table 80.102. Optional Arguments
ValueSummary

-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

Expand
Table 80.103. Output Formatters
ValueSummary

-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

Expand
Table 80.104. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.105. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.106. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

80.23. zone transfer accept request

Usage:

openstack zone transfer accept request [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            --transfer-id TRANSFER_ID --key
                                            KEY [--all-projects]
                                            [--edit-managed]
                                            [--sudo-project-id SUDO_PROJECT_ID]

Accept a Zone Transfer Request

Expand
Table 80.107. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--transfer-id TRANSFER_ID

Transfer ID

--key KEY

Transfer key

--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

Expand
Table 80.108. Output Formatters
ValueSummary

-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

Expand
Table 80.109. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.110. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.111. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.24. zone transfer accept show

Usage:

openstack zone transfer accept show [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--all-projects] [--edit-managed]
                                         [--sudo-project-id SUDO_PROJECT_ID]
                                         id

Show Zone Transfer Accept

Expand
Table 80.112. Positional Arguments
ValueSummary

id

Zone tranfer accept id

Expand
Table 80.113. Optional Arguments
ValueSummary

-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

Expand
Table 80.114. Output Formatters
ValueSummary

-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

Expand
Table 80.115. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.116. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.117. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.25. zone transfer request create

Usage:

openstack zone transfer request create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--target-project-id TARGET_PROJECT_ID]
                                            [--description DESCRIPTION]
                                            [--all-projects]
                                            [--edit-managed]
                                            [--sudo-project-id SUDO_PROJECT_ID]
                                            zone_id

Create new zone transfer request

Expand
Table 80.118. Positional Arguments
ValueSummary

zone_id

Zone id to transfer.

Expand
Table 80.119. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--target-project-id TARGET_PROJECT_ID

Target Project ID to transfer to.

--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

Expand
Table 80.120. Output Formatters
ValueSummary

-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

Expand
Table 80.121. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.122. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.123. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.26. zone transfer request delete

Usage:

openstack zone transfer request delete [-h] [--all-projects]

                                            [--edit-managed]
                                            [--sudo-project-id SUDO_PROJECT_ID]
                                            id

Delete a Zone Transfer Request

Expand
Table 80.124. Positional Arguments
ValueSummary

id

Zone transfer request id

Expand
Table 80.125. Optional Arguments
ValueSummary

-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

This command is provided by the python-designateclient plugin.

80.27. zone transfer request list

Usage:

openstack zone transfer request list [-h]

                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--sort-column SORT_COLUMN]
                                          [--all-projects] [--edit-managed]
                                          [--sudo-project-id SUDO_PROJECT_ID]

List Zone Transfer Requests

Expand
Table 80.126. Optional Arguments
ValueSummary

-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

Expand
Table 80.127. Output Formatters
ValueSummary

-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

Expand
Table 80.128. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.129. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.130. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-designateclient plugin.

80.28. zone transfer request set

Usage:

openstack zone transfer request set [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         [--description DESCRIPTION | --no-description]
                                         [--all-projects] [--edit-managed]
                                         [--sudo-project-id SUDO_PROJECT_ID]
                                         id

Set a Zone Transfer Request

Expand
Table 80.131. Positional Arguments
ValueSummary

id

Zone transfer request id

Expand
Table 80.132. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--description DESCRIPTION

Description

--no-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

Expand
Table 80.133. Output Formatters
ValueSummary

-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

Expand
Table 80.134. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.135. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.136. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

80.29. zone transfer request show

Usage:

openstack zone transfer request show [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--all-projects] [--edit-managed]
                                          [--sudo-project-id SUDO_PROJECT_ID]
                                          id

Show Zone Transfer Request Details

Expand
Table 80.137. Positional Arguments
ValueSummary

id

Zone tranfer request id

Expand
Table 80.138. Optional Arguments
ValueSummary

-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

Expand
Table 80.139. Output Formatters
ValueSummary

-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

Expand
Table 80.140. Table Formatter
ValueSummary

--max-width <integer>

Maximum display width, <1 to disable. You can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence.

--fit-width

Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable

--print-empty

Print empty table if there is no data to show.

Expand
Table 80.141. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 80.142. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-designateclient plugin.

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る