Merge "Deprecate CONF.api.allow_instance_snapshots"

2017-04-18 12:54:52 +00:00
parent a2d8680cc6 43fe032a15
commit a41136dfee
2 changed files with 15 additions and 0 deletions
@@ -259,6 +259,14 @@ allow_instance_snapshots_opts = [
    cfg.BoolOpt("allow_instance_snapshots",
        default=True,
        deprecated_group="DEFAULT",
+        deprecated_for_removal=True,
+        deprecated_since="16.0.0",
+        deprecated_reason="This option disables the createImage server action "
+                          "API in a non-discoverable way and is thus a "
+                          "barrier to interoperability. Also, it is not used "
+                          "for other APIs that create snapshots like shelve "
+                          "or createBackup. Disabling snapshots should be "
+                          "done via policy if so desired.",
        help="""
 Operators can turn off the ability for a user to take snapshots of their
 instances by setting this option to False. When disabled, any attempt to
@@ -0,0 +1,7 @@
+---
+deprecations:
+  - |
+    The ``[api]/allow_instance_snapshots`` configuration option is now
+    deprecated for removal. To disable snapshots in the ``createImage`` server
+    action API, change the ``os_compute_api:servers:create_image`` and
+    ``os_compute_api:servers:create_image:allow_volume_backed`` policies.