..
    Warning: Do not edit this file. It is automatically generated from the
    software project's code and your changes will be overwritten.

    The tool to generate this file lives in openstack-doc-tools repository.

    Please make any changes needed in the code, then run the
    autogenerate-config-doc tool from the openstack-doc-tools repository, or
    ask for help on the documentation mailing list, IRC channel or meeting.

.. _nova-api:

.. list-table:: Description of API configuration options
   :header-rows: 1
   :class: config-ref-table

   * - Configuration option = Default value
     - Description
   * - **[DEFAULT]**
     -
   * - ``api_paste_config`` = ``api-paste.ini``
     - (StrOpt) File name for the paste.deploy config for nova-api
   * - ``api_rate_limit`` = ``False``
     - (BoolOpt) Whether to use per-user rate limiting for the api. This option is only used by v2 api. Rate limiting is removed from v2.1 api.
   * - ``client_socket_timeout`` = ``900``
     - (IntOpt) Timeout for client connections' socket operations. If an incoming connection is idle for this number of seconds it will be closed. A value of '0' means wait forever.
   * - ``enable_new_services`` = ``True``
     - (BoolOpt) Services to be added to the available pool on create
   * - ``enabled_apis`` = ``ec2, osapi_compute, metadata``
     - (ListOpt) A list of APIs to enable by default
   * - ``enabled_ssl_apis`` =
     - (ListOpt) A list of APIs with enabled SSL
   * - ``instance_name_template`` = ``instance-%08x``
     - (StrOpt) Template string to be used to generate instance names
   * - ``max_header_line`` = ``16384``
     - (IntOpt) Maximum line size of message headers to be accepted. max_header_line may need to be increased when using large tokens (typically those generated by the Keystone v3 API with big service catalogs).
   * - ``multi_instance_display_name_template`` = ``%(name)s-%(count)d``
     - (StrOpt) When creating multiple instances with a single request using the os-multiple-create API extension, this template will be used to build the display name for each instance. The benefit is that the instances end up with different hostnames. To restore legacy behavior of every instance having the same name, set this option to "%(name)s". Valid keys for the template are: name, uuid, count.
   * - ``non_inheritable_image_properties`` = ``cache_in_nova, bittorrent``
     - (ListOpt) These are image properties which a snapshot should not inherit from an instance
   * - ``null_kernel`` = ``nokernel``
     - (StrOpt) Kernel image that indicates not to use a kernel, but to use a raw disk image instead
   * - ``osapi_compute_ext_list`` =
     - (ListOpt) DEPRECATED: Specify list of extensions to load when using osapi_compute_extension option with nova.api.openstack.compute.legacy_v2.contrib.select_extensions This option will be removed in the near future. After that point you have to run all of the API.
   * - ``osapi_compute_extension`` = ``['nova.api.openstack.compute.legacy_v2.contrib.standard_extensions']``
     - (MultiStrOpt) osapi compute extension to load. This option will be removed in the near future. After that point you have to run all of the API.
   * - ``osapi_compute_link_prefix`` = ``None``
     - (StrOpt) Base URL that will be presented to users in links to the OpenStack Compute API
   * - ``osapi_compute_listen`` = ``0.0.0.0``
     - (StrOpt) The IP address on which the OpenStack API will listen.
   * - ``osapi_compute_listen_port`` = ``8774``
     - (IntOpt) The port on which the OpenStack API will listen.
   * - ``osapi_compute_workers`` = ``None``
     - (IntOpt) Number of workers for OpenStack API service. The default will be the number of CPUs available.
   * - ``osapi_hide_server_address_states`` = ``building``
     - (ListOpt) List of instance states that should hide network info
   * - ``secure_proxy_ssl_header`` = ``None``
     - (StrOpt) The HTTP header used to determine the scheme for the original request, even if it was removed by an SSL terminating proxy. Typical value is "HTTP_X_FORWARDED_PROTO".
   * - ``servicegroup_driver`` = ``db``
     - (StrOpt) The driver for servicegroup service.
   * - ``snapshot_name_template`` = ``snapshot-%s``
     - (StrOpt) Template string to be used to generate snapshot names
   * - ``tcp_keepidle`` = ``600``
     - (IntOpt) Sets the value of TCP_KEEPIDLE in seconds for each server socket. Not supported on OS X.
   * - ``use_forwarded_for`` = ``False``
     - (BoolOpt) Treat X-Forwarded-For as the canonical remote address. Only enable this if you have a sanitizing proxy.
   * - ``wsgi_default_pool_size`` = ``1000``
     - (IntOpt) Size of the pool of greenthreads used by wsgi
   * - ``wsgi_keep_alive`` = ``True``
     - (BoolOpt) If False, closes the client socket connection explicitly.
   * - ``wsgi_log_format`` = ``%(client_ip)s "%(request_line)s" status: %(status_code)s len: %(body_length)s time: %(wall_seconds).7f``
     - (StrOpt) A python format string that is used as the template to generate log lines. The following values can be formatted into it: client_ip, date_time, request_line, status_code, body_length, wall_seconds.
   * - **[oslo_middleware]**
     -
   * - ``max_request_body_size`` = ``114688``
     - (IntOpt) The maximum body size for each request, in bytes.
   * - ``secure_proxy_ssl_header`` = ``X-Forwarded-Proto``
     - (StrOpt) The HTTP Header that will be used to determine what the original request protocol scheme was, even if it was hidden by an SSL termination proxy.
   * - **[oslo_versionedobjects]**
     -
   * - ``fatal_exception_format_errors`` = ``False``
     - (BoolOpt) Make exception message format errors fatal