CINXE.COM
OpenStack Block Storage (Cinder) documentation — cinder 25.1.0.dev90 documentation
<!DOCTYPE html> <html lang="en" data-content_root="./"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> <title>OpenStack Block Storage (Cinder) documentation — cinder 25.1.0.dev90 documentation</title> <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fe63c2af" /> <link rel="stylesheet" type="text/css" href="_static/basic.css?v=5c69cfe2" /> <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=4ae1632d" /> <link rel="stylesheet" type="text/css" href="_static/support-matrix.css" /> <script src="_static/documentation_options.js?v=99de8d10"></script> <script src="_static/doctools.js?v=9bcbadda"></script> <script src="_static/sphinx_highlight.js?v=dc90522c"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Cinder Installation Guide" href="install/index.html" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <!-- Bootstrap CSS --> <link href="_static/css/bootstrap.min.css" rel="stylesheet"> <!-- Fonts --> <link href="_static/css/font-awesome.min.css" rel="stylesheet"> <!-- Custom CSS --> <link href="_static/css/combined.css" rel="stylesheet"> <!-- Search CSS --> <link href="_static/css/search.css" rel="stylesheet"> <!-- Pygments CSS --> <link href="_static/pygments.css" rel="stylesheet"> <!-- HTML5 Shim and Respond.js IE8 support of HTML5 elements and media queries --> <!-- WARNING: Respond.js doesn't work if you view the page via file:// --> <!--[if lt IE 9]> <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script> <script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script> <![endif]--> <!-- Google Analytics --> <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-17511903-1', 'auto'); ga('send', 'pageview'); </script> <!-- End Google Analytics --> </head><body> <!-- SOURCE_FILE: https://opendev.org/openstack/cinder/src/doc/source/index.rst --> <script> (function (window, document) { var loader = function () { var script = document.createElement("script"), tag = document.getElementsByTagName("script")[0]; script.src = "https://search.openstack.org/widget/embed.min.js?t="+Date.now(); tag.parentNode.insertBefore(script, tag); }; window.addEventListener ? window.addEventListener("load", loader, false) : window.attachEvent("onload", loader); })(window, document); </script> <nav class="navbar navbar-default" role="navigation"> <div class="container"> <!-- Brand and toggle get grouped for better mobile display --> <div class="navbar-header"> <button class="navbar-toggle" data-target="#bs-example-navbar-collapse-1" data-toggle="collapse" type="button"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <div class="brand-wrapper"> <a class="navbar-brand" href="https://www.openstack.org/"></a> </div> <div class="search-icon show"><i class="fa fa-search"></i> Search</div></div> <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> <div class="search-container tiny"> <div class="openstack-search-bar" data-baseUrl="search.openstack.org" data-context="docs-openstack"></div> </div> <ul class="nav navbar-nav navbar-main show"> <li class="search-container-mobile"> <div class="openstack-search-bar" data-baseUrl="search.openstack.org" data-context="docs-openstack"></div> </li> <li> <!--Software --> <a href="https://www.openstack.org/software/" class="drop" id="dropdownMenuSoftware">Software <i class="fa fa-caret-down"></i></a> <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenuSoftware"> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/software/">Overview</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/software/project-navigator/openstack-components">OpenStack Components</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/software/project-navigator/sdks">SDKs</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/software/project-navigator/deployment-tools">Deployment Tools</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/assets/software/projectmap/openstack-map.pdf" target="_blank">OpenStack Map</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/software/sample-configs/">Sample Configs</a></li> </ul> </li> <li> <!-- Use Cases --> <a href="https://www.openstack.org/use-cases/" class="drop" id="dropdownMenuUsers">Use Cases <i class="fa fa-caret-down"></i></a> <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenuUsers"> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/">Users in Production</a></li> <li role="presentation" class="divider"></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/bare-metal/">Ironic Bare Metal</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/edge-computing/">Edge Computing</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/telecoms-and-nfv/">Telecom & NFV</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/science/">Science and HPC</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/containers/">Containers</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/use-cases/enterprise/">Enterprise</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/surveys/landing">User Survey</a></li> </ul> </li> <li> <!-- Events --> <a href="https://openinfra.dev/summit" class="drop" id="dropdownMenuEvents">Events <i class="fa fa-caret-down"></i></a> <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenuEvents"> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://openinfra.dev/summit">OpenInfra Summit</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/ptg/">Project Teams Gathering</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/events/opendev-2020/">OpenDev</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/events/community-events/">Community Events</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/events/openstackdays">OpenStack & OpenInfra Days</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/videos/">Summit Videos</a></li> </ul> </li> <li><!-- Community --> <a href="https://www.openstack.org/community/" class="drop" id="dropdownMenuCommunity">Community <i class="fa fa-caret-down"></i></a> <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenuCommunity"> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/community/">Welcome! Start Here</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/community/tech-committee">OpenStack Technical Committee</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/community/speakers/">Speakers Bureau</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="http://wiki.openstack.org">OpenStack Wiki</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/coa/">Get Certified (COA)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/community/jobs/">Jobs</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketing/">Marketing Resources</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/news/">Community News</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="http://superuser.openstack.org">Superuser Magazine</a></li> <li role="presentation" class="divider"></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/community/supporting-organizations/">OpenInfra Foundation Supporting Organizations</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://openinfra.dev">OpenInfra Foundation</a></li> </ul> </li> <li><!-- Marketplace --> <a href="https://www.openstack.org/marketplace/" class="drop" id="dropdownMenuLearn">Marketplace <i class="fa fa-caret-down"></i></a> <ul class="dropdown-menu dropdown-hover" role="menu" aria-labelledby="dropdownMenuEvents"> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/training/">Training</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/distros/">Distros & Appliances</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/public-clouds/">Public Clouds</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/hosted-private-clouds/">Hosted Private Clouds</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/remotely-managed-private-clouds/">Remotely Managed Private Clouds</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/consulting/">Consulting & Integrators</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://www.openstack.org/marketplace/drivers/">Drivers</a></li> </ul> </li> <li><!-- Blog --> <a href="https://www.openstack.org/blog/">Blog</a> </li> <li><!-- Docs --> <a href="http://docs.openstack.org/">Docs</a> </li> <li class="join-nav-section"> <!-- Join --> <a href="https://openinfra.dev/join/" id="dropdownMenuJoin">Join <i class="fa fa-caret-down"></i></a> <ul class="dropdown-menu dropdown-hover" role="menu" aria-labelledby="dropdownMenuJoin" style="display: none;"> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://openinfra.dev/join/">Sign up for Foundation Membership</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://openinfra.dev/join/">Sponsor the Foundation</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://openinfra.dev">More about the Foundation</a></li> </ul> </li> <li> <!-- Login --> <a href="https://www.openstack.org/Security/login/?BackURL=/home/" class="sign-in-btn">Log In</a> </li> </ul> </div> </div> <!-- /.container --> </nav> <div class="container docs-book-wrapper"> <div class="row"> <div class="col-lg-9 col-md-8 col-sm-8 col-lg-push-3 col-md-push-4 col-sm-push-4"> <div class="row docs-title"> <div class="col-lg-8"> <h1>OpenStack Block Storage (Cinder) documentation</h1> </div> <div class="docs-actions"> <a href="install/index.html"><i class="fa fa-angle-double-right" data-toggle="tooltip" data-placement="top" title="Next: Cinder Installation Guide"></i></a> <a id="pdfLink1" href="" target="_blank" title="Download the manuals as PDF"><i class="fa fa-file-pdf-o" data-toggle="tooltip" data-placement="top" title="Download PDF"></i></a> <a id="logABugLink1" href="" target="_blank" title="Found an error? Report a bug against this page"><i class="fa fa-bug" data-toggle="tooltip" data-placement="top" title="Report a Bug"></i></a> </div> </div> <div class="row"> <div class="col-lg-12"> <div class="docs-body" role="main"> <section id="openstack-block-storage-cinder-documentation"> <h1>OpenStack Block Storage (Cinder) documentation<a class="headerlink" href="#openstack-block-storage-cinder-documentation" title="Link to this heading">¶</a></h1> <figure class="align-center"> <img alt="Cinder logo" src="_images/cinder.png" /> </figure> <section id="what-is-cinder"> <h2>What is Cinder?<a class="headerlink" href="#what-is-cinder" title="Link to this heading">¶</a></h2> <p>Cinder is the OpenStack Block Storage service for providing volumes to Nova virtual machines, Ironic bare metal hosts, containers and more. Some of the goals of Cinder are to be/have:</p> <ul class="simple"> <li><p><strong>Component based architecture</strong>: Quickly add new behaviors</p></li> <li><p><strong>Highly available</strong>: Scale to very serious workloads</p></li> <li><p><strong>Fault-Tolerant</strong>: Isolated processes avoid cascading failures</p></li> <li><p><strong>Recoverable</strong>: Failures should be easy to diagnose, debug, and rectify</p></li> <li><p><strong>Open Standards</strong>: Be a reference implementation for a community-driven api</p></li> </ul> </section> <section id="for-end-users"> <h2>For end users<a class="headerlink" href="#for-end-users" title="Link to this heading">¶</a></h2> <p>As an end user of Cinder, you’ll use Cinder to create and manage volumes using the Horizon user interface, command line tools such as the <a class="reference external" href="https://docs.openstack.org/python-cinderclient/latest/">python-cinderclient</a>, or by directly using the <a class="reference external" href="https://docs.openstack.org/api-ref/block-storage/">REST API</a>.</p> <section id="tools-for-using-cinder"> <h3>Tools for using Cinder<a class="headerlink" href="#tools-for-using-cinder" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><p><a class="reference external" href="https://docs.openstack.org/horizon/latest/user/manage-volumes.html">Horizon</a>: The official web UI for the OpenStack Project.</p></li> <li><p><a class="reference external" href="https://docs.openstack.org/python-openstackclient/latest/">OpenStack Client</a>: The official CLI for OpenStack Projects. You should use this as your CLI for most things, it includes not just nova commands but also commands for most of the projects in OpenStack.</p></li> <li><p><a class="reference external" href="https://docs.openstack.org/python-cinderclient/latest/user/shell.html">Cinder Client</a>: The <strong>openstack</strong> CLI is recommended, but there are some advanced features and administrative commands that are not yet available there. For CLI access to these commands, the <strong>cinder</strong> CLI can be used instead.</p></li> </ul> </section> <section id="using-the-cinder-api"> <h3>Using the Cinder API<a class="headerlink" href="#using-the-cinder-api" title="Link to this heading">¶</a></h3> <p>All features of Cinder are exposed via a REST API that can be used to build more complicated logic or automation with Cinder. This can be consumed directly or via various SDKs. The following resources can help you get started consuming the API directly.</p> <ul class="simple"> <li><p><a class="reference external" href="https://docs.openstack.org/api-ref/block-storage/">Cinder API</a></p></li> <li><p><a class="reference internal" href="contributor/api_microversion_history.html"><span class="doc">Cinder microversion history</span></a></p></li> </ul> </section> </section> <section id="for-operators"> <h2>For operators<a class="headerlink" href="#for-operators" title="Link to this heading">¶</a></h2> <p>This section has details for deploying and maintaining Cinder services.</p> <section id="installing-cinder"> <h3>Installing Cinder<a class="headerlink" href="#installing-cinder" title="Link to this heading">¶</a></h3> <p>Cinder can be configured standalone using the configuration setting <code class="docutils literal notranslate"><span class="pre">auth_strategy</span> <span class="pre">=</span> <span class="pre">noauth</span></code>, but in most cases you will want to at least have the <a class="reference external" href="https://docs.openstack.org/keystone/latest/install/">Keystone</a> Identity service and other <a class="reference external" href="https://docs.openstack.org/latest/install/">OpenStack services</a> installed.</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="install/index.html">Installation Guide</a></li> </ul> </div> </section> <section id="administrating-cinder"> <h3>Administrating Cinder<a class="headerlink" href="#administrating-cinder" title="Link to this heading">¶</a></h3> <p>Contents:</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="admin/index.html">Cinder Administration</a></li> </ul> </div> </section> <section id="reference"> <h3>Reference<a class="headerlink" href="#reference" title="Link to this heading">¶</a></h3> <p>Contents:</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="configuration/index.html">Cinder Service Configuration</a></li> </ul> </div> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="drivers-all-about.html">All About Cinder Drivers</a><ul> <li class="toctree-l2"><a class="reference internal" href="reference/support-matrix.html">Cinder Driver Support Matrix</a></li> <li class="toctree-l2"><a class="reference internal" href="drivers.html">Available Drivers</a></li> </ul> </li> </ul> </div> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="cli/index.html">Command-Line Interface Reference</a></li> </ul> </div> </section> <section id="additional-resources"> <h3>Additional resources<a class="headerlink" href="#additional-resources" title="Link to this heading">¶</a></h3> <ul class="simple"> <li><p><a class="reference external" href="https://docs.openstack.org/releasenotes/cinder/">Cinder release notes</a></p></li> </ul> </section> </section> <section id="for-contributors"> <h2>For contributors<a class="headerlink" href="#for-contributors" title="Link to this heading">¶</a></h2> <p>Contributions to Cinder are welcome. There can be a lot of background information needed to get started. This section should help get you started. Please feel free to also ask any questions in the <strong>#openstack-cinder</strong> IRC channel.</p> <section id="contributing-to-cinder"> <h3>Contributing to Cinder<a class="headerlink" href="#contributing-to-cinder" title="Link to this heading">¶</a></h3> <p>Contents:</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="contributor/index.html">Contributor Guide</a></li> <li class="toctree-l1"><a class="reference internal" href="contributor/api_microversion_dev.html">API Microversions</a></li> </ul> </div> </section> </section> <section id="for-reviewers"> <h2>For reviewers<a class="headerlink" href="#for-reviewers" title="Link to this heading">¶</a></h2> <ul class="simple"> <li><p><a class="reference internal" href="contributor/gerrit.html#transition-guidelines"><span class="std std-ref">Python 2 to Python 3 transition guidelines</span></a></p></li> </ul> </section> <section id="additional-reference"> <h2>Additional reference<a class="headerlink" href="#additional-reference" title="Link to this heading">¶</a></h2> <p>Contents:</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="common/glossary.html">Glossary</a></li> </ul> </div> </section> <section id="indices-and-tables"> <h2>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Link to this heading">¶</a></h2> <p>Contents:</p> <ul class="simple"> <li><p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></p></li> <li><p><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></p></li> </ul> </section> </section> </div> </div> </div> <div class="docs-actions"> <a href="install/index.html"><i class="fa fa-angle-double-right" data-toggle="tooltip" data-placement="top" title="Next: Cinder Installation Guide"></i></a> <a id="pdfLink2" href="" target="_blank" title="Download the manuals as PDF"><i class="fa fa-file-pdf-o" data-toggle="tooltip" data-placement="top" title="Download PDF"></i></a> <a id="logABugLink3" href="" target="_blank" title="Found an error? Report a bug against this page"><i class="fa fa-bug" data-toggle="tooltip" data-placement="top" title="Report a Bug"></i></a> </div> <div class="row docs-byline bottom"> <div class="docs-updated">this page last updated: 2021-09-24 17:25:46</div> </div> <div class="row"> <div class="col-lg-8 col-md-8 col-sm-8 docs-license"> <a href="https://creativecommons.org/licenses/by/3.0/"> <img src="_static/images/docs/license.png" alt="Creative Commons Attribution 3.0 License"/> </a> <p> Except where otherwise noted, this document is licensed under <a href="https://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 License</a>. See all <a href="https://www.openstack.org/legal"> OpenStack Legal Documents</a>. </p> </div> <div class="col-lg-4 col-md-4 col-sm-4 docs-actions-wrapper"> <!-- ID buglinkbottom added so that pre-filled doc bugs are sent to Launchpad projects related to the document --> <a href="#" id="logABugLink2" class="docs-footer-actions"><i class="fa fa-bug"></i> found an error? report a bug</a> </div> </div> </div> <div class="col-lg-3 col-md-4 col-sm-4 col-lg-pull-9 col-md-pull-8 col-sm-pull-8 docs-sidebar"> <div class="btn-group docs-sidebar-releases"> <button onclick="location.href='/'" class="btn docs-sidebar-home" data-toggle="tooltip" data-placement="top" title="OpenStack Docs Home"><i class="fa fa-arrow-circle-o-left"></i></button> <button type="button" data-toggle="dropdown" class="btn docs-sidebar-release-select">OpenStack Documentation<i class="fa fa-caret-down"></i></button> <ul class="dropdown-menu docs-sidebar-dropdown" role="menu"> <li role="presentation" class="dropdown-header">Guides</li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/index.html#install-guides">Install Guides</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/index.html#user-guides">User Guides</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/index.html#configuration-guides">Configuration Guides</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/index.html#ops-and-admin-guides">Operations and Administration Guides</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/index.html#api-guides">API Guides</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/index.html#contributor-guides">Contributor Guides</a></li> <li role="presentation" class="dropdown-header">Languages</li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/de/">Deutsch (German)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/fr/">Français (French)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/id/">Bahasa Indonesia (Indonesian)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/it/">Italiano (Italian)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/ja/">日本語 (Japanese)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/ko_KR/">한국어 (Korean)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/pt_BR/">Português (Portuguese)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/tr_TR/">Türkçe (Türkiye)</a></li> <li role="presentation"><a role="menuitem" tabindex="-1" href="https://docs.openstack.org/zh_CN/">简体中文 (Simplified Chinese)</a></li> </ul> </div> <div class="docs-sidebar-toc"> <div class="docs-sidebar-section" id="table-of-contents"> <a href="#" class="docs-sidebar-section-title"><h4>cinder 25.1.0.dev90</h4></a> <ul> <li class="toctree-l1"><a class="reference internal" href="install/index.html">Installation Guide</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="admin/index.html">Cinder Administration</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="configuration/index.html">Cinder Service Configuration</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="drivers-all-about.html">All About Cinder Drivers</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="cli/index.html">Command-Line Interface Reference</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="contributor/index.html">Contributor Guide</a></li> <li class="toctree-l1"><a class="reference internal" href="contributor/api_microversion_dev.html">API Microversions</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="common/glossary.html">Glossary</a></li> </ul> </div> <div class="docs-sidebar-toc"> <div class="docs-sidebar-section" id="local-table-of-contents"> <h4 class="docs-sidebar-section-title">Page Contents</h4> <ul> <li><a class="reference internal" href="#">OpenStack Block Storage (Cinder) documentation</a><ul> <li><a class="reference internal" href="#what-is-cinder">What is Cinder?</a></li> <li><a class="reference internal" href="#for-end-users">For end users</a><ul> <li><a class="reference internal" href="#tools-for-using-cinder">Tools for using Cinder</a></li> <li><a class="reference internal" href="#using-the-cinder-api">Using the Cinder API</a></li> </ul> </li> <li><a class="reference internal" href="#for-operators">For operators</a><ul> <li><a class="reference internal" href="#installing-cinder">Installing Cinder</a></li> <li><a class="reference internal" href="#administrating-cinder">Administrating Cinder</a></li> <li><a class="reference internal" href="#reference">Reference</a><ul> </ul> </li> <li><a class="reference internal" href="#additional-resources">Additional resources</a></li> </ul> </li> <li><a class="reference internal" href="#for-contributors">For contributors</a><ul> <li><a class="reference internal" href="#contributing-to-cinder">Contributing to Cinder</a></li> </ul> </li> <li><a class="reference internal" href="#for-reviewers">For reviewers</a></li> <li><a class="reference internal" href="#additional-reference">Additional reference</a></li> <li><a class="reference internal" href="#indices-and-tables">Indices and tables</a></li> </ul> </li> </ul> </div> </div> </div> </div> </div> </div> <footer> <div class="container"> <div class="row footer-links"> <div class="col-lg-2 col-sm-2"> <h3>OpenStack</h3> <ul> <li><a href="https://www.openstack.org/software/project-navigator/">Projects</a></li> <li><a href="https://security.openstack.org/">OpenStack Security</a></li> <li><a href="https://openstack.org/blog/">Blog</a></li> <li><a href="https://openstack.org/news/">News</a></li> </ul> </div> <div class="col-lg-2 col-sm-2"> <h3>Community</h3> <ul> <li><a href="https://www.meetup.com/pro/openinfradev/">User Groups</a></li> <li><a href="https://openstack.org/community/events/">Events</a></li> <li><a href="https://openstack.org/community/jobs/">Jobs</a></li> <li><a href="https://openinfra.dev/members/">Companies</a></li> <li><a href="https://docs.openstack.org/contributors">Contribute</a></li> </ul> </div> <div class="col-lg-2 col-sm-2"> <h3>Documentation</h3> <ul> <li><a href="https://docs.openstack.org">OpenStack Manuals</a></li> <li><a href="https://openstack.org/software/start/">Getting Started</a></li> <li><a href="https://developer.openstack.org">API Documentation</a></li> <li><a href="https://wiki.openstack.org">Wiki</a></li> </ul> </div> <div class="col-lg-2 col-sm-2"> <h3>Branding & Legal</h3> <ul> <li><a href="https://openinfra.dev/legal">Legal Docs</a></li> <li><a href="https://openstack.org/brand/">Logos & Guidelines</a></li> <li><a href="https://openinfra.dev/legal/trademark-policy">Trademark Policy</a></li> <li><a href="https://openinfra.dev/privacy-policy">Privacy Policy</a></li> <li><a href="https://docs.openstack.org/contributors/common/setup-gerrit.html#individual-contributor-license-agreement">OpenInfra CLA</a></li> </ul> </div> <div class="col-lg-4 col-sm-4"> <h3>Stay In Touch</h3> <a href="https://twitter.com/OpenStack" target="_blank" class="social-icons footer-twitter"></a> <a href="https://www.facebook.com/openinfradev" target="_blank" class="social-icons footer-facebook"></a> <a href="https://www.linkedin.com/company/open-infrastructure-foundation" target="_blank" class="social-icons footer-linkedin"></a> <a href="https://www.youtube.com/user/OpenStackFoundation" target="_blank" class="social-icons footer-youtube"></a> <p class="fine-print"> The OpenStack project is provided under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 license</a>. Docs.openstack.org is powered by <a href="https://rackspace.com" target="_blank">Rackspace Cloud Computing</a>. </p> </div> </div> </div> </footer> <!-- jQuery --> <script src="_static/js/jquery-3.2.1.min.js"></script> <!-- Bootstrap JavaScript --> <script src="_static/js/bootstrap.min.js"></script> <!-- The rest of the JS --> <script src="_static/js/navigation.js"></script> <!-- Docs JS --> <script src="_static/js/docs.js"></script> <!-- Javascript for page --> <script> /* Build a description of this page including SHA, source location on git * repo, build time and the project's launchpad bug tag. Set the HREF of the * bug buttons */ var lineFeed = "%0A"; var gitURL = "Source: Can't derive source file URL"; /* there have been cases where "pagename" wasn't set; better check for it */ /* "giturl" is the URL of the source file on Git and is auto-generated by * openstackdocstheme. * * "pagename" is a standard sphinx parameter containing the name of * the source file, without extension. */ var sourceFile = "index" + ".rst"; gitURL = "Source: https://opendev.org/openstack/cinder/src/doc/source" + "/" + sourceFile; /* gitsha, project and bug_tag rely on variables in conf.py */ var gitSha = "SHA: 008337a3dae538a25779959e4e6c5e724fdfab23"; var repositoryName = "openstack/cinder"; var bugProject = "cinder"; var bugTitle = "OpenStack Block Storage (Cinder) documentation in cinder"; var fieldTags = "doc"; var useStoryboard = ""; /* "last_updated" is the build date and time. It relies on the conf.py variable "html_last_updated_fmt", which should include year/month/day as well as hours and minutes */ var buildstring = "Release: 25.1.0.dev90 on 2021-09-24 17:25:46"; var fieldComment = encodeURI(buildstring) + lineFeed + encodeURI(gitSha) + lineFeed + encodeURI(gitURL) ; logABug(bugTitle, bugProject, fieldComment, fieldTags, repositoryName, useStoryboard); var currentSourceFile = "index"; var pdfFileName = "doc-cinder.pdf"; pdfLink(currentSourceFile, pdfFileName); </script> <script> $(document).ready(function(){ $.ajax({ context: this, dataType : "html", url : "https://docs.openstack.org/latest/badge.html", success : function(results) { $('#deprecated-badge-container').html(results); } }); }); </script> <div id="deprecated-badge-container"></div> </body> </html>