*********
configure
*********



===========
Description
===========

Configure NIFCLOUD CLI options. If this command is run with noarguments you will be prompted for configuration values such asyour NIFCLOUD Access Key Id and your NIFCLOUD Secret Access Key.You can configure a named profile using the ``--profile`` argument.If your config file does not exist (the default location is``~/.nifcloud/config``), the NIFCLOUD CLI will create it for you. Tokeep an existing value, hit enter when prompted for the value. whenyou are prompted for information, the current value will be displayedin ``[brackets]``.  If the config item has no value, it be displayedas ``[None]``.  Note that the ``configure`` command only works withvalues from the config file.  It does not use any configurationvalues from environment variables.Note: the values you provide for the NIFCLOUD Access Key ID and theNIFCLOUD Secret Access Key will be written to the shared credentialsfile (``~/.nifcloud/credentials``).



========
Synopsis
========

::

    nifcloud configure [--profile profile-name]




=======
Options
=======

*None*


==================
Available Commands
==================


.. toctree::
  :maxdepth: 1
  :titlesonly:

  add-model
  get
  list
  set


========
Examples
========

To create a new configuration::

    $ nifcloud configure
    NIFCLOUD Access Key ID [None]: accesskey
    NIFCLOUD Secret Access Key [None]: secretkey
    Default region name [None]: us-west-2
    Default output format [None]:

To update just the region name::

    $ nifcloud configure
    NIFCLOUD Access Key ID [****]:
    NIFCLOUD Secret Access Key [****]:
    Default region name [us-west-1]: us-west-2
    Default output format [None]: