From 32ce20c41c5970824dc4b241263f8e47f1f41cd9 Mon Sep 17 00:00:00 2001 From: Ken'ichi Ohmichi Date: Tue, 8 Dec 2015 05:46:35 +0000 Subject: [PATCH] Remove XML description from extension concept XML API interface has been already removed from Nova completely, and its description of the extension concept becomes meaningless now. So this patch removes it. A small amount of the JSON description is left. The details are trimmed down, as we're actually trying to get people away from extensions as a concept. A big warning to that effect is added into the document. Partially implements blueprint complete-todo-in-api-concept-doc Change-Id: Icf8bf87f38733ba03cf5ce1225594b0b282fde56 --- api-guide/source/extensions.rst | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/api-guide/source/extensions.rst b/api-guide/source/extensions.rst index 26c93f091b66..c9615f0dc8a4 100644 --- a/api-guide/source/extensions.rst +++ b/api-guide/source/extensions.rst @@ -12,17 +12,16 @@ version might not be available in another. Extensions may also be queried individually by their unique alias. This provides the simplest method of checking if an extension is available -because an unavailable extension issues an itemNotFound (404) response. +because an unavailable extension issues an itemNotFound (404) +response. Extensions may define new data types, parameters, actions, headers, -states, and resources. In XML, additional elements and attributes can be -defined. These elements must be defined in the namespace for the -extension. In JSON, the alias must be used. The volumes element is -defined in the ``RS-CBS`` namespace. Extended headers are always -prefixed with ``X-`` followed by the alias and a dash: -(``X-RS-CBS-HEADER1``). States and parameters must be prefixed with the -extension alias followed by a colon. For example, an image might be in -the ``RS-PIE:PrepareShare`` state. +states, and resources. + +NOTE: Extensions is a deprecated concept in Nova and their support +will be removed in a future version. If your product or cloud relies +on extensions you should work on getting those features into the main +upstream project. Important ~~~~~~~~~ @@ -146,4 +145,3 @@ extended request. "href":"https://cbs.api.rackspacecloud.com/12934/volumes/19" } } -