From cc1aebaa10213458bdbf4ab7db22853aa1c524f8 Mon Sep 17 00:00:00 2001 From: Xin Wang Date: Mon, 4 Nov 2019 22:23:06 +0800 Subject: [PATCH] Clarify idempotent for ControllerExpandVolume Add explicit documentation for clarity idempotent for ControllerExpandVolume. Signed-off-by: Xin Wang --- spec.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/spec.md b/spec.md index ca12793b..fe023cd2 100644 --- a/spec.md +++ b/spec.md @@ -1802,6 +1802,8 @@ The CO MUST implement the specified error recovery behavior when it encounters t A Controller plugin MUST implement this RPC call if plugin has `EXPAND_VOLUME` controller capability. This RPC allows the CO to expand the size of a volume. +This operation MUST be idempotent. If a volume corresponding to the specified volume ID is larger than or equal to the capacity requirements after expansion, the plugin MUST reply 0 OK. + This call MAY be made by the CO during any time in the lifecycle of the volume after creation if plugin has `VolumeExpansion.ONLINE` capability. If plugin has `EXPAND_VOLUME` node capability, then `NodeExpandVolume` MUST be called after successful `ControllerExpandVolume` and `node_expansion_required` in `ControllerExpandVolumeResponse` is `true`.