When osapi_max_limit is set in cinder.conf, the return amount will change dependent on API called. With the V1 API the vale set in the cinder.conf will be returned, while in V2 it will loop around the max limit until there is nothing to return.
ubuntu@devstack:~$ cinder --version
1.2.2
ubuntu@devstack:~$ grep osapi_max /etc/cinder/cinder.conf
osapi_max_limit = 5
ubuntu@devstack:~$ cinder --os-volume-api-version 1 list
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
| ID | Status | Display Name | Size | Volume Type | Bootable | Attached to |
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
| 9a189dac-4519-4509-9581-66bece0dd43e | available | - | 1 | lvmdriver-1 | false | |
| 9a995219-f5e3-4844-8419-5a4e8295b718 | available | - | 1 | lvmdriver-1 | false | |
| d9c04333-f014-4304-be3b-a14fa64586a6 | available | - | 1 | lvmdriver-1 | false | |
| ed1374b5-1002-49b3-ac1b-24fca4a44243 | available | - | 1 | lvmdriver-1 | false | |
| f016b8f7-3ec1-44e3-85c3-e6be1469986b | available | - | 1 | lvmdriver-1 | false | |
+--------------------------------------+-----------+--------------+------+-------------+----------+-------------+
ubuntu@devstack:~$ cinder --os-volume-api-version 2 list
+--------------------------------------+-----------+------+------+-------------+----------+-------------+
| ID | Status | Name | Size | Volume Type | Bootable | Attached to |
+--------------------------------------+-----------+------+------+-------------+----------+-------------+
| 12987522-665e-4047-88ef-b0026c9fbf24 | available | - | 1 | lvmdriver-1 | false | |
| 75c65657-a7f2-4009-8cd7-c8b6e8e0baef | available | - | 1 | lvmdriver-1 | false | |
| 9a189dac-4519-4509-9581-66bece0dd43e | available | - | 1 | lvmdriver-1 | false | |
| 9a995219-f5e3-4844-8419-5a4e8295b718 | available | - | 1 | lvmdriver-1 | false | |
| a9e48724-47fc-4dd0-a053-ed1ba62da767 | available | - | 1 | lvmdriver-1 | false | |
| c2914d18-a5f2-479e-a0a5-5ba69a838489 | available | - | 1 | lvmdriver-1 | false | |
| d9c04333-f014-4304-be3b-a14fa64586a6 | available | - | 1 | lvmdriver-1 | false | |
| ed1374b5-1002-49b3-ac1b-24fca4a44243 | available | - | 1 | lvmdriver-1 | false | |
| eee76bf2-7d7b-4510-b091-397a6a5ea84b | available | - | 1 | lvmdriver-1 | false | |
| f016b8f7-3ec1-44e3-85c3-e6be1469986b | available | - | 1 | lvmdriver-1 | false | |
+--------------------------------------+-----------+------+------+-------------+----------+-------------+
ubuntu@devstack:~$
With Kilo (2015.1.0) this is not reproducible
root@albertom-nuc ~ # cinder --os-volume- api-version 1 list ------- ------- ------- ------- ----+-- ------- --+---- ------- ---+--- ---+--- ------- ---+--- ------- +------ ------- + ------- ------- ------- ------- ----+-- ------- --+---- ------- ---+--- ---+--- ------- ---+--- ------- +------ ------- + 4879-4089- a995-8617d2cbc6 61 | available | vol5 | 1 | None | false | | d9a0-40ca- 8696-880b9b0267 bd | available | vol6 | 1 | None | false | | ac47-4c7c- 9021-91b67bbe49 56 | available | vol7 | 1 | None | false | | 4933-407d- a6b1-ae1a2eac46 e8 | available | vol9 | 1 | None | false | | 0e53-4f8e- 8ef5-6b78e9ad89 6c | available | vol8 | 1 | None | false | | ------- ------- ------- ------- ----+-- ------- --+---- ------- ---+--- ---+--- ------- ---+--- ------- +------ ------- + api-version 2 list ------- ------- ------- ------- ----+-- ------- --+---- --+---- --+---- ------- --+---- ------+ ------- ------+ ------- ------- ------- ------- ----+-- ------- --+---- --+---- --+---- ------- --+---- ------+ ------- ------+ 4879-4089- a995-8617d2cbc6 61 | available | vol5 | 1 | None | false | | d9a0-40ca- 8696-880b9b0267 bd | available | vol6 | 1 | None | false | | ac47-4c7c- 9021-91b67bbe49 56 | available | vol7 | 1 | None | false | | 4933-407d- a6b1-ae1a2eac46 e8 | available | vol9 | 1 | None | false | | 0e53-4f8e- 8ef5-6b78e9ad89 6c | available | vol8 | 1 | None | false | | ------- ------- ------- ------- ----+-- ------- --+---- --+---- --+---- ------- --+---- ------+ ------- ------+ cinder. conf
+------
| ID | Status | Display Name | Size | Volume Type | Bootable | Attached to |
+------
| 2421372f-
| 2ea07099-
| 6eb6fb4c-
| 7013b845-
| cdbd8e47-
+------
root@albertom-nuc ~ # cinder --os-volume-
+------
| ID | Status | Name | Size | Volume Type | Bootable | Attached to |
+------
| 2421372f-
| 2ea07099-
| 6eb6fb4c-
| 7013b845-
| cdbd8e47-
+------
root@albertom-nuc ~ # grep osapi_max /etc/cinder/
osapi_max_limit = 5
root@albertom-nuc ~ # cinder --version
1.1.1
root@albertom-nuc ~ #
Will try later with devstack at ubuntu