diff options
Diffstat (limited to 'src/pybind/mgr/dashboard/openapi.yaml')
| -rw-r--r-- | src/pybind/mgr/dashboard/openapi.yaml | 12723 |
1 files changed, 12723 insertions, 0 deletions
diff --git a/src/pybind/mgr/dashboard/openapi.yaml b/src/pybind/mgr/dashboard/openapi.yaml new file mode 100644 index 000000000..aeb5d9464 --- /dev/null +++ b/src/pybind/mgr/dashboard/openapi.yaml @@ -0,0 +1,12723 @@ +basePath: / +components: + securitySchemes: + jwt: + bearerFormat: JWT + scheme: bearer + type: http +host: example.com +info: + description: This is the official Ceph REST API + title: Ceph REST API + version: v1 +openapi: 3.0.0 +paths: + /api/auth: + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + password: + type: string + username: + type: string + required: + - username + - password + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + tags: + - Auth + /api/auth/check: + post: + parameters: + - description: Authentication Token + in: query + name: token + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + token: + description: Authentication Token + type: string + required: + - token + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + permissions: + description: List of permissions acquired + properties: + cephfs: + description: '' + items: + type: string + type: array + required: + - cephfs + type: object + pwdUpdateRequired: + description: Is password update required? + type: boolean + sso: + description: Uses single sign on? + type: boolean + username: + description: Username + type: string + required: + - username + - permissions + - sso + - pwdUpdateRequired + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + summary: Check token Authentication + tags: + - Auth + /api/auth/logout: + post: + parameters: [] + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + tags: + - Auth + /api/block/image: + get: + parameters: + - allowEmptyValue: true + description: Pool Name + in: query + name: pool_name + schema: + type: string + - default: 0 + description: offset + in: query + name: offset + schema: + type: integer + - default: 5 + description: limit + in: query + name: limit + schema: + type: integer + - default: '' + in: query + name: search + schema: + type: string + - default: '' + in: query + name: sort + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v2.0+json: + schema: + items: + properties: + pool_name: + description: pool name + type: string + value: + description: '' + items: + type: string + type: array + type: object + required: + - value + - pool_name + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Rbd Images + tags: + - Rbd + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + configuration: + type: string + data_pool: + type: string + features: + type: string + metadata: + type: string + mirror_mode: + type: string + name: + type: string + namespace: + type: string + obj_size: + type: integer + pool_name: + type: string + schedule_interval: + default: '' + type: string + size: + type: integer + stripe_count: + type: integer + stripe_unit: + type: string + required: + - name + - pool_name + - size + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/clone_format_version: + get: + description: "Return the RBD clone format version.\n " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/default_features: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/trash: + get: + description: List all entries from trash. + parameters: + - allowEmptyValue: true + description: Name of the pool + in: query + name: pool_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + pool_name: + description: pool name + type: string + status: + description: '' + type: integer + value: + description: '' + items: + type: string + type: array + type: object + required: + - status + - value + - pool_name + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get RBD Trash Details by pool name + tags: + - RbdTrash + /api/block/image/trash/purge: + post: + description: Remove all expired images from trash. + parameters: + - allowEmptyValue: true + in: query + name: pool_name + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + pool_name: + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdTrash + /api/block/image/trash/{image_id_spec}: + delete: + description: "Delete an image from trash.\n If image deferment time has\ + \ not expired you can not removed it unless use force.\n But an actively\ + \ in-use by clones or has snapshots can not be removed.\n " + parameters: + - in: path + name: image_id_spec + required: true + schema: + type: string + - default: false + in: query + name: force + schema: + type: boolean + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdTrash + /api/block/image/trash/{image_id_spec}/restore: + post: + description: Restore an image from trash. + parameters: + - in: path + name: image_id_spec + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + new_image_name: + type: string + required: + - new_image_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdTrash + /api/block/image/{image_spec}: + delete: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + get: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + put: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + configuration: + type: string + enable_mirror: + type: string + features: + type: string + force: + default: false + type: boolean + metadata: + type: string + mirror_mode: + type: string + name: + type: string + primary: + type: string + remove_scheduling: + default: false + type: boolean + resync: + default: false + type: boolean + schedule_interval: + default: '' + type: string + size: + type: integer + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/{image_spec}/copy: + post: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + configuration: + type: string + data_pool: + type: string + dest_image_name: + type: string + dest_namespace: + type: string + dest_pool_name: + type: string + features: + type: string + metadata: + type: string + obj_size: + type: integer + snapshot_name: + type: string + stripe_count: + type: integer + stripe_unit: + type: string + required: + - dest_pool_name + - dest_namespace + - dest_image_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/{image_spec}/flatten: + post: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/{image_spec}/move_trash: + post: + description: "Move an image to the trash.\n Images, even ones actively\ + \ in-use by clones,\n can be moved to the trash and deleted at a later\ + \ time.\n " + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + delay: + default: 0 + type: integer + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Rbd + /api/block/image/{image_spec}/snap: + post: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + mirrorImageSnapshot: + type: string + snapshot_name: + type: string + required: + - snapshot_name + - mirrorImageSnapshot + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdSnapshot + /api/block/image/{image_spec}/snap/{snapshot_name}: + delete: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + - in: path + name: snapshot_name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdSnapshot + put: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + - in: path + name: snapshot_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + is_protected: + type: boolean + new_snap_name: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdSnapshot + /api/block/image/{image_spec}/snap/{snapshot_name}/clone: + post: + description: "\n Clones a snapshot to an image\n " + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + - in: path + name: snapshot_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + child_image_name: + type: string + child_namespace: + type: string + child_pool_name: + type: string + configuration: + type: string + data_pool: + type: string + features: + type: string + metadata: + type: string + obj_size: + type: integer + stripe_count: + type: integer + stripe_unit: + type: string + required: + - child_pool_name + - child_image_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdSnapshot + /api/block/image/{image_spec}/snap/{snapshot_name}/rollback: + post: + parameters: + - in: path + name: image_spec + required: true + schema: + type: string + - in: path + name: snapshot_name + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdSnapshot + /api/block/mirroring/pool/{pool_name}: + get: + parameters: + - description: Pool Name + in: path + name: pool_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + mirror_mode: + description: Mirror Mode + type: string + required: + - mirror_mode + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Rbd Mirroring Summary + tags: + - RbdMirroringPoolMode + put: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + mirror_mode: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolMode + /api/block/mirroring/pool/{pool_name}/bootstrap/peer: + post: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + direction: + type: string + token: + type: string + required: + - direction + - token + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolBootstrap + /api/block/mirroring/pool/{pool_name}/bootstrap/token: + post: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolBootstrap + /api/block/mirroring/pool/{pool_name}/peer: + get: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolPeer + post: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + client_id: + type: string + cluster_name: + type: string + key: + type: string + mon_host: + type: string + required: + - cluster_name + - client_id + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolPeer + /api/block/mirroring/pool/{pool_name}/peer/{peer_uuid}: + delete: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + - in: path + name: peer_uuid + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolPeer + get: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + - in: path + name: peer_uuid + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolPeer + put: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + - in: path + name: peer_uuid + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + client_id: + type: string + cluster_name: + type: string + key: + type: string + mon_host: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroringPoolPeer + /api/block/mirroring/site_name: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + site_name: + description: Site Name + type: string + required: + - site_name + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Rbd Mirroring sitename + tags: + - RbdMirroring + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + site_name: + type: string + required: + - site_name + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdMirroring + /api/block/mirroring/summary: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + content_data: + description: '' + properties: + daemons: + description: '' + items: + type: string + type: array + image_error: + description: '' + items: + type: string + type: array + image_ready: + description: '' + items: + type: string + type: array + image_syncing: + description: '' + items: + type: string + type: array + pools: + description: Pools + items: + properties: + health: + description: pool health + type: string + health_color: + description: '' + type: string + mirror_mode: + description: status + type: string + name: + description: Pool name + type: string + peer_uuids: + description: '' + items: + type: string + type: array + required: + - name + - health_color + - health + - mirror_mode + - peer_uuids + type: object + type: array + required: + - daemons + - pools + - image_error + - image_syncing + - image_ready + type: object + site_name: + description: site name + type: string + status: + description: '' + type: integer + required: + - site_name + - status + - content_data + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Rbd Mirroring Summary + tags: + - RbdMirroringSummary + /api/block/pool/{pool_name}/namespace: + get: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdNamespace + post: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + namespace: + type: string + required: + - namespace + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdNamespace + /api/block/pool/{pool_name}/namespace/{namespace}: + delete: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + - in: path + name: namespace + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RbdNamespace + /api/cephfs: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + name: + type: string + service_spec: + type: string + required: + - name + - service_spec + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/remove/{name}: + delete: + parameters: + - description: File System Name + in: path + name: name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Remove CephFS Volume + tags: + - Cephfs + /api/cephfs/rename: + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + name: + description: Existing FS Name + type: string + new_name: + description: New FS Name + type: string + required: + - name + - new_name + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Rename CephFS Volume + tags: + - Cephfs + /api/cephfs/subvolume: + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + subvol_name: + type: string + vol_name: + type: string + required: + - vol_name + - subvol_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephFSSubvolume + /api/cephfs/subvolume/group: + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + group_name: + type: string + vol_name: + type: string + required: + - vol_name + - group_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephfsSubvolumeGroup + /api/cephfs/subvolume/group/{vol_name}: + delete: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + - in: query + name: group_name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephfsSubvolumeGroup + get: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephfsSubvolumeGroup + put: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + group_name: + type: string + size: + type: integer + required: + - group_name + - size + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephfsSubvolumeGroup + /api/cephfs/subvolume/group/{vol_name}/info: + get: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + - in: query + name: group_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephfsSubvolumeGroup + /api/cephfs/subvolume/{vol_name}: + delete: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + - in: query + name: subvol_name + required: true + schema: + type: string + - default: '' + in: query + name: group_name + schema: + type: string + - default: false + in: query + name: retain_snapshots + schema: + type: boolean + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephFSSubvolume + get: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + - default: '' + in: query + name: group_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephFSSubvolume + put: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + group_name: + default: '' + type: string + size: + type: integer + subvol_name: + type: string + required: + - subvol_name + - size + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephFSSubvolume + /api/cephfs/subvolume/{vol_name}/info: + get: + parameters: + - in: path + name: vol_name + required: true + schema: + type: string + - in: query + name: subvol_name + required: true + schema: + type: string + - default: '' + in: query + name: group_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CephFSSubvolume + /api/cephfs/{fs_id}: + get: + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/client/{client_id}: + delete: + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + - in: path + name: client_id + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/clients: + get: + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/get_root_directory: + get: + description: "\n The root directory that can't be fetched using ls_dir\ + \ (api).\n :param fs_id: The filesystem identifier.\n :return:\ + \ The root directory\n :rtype: dict\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/ls_dir: + get: + description: "\n List directories of specified path.\n :param\ + \ fs_id: The filesystem identifier.\n :param path: The path where to\ + \ start listing the directory content.\n Defaults to '/' if not set.\n\ + \ :type path: str | bytes\n :param depth: The number of steps\ + \ to go down the directory tree.\n :type depth: int | str\n \ + \ :return: The names of the directories below the specified path.\n \ + \ :rtype: list\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: path + schema: + type: string + - default: 1 + in: query + name: depth + schema: + type: integer + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/mds_counters: + get: + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: counters + schema: + type: integer + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/quota: + get: + description: "\n Get the quotas of the specified path.\n :param\ + \ fs_id: The filesystem identifier.\n :param path: The path of the\ + \ directory/file.\n :return: Returns a dictionary containing 'max_bytes'\n\ + \ and 'max_files'.\n :rtype: dict\n " + parameters: + - description: File System Identifier + in: path + name: fs_id + required: true + schema: + type: string + - description: File System Path + in: query + name: path + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + max_bytes: + description: '' + type: integer + max_files: + description: '' + type: integer + required: + - max_bytes + - max_files + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Cephfs Quotas of the specified path + tags: + - Cephfs + put: + description: "\n Set the quotas of the specified path.\n :param\ + \ fs_id: The filesystem identifier.\n :param path: The path of the\ + \ directory/file.\n :param max_bytes: The byte limit.\n :param\ + \ max_files: The file limit.\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + max_bytes: + type: string + max_files: + type: string + path: + type: string + required: + - path + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/snapshot: + delete: + description: "\n Remove a snapshot.\n :param fs_id: The filesystem\ + \ identifier.\n :param path: The path of the directory.\n :param\ + \ name: The name of the snapshot.\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + - in: query + name: path + required: true + schema: + type: string + - in: query + name: name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + post: + description: "\n Create a snapshot.\n :param fs_id: The filesystem\ + \ identifier.\n :param path: The path of the directory.\n :param\ + \ name: The name of the snapshot. If not specified, a name using the\n \ + \ current time in RFC3339 UTC format will be generated.\n :return:\ + \ The name of the snapshot.\n :rtype: str\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + name: + type: string + path: + type: string + required: + - path + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cephfs/{fs_id}/tree: + delete: + description: "\n Remove a directory.\n :param fs_id: The filesystem\ + \ identifier.\n :param path: The path of the directory.\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + - in: query + name: path + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + post: + description: "\n Create a directory.\n :param fs_id: The filesystem\ + \ identifier.\n :param path: The path of the directory.\n " + parameters: + - in: path + name: fs_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + path: + type: string + required: + - path + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Cephfs + /api/cluster: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get the cluster status + tags: + - Cluster + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + status: + description: Cluster Status + type: string + required: + - status + type: object + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Update the cluster status + tags: + - Cluster + /api/cluster/upgrade: + get: + parameters: + - default: false + description: Show all image tags + in: query + name: tags + schema: + type: boolean + - allowEmptyValue: true + description: Ceph Image + in: query + name: image + schema: + type: string + - default: false + description: Show all available versions + in: query + name: show_all_versions + schema: + type: boolean + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get the available versions to upgrade + tags: + - Upgrade + /api/cluster/upgrade/pause: + put: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Pause the cluster upgrade + tags: + - Upgrade + /api/cluster/upgrade/resume: + put: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Resume the cluster upgrade + tags: + - Upgrade + /api/cluster/upgrade/start: + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + daemon_types: + type: string + host_placement: + type: string + image: + type: string + limit: + type: string + services: + type: string + version: + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Start the cluster upgrade + tags: + - Upgrade + /api/cluster/upgrade/status: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get the cluster upgrade status + tags: + - Upgrade + /api/cluster/upgrade/stop: + put: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Stop the cluster upgrade + tags: + - Upgrade + /api/cluster/user: + get: + description: "\n Get list of ceph users and its respective data\n \ + \ " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Ceph Users + tags: + - Cluster + post: + description: "\n Add a ceph user with its defined capabilities.\n \ + \ :param user_entity: Entity to change\n :param capabilities: List\ + \ of capabilities to add to user_entity\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + capabilities: + type: string + import_data: + default: '' + type: string + user_entity: + default: '' + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Create Ceph User + tags: + - Cluster + put: + description: "\n Change the ceph user capabilities.\n Setting\ + \ new capabilities will overwrite current ones.\n :param user_entity:\ + \ Entity to change\n :param capabilities: List of updated capabilities\ + \ to user_entity\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + capabilities: + type: string + user_entity: + default: '' + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Edit Ceph User + tags: + - Cluster + /api/cluster/user/export: + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + entities: + type: string + required: + - entities + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Export Ceph Users + tags: + - Cluster + /api/cluster/user/{user_entity}: + delete: + description: "\n Delete a ceph user and it's defined capabilities.\n\ + \ :param user_entity: Entity to delete\n " + parameters: + - in: path + name: user_entity + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Delete Ceph User + tags: + - Cluster + /api/cluster_conf: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ClusterConfiguration + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + name: + type: string + value: + type: string + required: + - name + - value + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ClusterConfiguration + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + options: + type: string + required: + - options + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ClusterConfiguration + /api/cluster_conf/filter: + get: + parameters: + - allowEmptyValue: true + description: Config option names + in: query + name: names + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + can_update_at_runtime: + description: Check if can update at runtime + type: boolean + daemon_default: + description: Daemon specific default value + type: string + default: + description: Default value for the config option + type: string + desc: + description: Description of the configuration + type: string + enum_values: + description: List of enums allowed + items: + type: string + type: array + flags: + description: List of flags associated + items: + type: string + type: array + level: + description: Config option level + type: string + long_desc: + description: Elaborated description + type: string + max: + description: Maximum value + type: string + min: + description: Minimum value + type: string + name: + description: Name of the config option + type: string + see_also: + description: Related config options + items: + type: string + type: array + services: + description: Services associated with the config option + items: + type: string + type: array + tags: + description: Tags associated with the cluster + items: + type: string + type: array + type: + description: Config option type + type: string + type: object + required: + - name + - type + - level + - desc + - long_desc + - default + - daemon_default + - tags + - services + - see_also + - enum_values + - min + - max + - can_update_at_runtime + - flags + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Cluster Configuration by name + tags: + - ClusterConfiguration + /api/cluster_conf/{name}: + delete: + parameters: + - in: path + name: name + required: true + schema: + type: string + - in: query + name: section + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ClusterConfiguration + get: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ClusterConfiguration + /api/crush_rule: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v2.0+json: + schema: + properties: + max_size: + description: Maximum size of Rule + type: integer + min_size: + description: Minimum size of Rule + type: integer + rule_id: + description: Rule ID + type: integer + rule_name: + description: Rule Name + type: string + ruleset: + description: RuleSet related to the rule + type: integer + steps: + description: Steps included in the rule + items: + type: object + type: array + type: + description: Type of Rule + type: integer + required: + - rule_id + - rule_name + - ruleset + - type + - min_size + - max_size + - steps + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List Crush Rule Configuration + tags: + - CrushRule + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + device_class: + type: string + failure_domain: + type: string + name: + type: string + root: + type: string + required: + - name + - root + - failure_domain + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CrushRule + /api/crush_rule/{name}: + delete: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CrushRule + get: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v2.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - CrushRule + /api/daemon: + get: + description: "List all daemons in the cluster. Also filter by the daemon types\ + \ specified\n\n :param daemon_types: List of daemon types to filter\ + \ by.\n :return: Returns list of daemons.\n :rtype: list\n \ + \ " + parameters: + - allowEmptyValue: true + in: query + name: daemon_types + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Daemon + /api/daemon/{daemon_name}: + put: + parameters: + - in: path + name: daemon_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + action: + default: '' + type: string + container_image: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Daemon + /api/erasure_code_profile: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + crush-failure-domain: + description: '' + type: string + k: + description: Number of data chunks + type: integer + m: + description: Number of coding chunks + type: integer + name: + description: Name of the profile + type: string + plugin: + description: Plugin Info + type: string + technique: + description: '' + type: string + type: object + required: + - crush-failure-domain + - k + - m + - plugin + - technique + - name + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List Erasure Code Profile Information + tags: + - ErasureCodeProfile + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + name: + type: string + required: + - name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ErasureCodeProfile + /api/erasure_code_profile/{name}: + delete: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ErasureCodeProfile + get: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - ErasureCodeProfile + /api/feature_toggles: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + cephfs: + description: '' + type: boolean + dashboard: + description: '' + type: boolean + iscsi: + description: '' + type: boolean + mirroring: + description: '' + type: boolean + nfs: + description: '' + type: boolean + rbd: + description: '' + type: boolean + rgw: + description: '' + type: boolean + required: + - rbd + - mirroring + - iscsi + - cephfs + - rgw + - nfs + - dashboard + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get List Of Features + tags: + - FeatureTogglesEndpoint + /api/feedback: + get: + description: "\n List all issues details.\n " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Report + post: + description: "\n Create an issue.\n :param project: The affected\ + \ ceph component.\n :param tracker: The tracker type.\n :param\ + \ subject: The title of the issue.\n :param description: The description\ + \ of the issue.\n :param api_key: Ceph tracker api key.\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + api_key: + type: string + description: + type: string + project: + type: string + subject: + type: string + tracker: + type: string + required: + - project + - tracker + - subject + - description + type: object + responses: + '201': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Report + /api/feedback/api_key: + delete: + description: "\n Deletes Ceph tracker API key.\n " + parameters: [] + responses: + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Report + get: + description: "\n Returns Ceph tracker API key.\n " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Report + post: + description: "\n Sets Ceph tracker API key.\n :param api_key:\ + \ The Ceph tracker API key.\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + api_key: + type: string + required: + - api_key + type: object + responses: + '201': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Report + /api/grafana/dashboards: + post: + parameters: [] + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Grafana + /api/grafana/url: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + instance: + description: grafana instance + type: string + required: + - instance + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List Grafana URL Instance + tags: + - Grafana + /api/grafana/validation/{params}: + get: + parameters: + - in: path + name: params + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Grafana + /api/health/full: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Health + /api/health/get_cluster_capacity: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Health + /api/health/get_cluster_fsid: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Health + /api/health/minimal: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + client_perf: + description: '' + properties: + read_bytes_sec: + description: '' + type: integer + read_op_per_sec: + description: '' + type: integer + recovering_bytes_per_sec: + description: '' + type: integer + write_bytes_sec: + description: '' + type: integer + write_op_per_sec: + description: '' + type: integer + required: + - read_bytes_sec + - read_op_per_sec + - recovering_bytes_per_sec + - write_bytes_sec + - write_op_per_sec + type: object + df: + description: '' + properties: + stats: + description: '' + properties: + total_avail_bytes: + description: '' + type: integer + total_bytes: + description: '' + type: integer + total_used_raw_bytes: + description: '' + type: integer + required: + - total_avail_bytes + - total_bytes + - total_used_raw_bytes + type: object + required: + - stats + type: object + fs_map: + description: '' + properties: + filesystems: + description: '' + items: + properties: + mdsmap: + description: '' + properties: + balancer: + description: '' + type: string + compat: + description: '' + properties: + compat: + description: '' + type: string + incompat: + description: '' + type: string + ro_compat: + description: '' + type: string + required: + - compat + - ro_compat + - incompat + type: object + created: + description: '' + type: string + damaged: + description: '' + items: + type: integer + type: array + data_pools: + description: '' + items: + type: integer + type: array + enabled: + description: '' + type: boolean + epoch: + description: '' + type: integer + ever_allowed_features: + description: '' + type: integer + explicitly_allowed_features: + description: '' + type: integer + failed: + description: '' + items: + type: integer + type: array + flags: + description: '' + type: integer + fs_name: + description: '' + type: string + in: + description: '' + items: + type: integer + type: array + info: + description: '' + type: string + last_failure: + description: '' + type: integer + last_failure_osd_epoch: + description: '' + type: integer + max_file_size: + description: '' + type: integer + max_mds: + description: '' + type: integer + metadata_pool: + description: '' + type: integer + modified: + description: '' + type: string + required_client_features: + description: '' + type: string + root: + description: '' + type: integer + session_autoclose: + description: '' + type: integer + session_timeout: + description: '' + type: integer + standby_count_wanted: + description: '' + type: integer + stopped: + description: '' + items: + type: integer + type: array + tableserver: + description: '' + type: integer + up: + description: '' + type: string + required: + - session_autoclose + - balancer + - up + - last_failure_osd_epoch + - in + - last_failure + - max_file_size + - explicitly_allowed_features + - damaged + - tableserver + - failed + - metadata_pool + - epoch + - stopped + - max_mds + - compat + - required_client_features + - data_pools + - info + - fs_name + - created + - standby_count_wanted + - enabled + - modified + - session_timeout + - flags + - ever_allowed_features + - root + type: object + standbys: + description: '' + type: string + required: + - mdsmap + - standbys + type: object + type: array + required: + - filesystems + type: object + health: + description: '' + properties: + checks: + description: '' + type: string + mutes: + description: '' + type: string + status: + description: '' + type: string + required: + - checks + - mutes + - status + type: object + hosts: + description: '' + type: integer + iscsi_daemons: + description: '' + properties: + down: + description: '' + type: integer + up: + description: '' + type: integer + required: + - up + - down + type: object + mgr_map: + description: '' + properties: + active_name: + description: '' + type: string + standbys: + description: '' + type: string + required: + - active_name + - standbys + type: object + mon_status: + description: '' + properties: + monmap: + description: '' + properties: + mons: + description: '' + type: string + required: + - mons + type: object + quorum: + description: '' + items: + type: integer + type: array + required: + - monmap + - quorum + type: object + osd_map: + description: '' + properties: + osds: + description: '' + items: + properties: + in: + description: '' + type: integer + up: + description: '' + type: integer + required: + - in + - up + type: object + type: array + required: + - osds + type: object + pg_info: + description: '' + properties: + object_stats: + description: '' + properties: + num_object_copies: + description: '' + type: integer + num_objects: + description: '' + type: integer + num_objects_degraded: + description: '' + type: integer + num_objects_misplaced: + description: '' + type: integer + num_objects_unfound: + description: '' + type: integer + required: + - num_objects + - num_object_copies + - num_objects_degraded + - num_objects_misplaced + - num_objects_unfound + type: object + pgs_per_osd: + description: '' + type: integer + statuses: + description: '' + type: string + required: + - object_stats + - pgs_per_osd + - statuses + type: object + pools: + description: '' + type: string + rgw: + description: '' + type: integer + scrub_status: + description: '' + type: string + required: + - client_perf + - df + - fs_map + - health + - hosts + - iscsi_daemons + - mgr_map + - mon_status + - osd_map + - pg_info + - pools + - rgw + - scrub_status + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Cluster's minimal health report + tags: + - Health + /api/host: + get: + parameters: + - allowEmptyValue: true + description: Host Sources + in: query + name: sources + schema: + type: string + - default: false + description: Host Facts + in: query + name: facts + schema: + type: boolean + - default: 0 + in: query + name: offset + schema: + type: integer + - default: 5 + in: query + name: limit + schema: + type: integer + - default: '' + in: query + name: search + schema: + type: string + - default: '' + in: query + name: sort + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.3+json: + schema: + properties: + addr: + description: Host address + type: string + ceph_version: + description: Ceph version + type: string + hostname: + description: Hostname + type: string + labels: + description: Labels related to the host + items: + type: string + type: array + service_instances: + description: Service instances related to the host + items: + properties: + count: + description: Number of instances of the service + type: integer + type: + description: type of service + type: string + required: + - type + - count + type: object + type: array + service_type: + description: '' + type: string + services: + description: Services related to the host + items: + properties: + id: + description: Service Id + type: string + type: + description: type of service + type: string + required: + - type + - id + type: object + type: array + sources: + description: Host Sources + properties: + ceph: + description: '' + type: boolean + orchestrator: + description: '' + type: boolean + required: + - ceph + - orchestrator + type: object + status: + description: '' + type: string + required: + - hostname + - services + - service_instances + - ceph_version + - addr + - labels + - service_type + - sources + - status + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List Host Specifications + tags: + - Host + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + addr: + description: Network Address + type: string + hostname: + description: Hostname + type: string + labels: + description: Host Labels + items: + type: string + type: array + status: + description: Host Status + type: string + required: + - hostname + type: object + responses: + '201': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + /api/host/{hostname}: + delete: + parameters: + - in: path + name: hostname + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + get: + description: "\n Get the specified host.\n :raises: cherrypy.HTTPError:\ + \ If host not found.\n " + parameters: + - in: path + name: hostname + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.2+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + put: + description: "\n Update the specified host.\n Note, this is only\ + \ supported when Ceph Orchestrator is enabled.\n :param hostname: The\ + \ name of the host to be processed.\n :param update_labels: To update\ + \ the labels.\n :param labels: List of labels.\n :param maintenance:\ + \ Enter/Exit maintenance mode.\n :param force: Force enter maintenance\ + \ mode.\n :param drain: Drain host\n " + parameters: + - description: Hostname + in: path + name: hostname + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + drain: + default: false + description: Drain Host + type: boolean + force: + default: false + description: Force Enter Maintenance + type: boolean + labels: + description: Host Labels + items: + type: string + type: array + maintenance: + default: false + description: Enter/Exit Maintenance + type: boolean + update_labels: + default: false + description: Update Labels + type: boolean + type: object + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + schema: + properties: {} + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + /api/host/{hostname}/daemons: + get: + parameters: + - in: path + name: hostname + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + /api/host/{hostname}/devices: + get: + parameters: + - in: path + name: hostname + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + /api/host/{hostname}/identify_device: + post: + description: "\n Identify a device by switching on the device light for\ + \ N seconds.\n :param hostname: The hostname of the device to process.\n\ + \ :param device: The device identifier to process, e.g. ``/dev/dm-0``\ + \ or\n ``ABC1234DEF567-1R1234_ABC8DE0Q``.\n :param duration:\ + \ The duration in seconds how long the LED should flash.\n " + parameters: + - in: path + name: hostname + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + device: + type: string + duration: + type: string + required: + - device + - duration + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + /api/host/{hostname}/inventory: + get: + parameters: + - description: Hostname + in: path + name: hostname + required: true + schema: + type: string + - allowEmptyValue: true + description: Trigger asynchronous refresh + in: query + name: refresh + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + addr: + description: Host address + type: string + devices: + description: Host devices + items: + properties: + available: + description: If the device can be provisioned to an OSD + type: boolean + device_id: + description: Device's udev ID + type: string + human_readable_type: + description: Device type. ssd or hdd + type: string + lsm_data: + description: '' + properties: + errors: + description: '' + items: + type: string + type: array + health: + description: '' + type: string + ledSupport: + description: '' + properties: + FAILstatus: + description: '' + type: string + FAILsupport: + description: '' + type: string + IDENTstatus: + description: '' + type: string + IDENTsupport: + description: '' + type: string + required: + - IDENTsupport + - IDENTstatus + - FAILsupport + - FAILstatus + type: object + linkSpeed: + description: '' + type: string + mediaType: + description: '' + type: string + rpm: + description: '' + type: string + serialNum: + description: '' + type: string + transport: + description: '' + type: string + required: + - serialNum + - transport + - mediaType + - rpm + - linkSpeed + - health + - ledSupport + - errors + type: object + lvs: + description: '' + items: + properties: + block_uuid: + description: '' + type: string + cluster_fsid: + description: '' + type: string + cluster_name: + description: '' + type: string + name: + description: '' + type: string + osd_fsid: + description: '' + type: string + osd_id: + description: '' + type: string + osdspec_affinity: + description: '' + type: string + type: + description: '' + type: string + required: + - name + - osd_id + - cluster_name + - type + - osd_fsid + - cluster_fsid + - osdspec_affinity + - block_uuid + type: object + type: array + osd_ids: + description: Device OSD IDs + items: + type: integer + type: array + path: + description: Device path + type: string + rejected_reasons: + description: '' + items: + type: string + type: array + sys_api: + description: '' + properties: + human_readable_size: + description: '' + type: string + locked: + description: '' + type: integer + model: + description: '' + type: string + nr_requests: + description: '' + type: string + partitions: + description: '' + properties: + partition_name: + description: '' + properties: + holders: + description: '' + items: + type: string + type: array + human_readable_size: + description: '' + type: string + sectors: + description: '' + type: string + sectorsize: + description: '' + type: integer + size: + description: '' + type: integer + start: + description: '' + type: string + required: + - start + - sectors + - sectorsize + - size + - human_readable_size + - holders + type: object + required: + - partition_name + type: object + path: + description: '' + type: string + removable: + description: '' + type: string + rev: + description: '' + type: string + ro: + description: '' + type: string + rotational: + description: '' + type: string + sas_address: + description: '' + type: string + sas_device_handle: + description: '' + type: string + scheduler_mode: + description: '' + type: string + sectors: + description: '' + type: integer + sectorsize: + description: '' + type: string + size: + description: '' + type: integer + support_discard: + description: '' + type: string + vendor: + description: '' + type: string + required: + - removable + - ro + - vendor + - model + - rev + - sas_address + - sas_device_handle + - support_discard + - rotational + - nr_requests + - scheduler_mode + - partitions + - sectors + - sectorsize + - size + - human_readable_size + - path + - locked + type: object + required: + - rejected_reasons + - available + - path + - sys_api + - lvs + - human_readable_type + - device_id + - lsm_data + - osd_ids + type: object + type: array + labels: + description: Host labels + items: + type: string + type: array + name: + description: Hostname + type: string + required: + - name + - addr + - devices + - labels + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get inventory of a host + tags: + - Host + /api/host/{hostname}/smart: + get: + parameters: + - in: path + name: hostname + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Host + /api/iscsi/discoveryauth: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + mutual_password: + description: '' + type: string + mutual_user: + description: '' + type: string + password: + description: password + type: string + user: + description: username + type: string + type: object + required: + - user + - password + - mutual_user + - mutual_password + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Iscsi discoveryauth Details + tags: + - Iscsi + put: + parameters: + - description: Username + in: query + name: user + required: true + schema: + type: string + - description: Password + in: query + name: password + required: true + schema: + type: string + - description: Mutual UserName + in: query + name: mutual_user + required: true + schema: + type: string + - description: Mutual Password + in: query + name: mutual_password + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + mutual_password: + description: Mutual Password + type: string + mutual_user: + description: Mutual UserName + type: string + password: + description: Password + type: string + user: + description: Username + type: string + required: + - user + - password + - mutual_user + - mutual_password + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Set Iscsi discoveryauth + tags: + - Iscsi + /api/iscsi/target: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - IscsiTarget + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + acl_enabled: + type: string + auth: + type: string + clients: + type: string + disks: + type: string + groups: + type: string + portals: + type: string + target_controls: + type: string + target_iqn: + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - IscsiTarget + /api/iscsi/target/{target_iqn}: + delete: + parameters: + - in: path + name: target_iqn + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - IscsiTarget + get: + parameters: + - in: path + name: target_iqn + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - IscsiTarget + put: + parameters: + - in: path + name: target_iqn + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + acl_enabled: + type: string + auth: + type: string + clients: + type: string + disks: + type: string + groups: + type: string + new_target_iqn: + type: string + portals: + type: string + target_controls: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - IscsiTarget + /api/logs/all: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + audit_log: + description: Audit log + items: + properties: + addrs: + description: '' + properties: + addrvec: + description: '' + items: + properties: + addr: + description: IP Address + type: string + nonce: + description: '' + type: integer + type: + description: '' + type: string + required: + - type + - addr + - nonce + type: object + type: array + required: + - addrvec + type: object + channel: + description: '' + type: string + message: + description: '' + type: string + name: + description: '' + type: string + priority: + description: '' + type: string + rank: + description: '' + type: string + seq: + description: '' + type: integer + stamp: + description: '' + type: string + required: + - name + - rank + - addrs + - stamp + - seq + - channel + - priority + - message + type: object + type: array + clog: + description: '' + items: + type: string + type: array + required: + - clog + - audit_log + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Logs Configuration + tags: + - Logs + /api/mgr/module: + get: + description: "\n Get the list of managed modules.\n :return: A\ + \ list of objects with the fields 'enabled', 'name' and 'options'.\n \ + \ :rtype: list\n " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + always_on: + description: Is it an always on module? + type: boolean + enabled: + description: Is Module Enabled + type: boolean + name: + description: Module Name + type: string + options: + description: Module Options + properties: + Option_name: + description: Options + properties: + default_value: + description: Default value for the option + type: integer + desc: + description: Description of the option + type: string + enum_allowed: + description: '' + items: + type: string + type: array + flags: + description: List of flags associated + type: integer + level: + description: Option level + type: string + long_desc: + description: Elaborated description + type: string + max: + description: Maximum value + type: string + min: + description: Minimum value + type: string + name: + description: Name of the option + type: string + see_also: + description: Related options + items: + type: string + type: array + tags: + description: Tags associated with the option + items: + type: string + type: array + type: + description: Type of the option + type: string + required: + - name + - type + - level + - flags + - default_value + - min + - max + - enum_allowed + - desc + - long_desc + - tags + - see_also + type: object + required: + - Option_name + type: object + type: object + required: + - name + - enabled + - always_on + - options + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List Mgr modules + tags: + - MgrModule + /api/mgr/module/{module_name}: + get: + description: "\n Retrieve the values of the persistent configuration\ + \ settings.\n :param module_name: The name of the Ceph Mgr module.\n\ + \ :type module_name: str\n :return: The values of the module\ + \ options.\n :rtype: dict\n " + parameters: + - in: path + name: module_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MgrModule + put: + description: "\n Set the values of the persistent configuration settings.\n\ + \ :param module_name: The name of the Ceph Mgr module.\n :type\ + \ module_name: str\n :param config: The values of the module options\ + \ to be stored.\n :type config: dict\n " + parameters: + - in: path + name: module_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + config: + type: string + required: + - config + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MgrModule + /api/mgr/module/{module_name}/disable: + post: + description: "\n Disable the specified Ceph Mgr module.\n :param\ + \ module_name: The name of the Ceph Mgr module.\n :type module_name:\ + \ str\n " + parameters: + - in: path + name: module_name + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MgrModule + /api/mgr/module/{module_name}/enable: + post: + description: "\n Enable the specified Ceph Mgr module.\n :param\ + \ module_name: The name of the Ceph Mgr module.\n :type module_name:\ + \ str\n " + parameters: + - in: path + name: module_name + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MgrModule + /api/mgr/module/{module_name}/options: + get: + description: "\n Get the module options of the specified Ceph Mgr module.\n\ + \ :param module_name: The name of the Ceph Mgr module.\n :type\ + \ module_name: str\n :return: The module options as list of dicts.\n\ + \ :rtype: list\n " + parameters: + - in: path + name: module_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MgrModule + /api/monitor: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + in_quorum: + description: '' + items: + properties: + addr: + description: '' + type: string + name: + description: '' + type: string + priority: + description: '' + type: integer + public_addr: + description: '' + type: string + public_addrs: + description: '' + properties: + addrvec: + description: '' + items: + properties: + addr: + description: '' + type: string + nonce: + description: '' + type: integer + type: + description: '' + type: string + required: + - type + - addr + - nonce + type: object + type: array + required: + - addrvec + type: object + rank: + description: '' + type: integer + stats: + description: '' + properties: + num_sessions: + description: '' + items: + type: integer + type: array + required: + - num_sessions + type: object + weight: + description: '' + type: integer + required: + - rank + - name + - public_addrs + - addr + - public_addr + - priority + - weight + - stats + type: object + type: array + mon_status: + description: '' + properties: + election_epoch: + description: '' + type: integer + extra_probe_peers: + description: '' + items: + type: string + type: array + feature_map: + description: '' + properties: + client: + description: '' + items: + properties: + features: + description: '' + type: string + num: + description: '' + type: integer + release: + description: '' + type: string + required: + - features + - release + - num + type: object + type: array + mds: + description: '' + items: + properties: + features: + description: '' + type: string + num: + description: '' + type: integer + release: + description: '' + type: string + required: + - features + - release + - num + type: object + type: array + mgr: + description: '' + items: + properties: + features: + description: '' + type: string + num: + description: '' + type: integer + release: + description: '' + type: string + required: + - features + - release + - num + type: object + type: array + mon: + description: '' + items: + properties: + features: + description: '' + type: string + num: + description: '' + type: integer + release: + description: '' + type: string + required: + - features + - release + - num + type: object + type: array + required: + - mon + - mds + - client + - mgr + type: object + features: + description: '' + properties: + quorum_con: + description: '' + type: string + quorum_mon: + description: '' + items: + type: string + type: array + required_con: + description: '' + type: string + required_mon: + description: '' + items: + type: integer + type: array + required: + - required_con + - required_mon + - quorum_con + - quorum_mon + type: object + monmap: + description: '' + properties: + created: + description: '' + type: string + epoch: + description: '' + type: integer + features: + description: '' + properties: + optional: + description: '' + items: + type: string + type: array + persistent: + description: '' + items: + type: string + type: array + required: + - persistent + - optional + type: object + fsid: + description: '' + type: string + min_mon_release: + description: '' + type: integer + min_mon_release_name: + description: '' + type: string + modified: + description: '' + type: string + mons: + description: '' + items: + properties: + addr: + description: '' + type: string + name: + description: '' + type: string + priority: + description: '' + type: integer + public_addr: + description: '' + type: string + public_addrs: + description: '' + properties: + addrvec: + description: '' + items: + properties: + addr: + description: '' + type: string + nonce: + description: '' + type: integer + type: + description: '' + type: string + required: + - type + - addr + - nonce + type: object + type: array + required: + - addrvec + type: object + rank: + description: '' + type: integer + stats: + description: '' + properties: + num_sessions: + description: '' + items: + type: integer + type: array + required: + - num_sessions + type: object + weight: + description: '' + type: integer + required: + - rank + - name + - public_addrs + - addr + - public_addr + - priority + - weight + - stats + type: object + type: array + required: + - epoch + - fsid + - modified + - created + - min_mon_release + - min_mon_release_name + - features + - mons + type: object + name: + description: '' + type: string + outside_quorum: + description: '' + items: + type: string + type: array + quorum: + description: '' + items: + type: integer + type: array + quorum_age: + description: '' + type: integer + rank: + description: '' + type: integer + state: + description: '' + type: string + sync_provider: + description: '' + items: + type: string + type: array + required: + - name + - rank + - state + - election_epoch + - quorum + - quorum_age + - features + - outside_quorum + - extra_probe_peers + - sync_provider + - monmap + - feature_map + type: object + out_quorum: + description: '' + items: + type: integer + type: array + required: + - mon_status + - in_quorum + - out_quorum + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Monitor Details + tags: + - Monitor + /api/nfs-ganesha/cluster: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - NFS-Ganesha + /api/nfs-ganesha/export: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + access_type: + description: Export access type + type: string + clients: + description: List of client configurations + items: + properties: + access_type: + description: Client access type + type: string + addresses: + description: list of IP addresses + items: + type: string + type: array + squash: + description: Client squash policy + type: string + required: + - addresses + - access_type + - squash + type: object + type: array + cluster_id: + description: Cluster identifier + type: string + export_id: + description: Export ID + type: integer + fsal: + description: FSAL configuration + properties: + fs_name: + description: CephFS filesystem name + type: string + name: + description: name of FSAL + type: string + sec_label_xattr: + description: Name of xattr for security label + type: string + user_id: + description: User id + type: string + required: + - name + type: object + path: + description: Export path + type: string + protocols: + description: List of protocol types + items: + type: integer + type: array + pseudo: + description: Pseudo FS path + type: string + security_label: + description: Security label + type: string + squash: + description: Export squash policy + type: string + transports: + description: List of transport types + items: + type: string + type: array + type: object + required: + - export_id + - path + - cluster_id + - pseudo + - access_type + - squash + - security_label + - protocols + - transports + - fsal + - clients + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List all NFS-Ganesha exports + tags: + - NFS-Ganesha + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + access_type: + description: Export access type + type: string + clients: + description: List of client configurations + items: + properties: + access_type: + description: Client access type + type: string + addresses: + description: list of IP addresses + items: + type: string + type: array + squash: + description: Client squash policy + type: string + required: + - addresses + - access_type + - squash + type: object + type: array + cluster_id: + description: Cluster identifier + type: string + fsal: + description: FSAL configuration + properties: + fs_name: + description: CephFS filesystem name + type: string + name: + description: name of FSAL + type: string + sec_label_xattr: + description: Name of xattr for security label + type: string + required: + - name + type: object + path: + description: Export path + type: string + protocols: + description: List of protocol types + items: + type: integer + type: array + pseudo: + description: Pseudo FS path + type: string + security_label: + description: Security label + type: string + squash: + description: Export squash policy + type: string + transports: + description: List of transport types + items: + type: string + type: array + required: + - path + - cluster_id + - pseudo + - access_type + - squash + - security_label + - protocols + - transports + - fsal + - clients + type: object + responses: + '201': + content: + application/vnd.ceph.api.v2.0+json: + schema: + properties: + access_type: + description: Export access type + type: string + clients: + description: List of client configurations + items: + properties: + access_type: + description: Client access type + type: string + addresses: + description: list of IP addresses + items: + type: string + type: array + squash: + description: Client squash policy + type: string + required: + - addresses + - access_type + - squash + type: object + type: array + cluster_id: + description: Cluster identifier + type: string + export_id: + description: Export ID + type: integer + fsal: + description: FSAL configuration + properties: + fs_name: + description: CephFS filesystem name + type: string + name: + description: name of FSAL + type: string + sec_label_xattr: + description: Name of xattr for security label + type: string + user_id: + description: User id + type: string + required: + - name + type: object + path: + description: Export path + type: string + protocols: + description: List of protocol types + items: + type: integer + type: array + pseudo: + description: Pseudo FS path + type: string + security_label: + description: Security label + type: string + squash: + description: Export squash policy + type: string + transports: + description: List of transport types + items: + type: string + type: array + required: + - export_id + - path + - cluster_id + - pseudo + - access_type + - squash + - security_label + - protocols + - transports + - fsal + - clients + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v2.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Creates a new NFS-Ganesha export + tags: + - NFS-Ganesha + /api/nfs-ganesha/export/{cluster_id}/{export_id}: + delete: + parameters: + - description: Cluster identifier + in: path + name: cluster_id + required: true + schema: + type: string + - description: Export ID + in: path + name: export_id + required: true + schema: + type: integer + responses: + '202': + content: + application/vnd.ceph.api.v2.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v2.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Deletes an NFS-Ganesha export + tags: + - NFS-Ganesha + get: + parameters: + - description: Cluster identifier + in: path + name: cluster_id + required: true + schema: + type: string + - description: Export ID + in: path + name: export_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + access_type: + description: Export access type + type: string + clients: + description: List of client configurations + items: + properties: + access_type: + description: Client access type + type: string + addresses: + description: list of IP addresses + items: + type: string + type: array + squash: + description: Client squash policy + type: string + required: + - addresses + - access_type + - squash + type: object + type: array + cluster_id: + description: Cluster identifier + type: string + export_id: + description: Export ID + type: integer + fsal: + description: FSAL configuration + properties: + fs_name: + description: CephFS filesystem name + type: string + name: + description: name of FSAL + type: string + sec_label_xattr: + description: Name of xattr for security label + type: string + user_id: + description: User id + type: string + required: + - name + type: object + path: + description: Export path + type: string + protocols: + description: List of protocol types + items: + type: integer + type: array + pseudo: + description: Pseudo FS path + type: string + security_label: + description: Security label + type: string + squash: + description: Export squash policy + type: string + transports: + description: List of transport types + items: + type: string + type: array + required: + - export_id + - path + - cluster_id + - pseudo + - access_type + - squash + - security_label + - protocols + - transports + - fsal + - clients + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get an NFS-Ganesha export + tags: + - NFS-Ganesha + put: + parameters: + - description: Cluster identifier + in: path + name: cluster_id + required: true + schema: + type: string + - description: Export ID + in: path + name: export_id + required: true + schema: + type: integer + requestBody: + content: + application/json: + schema: + properties: + access_type: + description: Export access type + type: string + clients: + description: List of client configurations + items: + properties: + access_type: + description: Client access type + type: string + addresses: + description: list of IP addresses + items: + type: string + type: array + squash: + description: Client squash policy + type: string + required: + - addresses + - access_type + - squash + type: object + type: array + fsal: + description: FSAL configuration + properties: + fs_name: + description: CephFS filesystem name + type: string + name: + description: name of FSAL + type: string + sec_label_xattr: + description: Name of xattr for security label + type: string + required: + - name + type: object + path: + description: Export path + type: string + protocols: + description: List of protocol types + items: + type: integer + type: array + pseudo: + description: Pseudo FS path + type: string + security_label: + description: Security label + type: string + squash: + description: Export squash policy + type: string + transports: + description: List of transport types + items: + type: string + type: array + required: + - path + - pseudo + - access_type + - squash + - security_label + - protocols + - transports + - fsal + - clients + type: object + responses: + '200': + content: + application/vnd.ceph.api.v2.0+json: + schema: + properties: + access_type: + description: Export access type + type: string + clients: + description: List of client configurations + items: + properties: + access_type: + description: Client access type + type: string + addresses: + description: list of IP addresses + items: + type: string + type: array + squash: + description: Client squash policy + type: string + required: + - addresses + - access_type + - squash + type: object + type: array + cluster_id: + description: Cluster identifier + type: string + export_id: + description: Export ID + type: integer + fsal: + description: FSAL configuration + properties: + fs_name: + description: CephFS filesystem name + type: string + name: + description: name of FSAL + type: string + sec_label_xattr: + description: Name of xattr for security label + type: string + user_id: + description: User id + type: string + required: + - name + type: object + path: + description: Export path + type: string + protocols: + description: List of protocol types + items: + type: integer + type: array + pseudo: + description: Pseudo FS path + type: string + security_label: + description: Security label + type: string + squash: + description: Export squash policy + type: string + transports: + description: List of transport types + items: + type: string + type: array + required: + - export_id + - path + - cluster_id + - pseudo + - access_type + - squash + - security_label + - protocols + - transports + - fsal + - clients + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v2.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Updates an NFS-Ganesha export + tags: + - NFS-Ganesha + /api/osd: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + data: + type: string + method: + type: string + tracking_id: + type: string + required: + - method + - data + - tracking_id + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/flags: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + list_of_flags: + description: '' + items: + type: string + type: array + required: + - list_of_flags + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display OSD Flags + tags: + - OSD + put: + description: "\n The `recovery_deletes`, `sortbitwise` and `pglog_hardlimit`\ + \ flags cannot be unset.\n `purged_snapshots` cannot even be set. It\ + \ is therefore required to at\n least include those four flags for\ + \ a successful operation.\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + flags: + description: List of flags to set. The flags `recovery_deletes`, + `sortbitwise` and `pglog_hardlimit` cannot be unset. Additionally + `purged_snapshots` cannot even be set. + items: + type: string + type: array + required: + - flags + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + list_of_flags: + description: '' + items: + type: string + type: array + required: + - list_of_flags + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Sets OSD flags for the entire cluster. + tags: + - OSD + /api/osd/flags/individual: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + flags: + description: List of active flags + items: + type: string + type: array + osd: + description: OSD ID + type: integer + required: + - osd + - flags + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Displays individual OSD flags + tags: + - OSD + put: + description: "\n Updates flags (`noout`, `noin`, `nodown`, `noup`) for\ + \ an individual\n subset of OSDs.\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + flags: + description: Directory of flags to set or unset. The flags `noin`, + `noout`, `noup` and `nodown` are going to be considered only. + properties: + nodown: + description: Sets/unsets `nodown` + type: boolean + noin: + description: Sets/unsets `noin` + type: boolean + noout: + description: Sets/unsets `noout` + type: boolean + noup: + description: Sets/unsets `noup` + type: boolean + type: object + ids: + description: List of OSD ids the flags should be applied to. + items: + type: integer + type: array + required: + - flags + - ids + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + added: + description: List of added flags + items: + type: string + type: array + ids: + description: List of updated OSDs + items: + type: integer + type: array + removed: + description: List of removed flags + items: + type: string + type: array + required: + - added + - removed + - ids + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Sets OSD flags for a subset of individual OSDs. + tags: + - OSD + /api/osd/safe_to_delete: + get: + description: "\n :type ids: int|[int]\n " + parameters: + - in: query + name: svc_ids + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/safe_to_destroy: + get: + description: "\n :type ids: int|[int]\n " + parameters: + - description: OSD Service Identifier + in: query + name: ids + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + active: + description: '' + items: + type: integer + type: array + is_safe_to_destroy: + description: Is OSD safe to destroy? + type: boolean + missing_stats: + description: '' + items: + type: string + type: array + safe_to_destroy: + description: Is OSD safe to destroy? + items: + type: string + type: array + stored_pgs: + description: Stored Pool groups in Osd + items: + type: string + type: array + required: + - safe_to_destroy + - active + - missing_stats + - stored_pgs + - is_safe_to_destroy + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Check If OSD is Safe to Destroy + tags: + - OSD + /api/osd/settings: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v0.1+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}: + delete: + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: preserve_id + schema: + type: string + - allowEmptyValue: true + in: query + name: force + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + get: + description: "\n Returns collected data about an OSD.\n\n :return:\ + \ Returns the requested data.\n " + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + put: + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + device_class: + type: string + required: + - device_class + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/destroy: + post: + description: "\n Mark osd as being destroyed. Keeps the ID intact (allowing\ + \ reuse), but\n removes cephx keys, config-key data and lockbox keys,\ + \ rendering data\n permanently unreadable.\n\n The osd must\ + \ be marked down before being destroyed.\n " + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/devices: + get: + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/histogram: + get: + description: "\n :return: Returns the histogram data.\n " + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/mark: + put: + description: "\n Note: osd must be marked `down` before marking lost.\n\ + \ " + parameters: + - description: SVC ID + in: path + name: svc_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + action: + type: string + required: + - action + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Mark OSD flags (out, in, down, lost, ...) + tags: + - OSD + /api/osd/{svc_id}/purge: + post: + description: "\n Note: osd must be marked `down` before removal.\n \ + \ " + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/reweight: + post: + description: "\n Reweights the OSD temporarily.\n\n Note that\ + \ \u2018ceph osd reweight\u2019 is not a persistent setting. When an OSD\n\ + \ gets marked out, the osd weight will be set to 0. When it gets marked\n\ + \ in again, the weight will be changed to 1.\n\n Because of\ + \ this \u2018ceph osd reweight\u2019 is a temporary solution. You should\n\ + \ only use it to keep your cluster running while you\u2019re ordering\ + \ more\n hardware.\n\n - Craig Lewis (http://lists.ceph.com/pipermail/ceph-users-ceph.com/2014-June/040967.html)\n\ + \ " + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + weight: + type: string + required: + - weight + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/scrub: + post: + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + - default: false + in: query + name: deep + schema: + type: boolean + requestBody: + content: + application/json: + schema: + properties: + deep: + default: false + type: boolean + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/osd/{svc_id}/smart: + get: + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OSD + /api/perf_counters: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + mon.a: + description: Service ID + properties: + .cache_bytes: + description: '' + properties: + description: + description: '' + type: string + nick: + description: '' + type: string + priority: + description: '' + type: integer + type: + description: '' + type: integer + units: + description: '' + type: integer + value: + description: '' + type: integer + required: + - description + - nick + - type + - priority + - units + - value + type: object + required: + - .cache_bytes + type: object + required: + - mon.a + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Perf Counters + tags: + - PerfCounters + /api/perf_counters/mds/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MdsPerfCounter + /api/perf_counters/mgr/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MgrPerfCounter + /api/perf_counters/mon/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - MonPerfCounter + /api/perf_counters/osd/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - OsdPerfCounter + /api/perf_counters/rbd-mirror/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwMirrorPerfCounter + /api/perf_counters/rgw/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwPerfCounter + /api/perf_counters/tcmu-runner/{service_id}: + get: + parameters: + - in: path + name: service_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - TcmuRunnerPerfCounter + /api/pool: + get: + parameters: + - allowEmptyValue: true + description: Pool Attributes + in: query + name: attrs + schema: + type: string + - default: false + description: Pool Stats + in: query + name: stats + schema: + type: boolean + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + application_metadata: + description: '' + items: + type: string + type: array + auid: + description: '' + type: integer + cache_min_evict_age: + description: '' + type: integer + cache_min_flush_age: + description: '' + type: integer + cache_mode: + description: '' + type: string + cache_target_dirty_high_ratio_micro: + description: '' + type: integer + cache_target_dirty_ratio_micro: + description: '' + type: integer + cache_target_full_ratio_micro: + description: '' + type: integer + create_time: + description: '' + type: string + crush_rule: + description: '' + type: string + erasure_code_profile: + description: '' + type: string + expected_num_objects: + description: '' + type: integer + fast_read: + description: '' + type: boolean + flags: + description: '' + type: integer + flags_names: + description: flags name + type: string + grade_table: + description: '' + items: + type: string + type: array + hit_set_count: + description: '' + type: integer + hit_set_grade_decay_rate: + description: '' + type: integer + hit_set_params: + description: '' + properties: + type: + description: '' + type: string + required: + - type + type: object + hit_set_period: + description: '' + type: integer + hit_set_search_last_n: + description: '' + type: integer + last_change: + description: '' + type: string + last_force_op_resend: + description: '' + type: string + last_force_op_resend_preluminous: + description: '' + type: string + last_force_op_resend_prenautilus: + description: '' + type: string + last_pg_merge_meta: + description: '' + properties: + last_epoch_clean: + description: '' + type: integer + last_epoch_started: + description: '' + type: integer + ready_epoch: + description: '' + type: integer + source_pgid: + description: '' + type: string + source_version: + description: '' + type: string + target_version: + description: '' + type: string + required: + - ready_epoch + - last_epoch_started + - last_epoch_clean + - source_pgid + - source_version + - target_version + type: object + min_read_recency_for_promote: + description: '' + type: integer + min_size: + description: '' + type: integer + min_write_recency_for_promote: + description: '' + type: integer + object_hash: + description: '' + type: integer + options: + description: '' + properties: + pg_num_max: + description: '' + type: integer + pg_num_min: + description: '' + type: integer + required: + - pg_num_min + - pg_num_max + type: object + pg_autoscale_mode: + description: '' + type: string + pg_num: + description: '' + type: integer + pg_num_pending: + description: '' + type: integer + pg_num_target: + description: '' + type: integer + pg_placement_num: + description: '' + type: integer + pg_placement_num_target: + description: '' + type: integer + pool: + description: pool id + type: integer + pool_name: + description: pool name + type: string + pool_snaps: + description: '' + items: + type: string + type: array + quota_max_bytes: + description: '' + type: integer + quota_max_objects: + description: '' + type: integer + read_tier: + description: '' + type: integer + removed_snaps: + description: '' + items: + type: string + type: array + size: + description: pool size + type: integer + snap_epoch: + description: '' + type: integer + snap_mode: + description: '' + type: string + snap_seq: + description: '' + type: integer + stripe_width: + description: '' + type: integer + target_max_bytes: + description: '' + type: integer + target_max_objects: + description: '' + type: integer + tier_of: + description: '' + type: integer + tiers: + description: '' + items: + type: string + type: array + type: + description: type of pool + type: string + use_gmt_hitset: + description: '' + type: boolean + write_tier: + description: '' + type: integer + type: object + required: + - pool + - pool_name + - flags + - flags_names + - type + - size + - min_size + - crush_rule + - object_hash + - pg_autoscale_mode + - pg_num + - pg_placement_num + - pg_placement_num_target + - pg_num_target + - pg_num_pending + - last_pg_merge_meta + - auid + - snap_mode + - snap_seq + - snap_epoch + - pool_snaps + - quota_max_bytes + - quota_max_objects + - tiers + - tier_of + - read_tier + - write_tier + - cache_mode + - target_max_bytes + - target_max_objects + - cache_target_dirty_ratio_micro + - cache_target_dirty_high_ratio_micro + - cache_target_full_ratio_micro + - cache_min_flush_age + - cache_min_evict_age + - erasure_code_profile + - hit_set_params + - hit_set_period + - hit_set_count + - use_gmt_hitset + - min_read_recency_for_promote + - min_write_recency_for_promote + - hit_set_grade_decay_rate + - hit_set_search_last_n + - grade_table + - stripe_width + - expected_num_objects + - fast_read + - options + - application_metadata + - create_time + - last_change + - last_force_op_resend + - last_force_op_resend_prenautilus + - last_force_op_resend_preluminous + - removed_snaps + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Pool List + tags: + - Pool + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + pool: + default: rbd-mirror + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Pool + /api/pool/{pool_name}: + delete: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Pool + get: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: attrs + schema: + type: string + - default: false + in: query + name: stats + schema: + type: boolean + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Pool + put: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + application_metadata: + type: string + configuration: + type: string + flags: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Pool + /api/pool/{pool_name}/configuration: + get: + parameters: + - in: path + name: pool_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Pool + /api/prometheus: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Prometheus + /api/prometheus/data: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Prometheus + /api/prometheus/notifications: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - PrometheusNotifications + /api/prometheus/rules: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Prometheus + /api/prometheus/silence: + post: + parameters: [] + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Prometheus + /api/prometheus/silence/{s_id}: + delete: + parameters: + - in: path + name: s_id + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Prometheus + /api/prometheus/silences: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Prometheus + /api/rgw/bucket: + get: + parameters: + - default: false + in: query + name: stats + schema: + type: boolean + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + - allowEmptyValue: true + in: query + name: uid + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.1+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + bucket: + type: string + daemon_name: + type: string + encryption_state: + default: 'false' + type: string + encryption_type: + type: string + key_id: + type: string + lock_enabled: + default: 'false' + type: string + lock_mode: + type: string + lock_retention_period_days: + type: string + lock_retention_period_years: + type: string + placement_target: + type: string + uid: + type: string + zonegroup: + type: string + required: + - bucket + - uid + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + /api/rgw/bucket/deleteEncryption: + delete: + parameters: + - in: query + name: bucket_name + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + - allowEmptyValue: true + in: query + name: owner + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + /api/rgw/bucket/getEncryption: + get: + parameters: + - in: query + name: bucket_name + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + - allowEmptyValue: true + in: query + name: owner + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + /api/rgw/bucket/getEncryptionConfig: + get: + parameters: + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + - allowEmptyValue: true + in: query + name: owner + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + /api/rgw/bucket/setEncryptionConfig: + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + address: + type: string + auth_method: + type: string + client_cert: + type: string + client_key: + type: string + daemon_name: + type: string + encryption_type: + type: string + kms_provider: + type: string + namespace: + default: '' + type: string + owner: + type: string + secret_engine: + type: string + secret_path: + default: '' + type: string + ssl_cert: + type: string + token: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + /api/rgw/bucket/{bucket}: + delete: + parameters: + - in: path + name: bucket + required: true + schema: + type: string + - default: 'true' + in: query + name: purge_objects + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + get: + parameters: + - in: path + name: bucket + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + put: + parameters: + - in: path + name: bucket + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + bucket_id: + type: string + daemon_name: + type: string + encryption_state: + default: 'false' + type: string + encryption_type: + type: string + key_id: + type: string + lock_mode: + type: string + lock_retention_period_days: + type: string + lock_retention_period_years: + type: string + mfa_delete: + type: string + mfa_token_pin: + type: string + mfa_token_serial: + type: string + uid: + type: string + versioning_state: + type: string + required: + - bucket_id + - uid + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwBucket + /api/rgw/daemon: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + id: + description: Daemon ID + type: string + port: + description: Port + type: integer + server_hostname: + description: '' + type: string + version: + description: Ceph Version + type: string + zone_name: + description: Zone + type: string + zonegroup_name: + description: Zone Group + type: string + type: object + required: + - id + - version + - server_hostname + - zonegroup_name + - zone_name + - port + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display RGW Daemons + tags: + - RgwDaemon + /api/rgw/daemon/set_multisite_config: + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + daemon_name: + type: string + realm_name: + type: string + zone_name: + type: string + zonegroup_name: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwDaemon + /api/rgw/daemon/{svc_id}: + get: + parameters: + - in: path + name: svc_id + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwDaemon + /api/rgw/realm: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + default: + type: string + realm_name: + type: string + required: + - realm_name + - default + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + /api/rgw/realm/get_all_realms_info: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + /api/rgw/realm/get_realm_tokens: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + /api/rgw/realm/import_realm_token: + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + placement_spec: + type: string + port: + type: string + realm_token: + type: string + zone_name: + type: string + required: + - realm_token + - zone_name + - port + - placement_spec + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + /api/rgw/realm/{realm_name}: + delete: + parameters: + - in: path + name: realm_name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + get: + parameters: + - in: path + name: realm_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + put: + parameters: + - in: path + name: realm_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + default: + default: '' + type: string + new_realm_name: + type: string + required: + - new_realm_name + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwRealm + /api/rgw/roles: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: List RGW roles + tags: + - RGW + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + role_assume_policy_doc: + default: '' + type: string + role_name: + default: '' + type: string + role_path: + default: '' + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Create Ceph User + tags: + - RGW + /api/rgw/site: + get: + parameters: + - allowEmptyValue: true + in: query + name: query + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwSite + /api/rgw/user: + get: + parameters: + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + list_of_users: + description: list of rgw users + items: + type: string + type: array + required: + - list_of_users + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display RGW Users + tags: + - RgwUser + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + access_key: + type: string + daemon_name: + type: string + display_name: + type: string + email: + type: string + generate_key: + type: string + max_buckets: + type: string + secret_key: + type: string + suspended: + type: string + uid: + type: string + required: + - uid + - display_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/get_emails: + get: + parameters: + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/{uid}: + delete: + parameters: + - in: path + name: uid + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + get: + parameters: + - in: path + name: uid + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + - default: true + in: query + name: stats + schema: + type: boolean + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + put: + parameters: + - in: path + name: uid + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + daemon_name: + type: string + display_name: + type: string + email: + type: string + max_buckets: + type: string + suspended: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/{uid}/capability: + delete: + parameters: + - in: path + name: uid + required: true + schema: + type: string + - in: query + name: type + required: true + schema: + type: string + - in: query + name: perm + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + post: + parameters: + - in: path + name: uid + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + daemon_name: + type: string + perm: + type: string + type: + type: string + required: + - type + - perm + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/{uid}/key: + delete: + parameters: + - in: path + name: uid + required: true + schema: + type: string + - default: s3 + in: query + name: key_type + schema: + type: string + - allowEmptyValue: true + in: query + name: subuser + schema: + type: string + - allowEmptyValue: true + in: query + name: access_key + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + post: + parameters: + - in: path + name: uid + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + access_key: + type: string + daemon_name: + type: string + generate_key: + default: 'true' + type: string + key_type: + default: s3 + type: string + secret_key: + type: string + subuser: + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/{uid}/quota: + get: + parameters: + - in: path + name: uid + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + put: + parameters: + - in: path + name: uid + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + daemon_name: + type: string + enabled: + type: string + max_objects: + type: string + max_size_kb: + type: integer + quota_type: + type: string + required: + - quota_type + - enabled + - max_size_kb + - max_objects + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/{uid}/subuser: + post: + parameters: + - in: path + name: uid + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + access: + type: string + access_key: + type: string + daemon_name: + type: string + generate_secret: + default: 'true' + type: string + key_type: + default: s3 + type: string + secret_key: + type: string + subuser: + type: string + required: + - subuser + - access + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/user/{uid}/subuser/{subuser}: + delete: + description: "\n :param purge_keys: Set to False to do not purge the\ + \ keys.\n Note, this only works for s3 subusers.\n\ + \ " + parameters: + - in: path + name: uid + required: true + schema: + type: string + - in: path + name: subuser + required: true + schema: + type: string + - default: 'true' + in: query + name: purge_keys + schema: + type: string + - allowEmptyValue: true + in: query + name: daemon_name + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwUser + /api/rgw/zone: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + access_key: + type: string + default: + default: false + type: boolean + master: + default: false + type: boolean + secret_key: + type: string + zone_endpoints: + type: string + zone_name: + type: string + zonegroup_name: + type: string + required: + - zone_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + /api/rgw/zone/create_system_user: + put: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + userName: + type: string + zoneName: + type: string + required: + - userName + - zoneName + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + /api/rgw/zone/get_all_zones_info: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + /api/rgw/zone/get_pool_names: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + /api/rgw/zone/get_user_list: + get: + parameters: + - allowEmptyValue: true + in: query + name: zoneName + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + /api/rgw/zone/{zone_name}: + delete: + parameters: + - in: path + name: zone_name + required: true + schema: + type: string + - in: query + name: delete_pools + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: pools + schema: + type: string + - allowEmptyValue: true + in: query + name: zonegroup_name + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + get: + parameters: + - in: path + name: zone_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + put: + parameters: + - in: path + name: zone_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + access_key: + default: '' + type: string + compression: + default: '' + type: string + data_extra_pool: + default: '' + type: string + data_pool: + default: '' + type: string + data_pool_class: + default: '' + type: string + default: + default: '' + type: string + index_pool: + default: '' + type: string + master: + default: '' + type: string + new_zone_name: + type: string + placement_target: + default: '' + type: string + secret_key: + default: '' + type: string + storage_class: + default: '' + type: string + zone_endpoints: + default: '' + type: string + zonegroup_name: + type: string + required: + - new_zone_name + - zonegroup_name + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZone + /api/rgw/zonegroup: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZonegroup + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + default: + type: string + master: + type: string + realm_name: + type: string + zonegroup_endpoints: + type: string + zonegroup_name: + type: string + required: + - realm_name + - zonegroup_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZonegroup + /api/rgw/zonegroup/get_all_zonegroups_info: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZonegroup + /api/rgw/zonegroup/{zonegroup_name}: + delete: + parameters: + - in: path + name: zonegroup_name + required: true + schema: + type: string + - in: query + name: delete_pools + required: true + schema: + type: string + - allowEmptyValue: true + in: query + name: pools + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZonegroup + get: + parameters: + - in: path + name: zonegroup_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZonegroup + put: + parameters: + - in: path + name: zonegroup_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + add_zones: + default: [] + type: string + default: + default: '' + type: string + master: + default: '' + type: string + new_zonegroup_name: + type: string + placement_targets: + default: [] + type: string + realm_name: + type: string + remove_zones: + default: [] + type: string + zonegroup_endpoints: + default: '' + type: string + required: + - realm_name + - new_zonegroup_name + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - RgwZonegroup + /api/role: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + description: + description: Role Descriptions + type: string + name: + description: Role Name + type: string + scopes_permissions: + description: '' + properties: + cephfs: + description: '' + items: + type: string + type: array + required: + - cephfs + type: object + system: + description: '' + type: boolean + type: object + required: + - name + - description + - scopes_permissions + - system + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Role list + tags: + - Role + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + description: + type: string + name: + type: string + scopes_permissions: + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Role + /api/role/{name}: + delete: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Role + get: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Role + put: + parameters: + - in: path + name: name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + description: + type: string + scopes_permissions: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Role + /api/role/{name}/clone: + post: + parameters: + - in: path + name: name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + new_name: + type: string + required: + - new_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Role + /api/service: + get: + parameters: + - allowEmptyValue: true + in: query + name: service_name + schema: + type: string + - default: 0 + in: query + name: offset + schema: + type: integer + - default: 5 + in: query + name: limit + schema: + type: integer + - default: '' + in: query + name: search + schema: + type: string + - default: +service_name + in: query + name: sort + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v2.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + post: + description: "\n :param service_spec: The service specification as JSON.\n\ + \ :param service_name: The service name, e.g. 'alertmanager'.\n \ + \ :return: None\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + service_name: + type: string + service_spec: + type: string + required: + - service_spec + - service_name + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + /api/service/known_types: + get: + description: "\n Get a list of known service types, e.g. 'alertmanager',\n\ + \ 'node-exporter', 'osd' or 'rgw'.\n " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + /api/service/{service_name}: + delete: + description: "\n :param service_name: The service name, e.g. 'mds' or\ + \ 'crash.foo'.\n :return: None\n " + parameters: + - in: path + name: service_name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + get: + parameters: + - in: path + name: service_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + put: + description: "\n :param service_spec: The service specification as JSON.\n\ + \ :param service_name: The service name, e.g. 'alertmanager'.\n \ + \ :return: None\n " + parameters: + - in: path + name: service_name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + service_spec: + type: string + required: + - service_spec + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + /api/service/{service_name}/daemons: + get: + parameters: + - in: path + name: service_name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Service + /api/settings: + get: + description: "\n Get the list of available options.\n :param names:\ + \ A comma separated list of option names that should\n be processed.\ + \ Defaults to ``None``.\n :type names: None|str\n :return: A\ + \ list of available options.\n :rtype: list[dict]\n " + parameters: + - allowEmptyValue: true + description: Name of Settings + in: query + name: names + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + items: + properties: + default: + description: Default Settings + type: boolean + name: + description: Settings Name + type: string + type: + description: Type of Settings + type: string + value: + description: Settings Value + type: boolean + type: object + required: + - name + - default + - type + - value + type: array + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Settings Information + tags: + - Settings + put: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Settings + /api/settings/{name}: + delete: + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Settings + get: + description: "\n Get the given option.\n :param name: The name\ + \ of the option.\n :return: Returns a dict containing the name, type,\n\ + \ default value and current value of the given option.\n :rtype:\ + \ dict\n " + parameters: + - in: path + name: name + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Settings + put: + parameters: + - in: path + name: name + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + value: + type: string + required: + - value + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Settings + /api/summary: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + executing_tasks: + description: '' + items: + type: string + type: array + finished_tasks: + description: '' + items: + properties: + begin_time: + description: '' + type: string + duration: + description: '' + type: integer + end_time: + description: '' + type: string + exception: + description: '' + type: string + metadata: + description: '' + properties: + pool: + description: '' + type: integer + required: + - pool + type: object + name: + description: '' + type: string + progress: + description: '' + type: integer + ret_value: + description: '' + type: string + success: + description: '' + type: boolean + required: + - name + - metadata + - begin_time + - end_time + - duration + - progress + - success + - ret_value + - exception + type: object + type: array + have_mon_connection: + description: '' + type: string + health_status: + description: '' + type: string + mgr_host: + description: '' + type: string + mgr_id: + description: '' + type: string + rbd_mirroring: + description: '' + properties: + errors: + description: '' + type: integer + warnings: + description: '' + type: integer + required: + - warnings + - errors + type: object + version: + description: '' + type: string + required: + - health_status + - mgr_id + - mgr_host + - have_mon_connection + - executing_tasks + - finished_tasks + - version + - rbd_mirroring + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Summary + tags: + - Summary + /api/task: + get: + parameters: + - allowEmptyValue: true + description: Task Name + in: query + name: name + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + executing_tasks: + description: ongoing executing tasks + type: string + finished_tasks: + description: '' + items: + properties: + begin_time: + description: Task begin time + type: string + duration: + description: '' + type: integer + end_time: + description: Task end time + type: string + exception: + description: '' + type: boolean + metadata: + description: '' + properties: + pool: + description: '' + type: integer + required: + - pool + type: object + name: + description: finished tasks name + type: string + progress: + description: Progress of tasks + type: integer + ret_value: + description: '' + type: boolean + success: + description: '' + type: boolean + required: + - name + - metadata + - begin_time + - end_time + - duration + - progress + - success + - ret_value + - exception + type: object + type: array + required: + - executing_tasks + - finished_tasks + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Display Tasks + tags: + - Task + /api/telemetry: + put: + description: "\n Enables or disables sending data collected by the Telemetry\n\ + \ module.\n :param enable: Enable or disable sending data\n\ + \ :type enable: bool\n :param license_name: License string e.g.\ + \ 'sharing-1-0' to\n make sure the user is aware of and accepts the\ + \ license\n for sharing Telemetry data.\n :type license_name:\ + \ string\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + enable: + default: true + type: boolean + license_name: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - Telemetry + /api/telemetry/report: + get: + description: "\n Get Ceph and device report data\n :return: Ceph\ + \ and device report data\n :rtype: dict\n " + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + device_report: + description: '' + type: string + report: + description: '' + properties: + balancer: + description: '' + properties: + active: + description: '' + type: boolean + mode: + description: '' + type: string + required: + - active + - mode + type: object + channels: + description: '' + items: + type: string + type: array + channels_available: + description: '' + items: + type: string + type: array + config: + description: '' + properties: + active_changed: + description: '' + items: + type: string + type: array + cluster_changed: + description: '' + items: + type: string + type: array + required: + - cluster_changed + - active_changed + type: object + crashes: + description: '' + items: + type: integer + type: array + created: + description: '' + type: string + crush: + description: '' + properties: + bucket_algs: + description: '' + properties: + straw2: + description: '' + type: integer + required: + - straw2 + type: object + bucket_sizes: + description: '' + properties: + '1': + description: '' + type: integer + '3': + description: '' + type: integer + required: + - '1' + - '3' + type: object + bucket_types: + description: '' + properties: + '1': + description: '' + type: integer + '11': + description: '' + type: integer + required: + - '1' + - '11' + type: object + compat_weight_set: + description: '' + type: boolean + device_classes: + description: '' + items: + type: integer + type: array + num_buckets: + description: '' + type: integer + num_devices: + description: '' + type: integer + num_rules: + description: '' + type: integer + num_types: + description: '' + type: integer + num_weight_sets: + description: '' + type: integer + tunables: + description: '' + properties: + allowed_bucket_algs: + description: '' + type: integer + choose_local_fallback_tries: + description: '' + type: integer + choose_local_tries: + description: '' + type: integer + choose_total_tries: + description: '' + type: integer + chooseleaf_descend_once: + description: '' + type: integer + chooseleaf_stable: + description: '' + type: integer + chooseleaf_vary_r: + description: '' + type: integer + has_v2_rules: + description: '' + type: integer + has_v3_rules: + description: '' + type: integer + has_v4_buckets: + description: '' + type: integer + has_v5_rules: + description: '' + type: integer + legacy_tunables: + description: '' + type: integer + minimum_required_version: + description: '' + type: string + optimal_tunables: + description: '' + type: integer + profile: + description: '' + type: string + require_feature_tunables: + description: '' + type: integer + require_feature_tunables2: + description: '' + type: integer + require_feature_tunables3: + description: '' + type: integer + require_feature_tunables5: + description: '' + type: integer + straw_calc_version: + description: '' + type: integer + required: + - choose_local_tries + - choose_local_fallback_tries + - choose_total_tries + - chooseleaf_descend_once + - chooseleaf_vary_r + - chooseleaf_stable + - straw_calc_version + - allowed_bucket_algs + - profile + - optimal_tunables + - legacy_tunables + - minimum_required_version + - require_feature_tunables + - require_feature_tunables2 + - has_v2_rules + - require_feature_tunables3 + - has_v3_rules + - has_v4_buckets + - require_feature_tunables5 + - has_v5_rules + type: object + required: + - num_devices + - num_types + - num_buckets + - num_rules + - device_classes + - tunables + - compat_weight_set + - num_weight_sets + - bucket_algs + - bucket_sizes + - bucket_types + type: object + fs: + description: '' + properties: + count: + description: '' + type: integer + feature_flags: + description: '' + properties: + enable_multiple: + description: '' + type: boolean + ever_enabled_multiple: + description: '' + type: boolean + required: + - enable_multiple + - ever_enabled_multiple + type: object + filesystems: + description: '' + items: + type: integer + type: array + num_standby_mds: + description: '' + type: integer + total_num_mds: + description: '' + type: integer + required: + - count + - feature_flags + - num_standby_mds + - filesystems + - total_num_mds + type: object + hosts: + description: '' + properties: + num: + description: '' + type: integer + num_with_mds: + description: '' + type: integer + num_with_mgr: + description: '' + type: integer + num_with_mon: + description: '' + type: integer + num_with_osd: + description: '' + type: integer + required: + - num + - num_with_mon + - num_with_mds + - num_with_osd + - num_with_mgr + type: object + leaderboard: + description: '' + type: boolean + license: + description: '' + type: string + metadata: + description: '' + properties: + mon: + description: '' + properties: + arch: + description: '' + properties: + x86_64: + description: '' + type: integer + required: + - x86_64 + type: object + ceph_version: + description: '' + properties: + ceph version 16.0.0-3151-gf202994fcf: + description: '' + type: integer + required: + - ceph version 16.0.0-3151-gf202994fcf + type: object + cpu: + description: '' + properties: + Intel(R) Core(TM) i7-8665U CPU @ 1.90GHz: + description: '' + type: integer + required: + - Intel(R) Core(TM) i7-8665U CPU @ 1.90GHz + type: object + distro: + description: '' + properties: + centos: + description: '' + type: integer + required: + - centos + type: object + distro_description: + description: '' + properties: + CentOS Linux 8 (Core): + description: '' + type: integer + required: + - CentOS Linux 8 (Core) + type: object + kernel_description: + description: '' + properties: + '#1 SMP Wed Jul 1 19:53:01 UTC 2020': + description: '' + type: integer + required: + - '#1 SMP Wed Jul 1 19:53:01 UTC 2020' + type: object + kernel_version: + description: '' + properties: + 5.7.7-200.fc32.x86_64: + description: '' + type: integer + required: + - 5.7.7-200.fc32.x86_64 + type: object + os: + description: '' + properties: + Linux: + description: '' + type: integer + required: + - Linux + type: object + required: + - arch + - ceph_version + - os + - cpu + - kernel_description + - kernel_version + - distro_description + - distro + type: object + osd: + description: '' + properties: + arch: + description: '' + properties: + x86_64: + description: '' + type: integer + required: + - x86_64 + type: object + ceph_version: + description: '' + properties: + ceph version 16.0.0-3151-gf202994fcf: + description: '' + type: integer + required: + - ceph version 16.0.0-3151-gf202994fcf + type: object + cpu: + description: '' + properties: + Intel(R) Core(TM) i7-8665U CPU @ 1.90GHz: + description: '' + type: integer + required: + - Intel(R) Core(TM) i7-8665U CPU @ 1.90GHz + type: object + distro: + description: '' + properties: + centos: + description: '' + type: integer + required: + - centos + type: object + distro_description: + description: '' + properties: + CentOS Linux 8 (Core): + description: '' + type: integer + required: + - CentOS Linux 8 (Core) + type: object + kernel_description: + description: '' + properties: + '#1 SMP Wed Jul 1 19:53:01 UTC 2020': + description: '' + type: integer + required: + - '#1 SMP Wed Jul 1 19:53:01 UTC 2020' + type: object + kernel_version: + description: '' + properties: + 5.7.7-200.fc32.x86_64: + description: '' + type: integer + required: + - 5.7.7-200.fc32.x86_64 + type: object + os: + description: '' + properties: + Linux: + description: '' + type: integer + required: + - Linux + type: object + osd_objectstore: + description: '' + properties: + bluestore: + description: '' + type: integer + required: + - bluestore + type: object + rotational: + description: '' + properties: + '1': + description: '' + type: integer + required: + - '1' + type: object + required: + - osd_objectstore + - rotational + - arch + - ceph_version + - os + - cpu + - kernel_description + - kernel_version + - distro_description + - distro + type: object + required: + - osd + - mon + type: object + mon: + description: '' + properties: + count: + description: '' + type: integer + features: + description: '' + properties: + optional: + description: '' + items: + type: integer + type: array + persistent: + description: '' + items: + type: string + type: array + required: + - persistent + - optional + type: object + ipv4_addr_mons: + description: '' + type: integer + ipv6_addr_mons: + description: '' + type: integer + min_mon_release: + description: '' + type: integer + v1_addr_mons: + description: '' + type: integer + v2_addr_mons: + description: '' + type: integer + required: + - count + - features + - min_mon_release + - v1_addr_mons + - v2_addr_mons + - ipv4_addr_mons + - ipv6_addr_mons + type: object + osd: + description: '' + properties: + cluster_network: + description: '' + type: boolean + count: + description: '' + type: integer + require_min_compat_client: + description: '' + type: string + require_osd_release: + description: '' + type: string + required: + - count + - require_osd_release + - require_min_compat_client + - cluster_network + type: object + pools: + description: '' + items: + properties: + cache_mode: + description: '' + type: string + erasure_code_profile: + description: '' + type: string + min_size: + description: '' + type: integer + pg_autoscale_mode: + description: '' + type: string + pg_num: + description: '' + type: integer + pgp_num: + description: '' + type: integer + pool: + description: '' + type: integer + size: + description: '' + type: integer + target_max_bytes: + description: '' + type: integer + target_max_objects: + description: '' + type: integer + type: + description: '' + type: string + required: + - pool + - type + - pg_num + - pgp_num + - size + - min_size + - pg_autoscale_mode + - target_max_bytes + - target_max_objects + - erasure_code_profile + - cache_mode + type: object + type: array + rbd: + description: '' + properties: + mirroring_by_pool: + description: '' + items: + type: boolean + type: array + num_images_by_pool: + description: '' + items: + type: integer + type: array + num_pools: + description: '' + type: integer + required: + - num_pools + - num_images_by_pool + - mirroring_by_pool + type: object + report_id: + description: '' + type: string + report_timestamp: + description: '' + type: string + report_version: + description: '' + type: integer + rgw: + description: '' + properties: + count: + description: '' + type: integer + frontends: + description: '' + items: + type: string + type: array + zonegroups: + description: '' + type: integer + zones: + description: '' + type: integer + required: + - count + - zones + - zonegroups + - frontends + type: object + services: + description: '' + properties: + rgw: + description: '' + type: integer + required: + - rgw + type: object + usage: + description: '' + properties: + pg_num: + description: '' + type: integer + pools: + description: '' + type: integer + total_avail_bytes: + description: '' + type: integer + total_bytes: + description: '' + type: integer + total_used_bytes: + description: '' + type: integer + required: + - pools + - pg_num + - total_used_bytes + - total_bytes + - total_avail_bytes + type: object + required: + - leaderboard + - report_version + - report_timestamp + - report_id + - channels + - channels_available + - license + - created + - mon + - config + - rbd + - pools + - osd + - crush + - fs + - metadata + - hosts + - usage + - services + - rgw + - balancer + - crashes + type: object + required: + - report + - device_report + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get Detailed Telemetry report + tags: + - Telemetry + /api/user: + get: + parameters: [] + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + schema: + properties: + email: + description: User email address + type: string + enabled: + description: Is the user enabled? + type: boolean + lastUpdate: + description: Details last updated + type: integer + name: + description: User Name + type: string + pwdExpirationDate: + description: Password Expiration date + type: string + pwdUpdateRequired: + description: Is Password Update Required? + type: boolean + roles: + description: User Roles + items: + type: string + type: array + username: + description: Username of the user + type: string + required: + - username + - roles + - name + - email + - lastUpdate + - enabled + - pwdExpirationDate + - pwdUpdateRequired + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + summary: Get List Of Users + tags: + - User + post: + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + email: + type: string + enabled: + default: true + type: boolean + name: + type: string + password: + type: string + pwdExpirationDate: + type: string + pwdUpdateRequired: + default: true + type: boolean + roles: + type: string + username: + type: string + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - User + /api/user/validate_password: + post: + description: "\n Check if the password meets the password policy.\n \ + \ :param password: The password to validate.\n :param username:\ + \ The name of the user (optional).\n :param old_password: The old password\ + \ (optional).\n :return: An object with properties valid, credits and\ + \ valuation.\n 'credits' contains the password complexity credits and\n\ + \ 'valuation' the textual summary of the validation.\n " + parameters: [] + requestBody: + content: + application/json: + schema: + properties: + old_password: + type: string + password: + type: string + username: + type: string + required: + - password + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - UserPasswordPolicy + /api/user/{username}: + delete: + parameters: + - in: path + name: username + required: true + schema: + type: string + responses: + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '204': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource deleted. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - User + get: + parameters: + - in: path + name: username + required: true + schema: + type: string + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: OK + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - User + put: + parameters: + - in: path + name: username + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + email: + type: string + enabled: + type: string + name: + type: string + password: + type: string + pwdExpirationDate: + type: string + pwdUpdateRequired: + default: false + type: boolean + roles: + type: string + type: object + responses: + '200': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource updated. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - User + /api/user/{username}/change_password: + post: + parameters: + - in: path + name: username + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + properties: + new_password: + type: string + old_password: + type: string + required: + - old_password + - new_password + type: object + responses: + '201': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Resource created. + '202': + content: + application/vnd.ceph.api.v1.0+json: + type: object + description: Operation is still executing. Please check the task queue. + '400': + description: Operation exception. Please check the response body for details. + '401': + description: Unauthenticated access. Please login first. + '403': + description: Unauthorized access. Please check your permissions. + '500': + description: Unexpected error. Please check the response body for the stack + trace. + security: + - jwt: [] + tags: + - UserChangePassword +schemes: +- https +servers: +- url: / +tags: +- description: Initiate a session with Ceph + name: Auth +- description: CephFS Subvolume Management API + name: CephFSSubvolume +- description: Cephfs Management API + name: Cephfs +- description: Cephfs Subvolume Group Management API + name: CephfsSubvolumeGroup +- description: Get Cluster Details + name: Cluster +- description: Manage Cluster Configurations + name: ClusterConfiguration +- description: Crush Rule Management API + name: CrushRule +- description: Perform actions on daemons + name: Daemon +- description: Erasure Code Profile Management API + name: ErasureCodeProfile +- description: Manage Features API + name: FeatureTogglesEndpoint +- description: Grafana Management API + name: Grafana +- description: Display Detailed Cluster health Status + name: Health +- description: Get Host Details + name: Host +- description: Iscsi Management API + name: Iscsi +- description: Get Iscsi Target Details + name: IscsiTarget +- description: Logs Management API + name: Logs +- description: Mds Perf Counters Management API + name: MdsPerfCounter +- description: Get details of MGR Module + name: MgrModule +- description: Mgr Perf Counters Management API + name: MgrPerfCounter +- description: Mon Perf Counters Management API + name: MonPerfCounter +- description: Get Monitor Details + name: Monitor +- description: NFS-Ganesha Cluster Management API + name: NFS-Ganesha +- description: OSD management API + name: OSD +- description: OSD Perf Counters Management API + name: OsdPerfCounter +- description: Perf Counters Management API + name: PerfCounters +- description: Get pool details by pool name + name: Pool +- description: Prometheus Management API + name: Prometheus +- description: Prometheus Notifications Management API + name: PrometheusNotifications +- description: List of RGW roles + name: RGW +- description: RBD Management API + name: Rbd +- description: RBD Mirroring Management API + name: RbdMirroring +- description: RBD Mirroring Pool Bootstrap Management API + name: RbdMirroringPoolBootstrap +- description: RBD Mirroring Pool Mode Management API + name: RbdMirroringPoolMode +- description: RBD Mirroring Pool Peer Management API + name: RbdMirroringPoolPeer +- description: RBD Mirroring Summary Management API + name: RbdMirroringSummary +- description: RBD Namespace Management API + name: RbdNamespace +- description: RBD Snapshot Management API + name: RbdSnapshot +- description: RBD Trash Management API + name: RbdTrash +- description: Feedback API + name: Report +- description: RGW Bucket Management API + name: RgwBucket +- description: RGW Daemon Management API + name: RgwDaemon +- description: Rgw Mirroring Perf Counters Management API + name: RgwMirrorPerfCounter +- description: Rgw Perf Counters Management API + name: RgwPerfCounter +- description: '*No description available*' + name: RgwRealm +- description: RGW Site Management API + name: RgwSite +- description: RGW User Management API + name: RgwUser +- description: '*No description available*' + name: RgwZone +- description: '*No description available*' + name: RgwZonegroup +- description: Role Management API + name: Role +- description: Service Management API + name: Service +- description: Settings Management API + name: Settings +- description: Get Ceph Summary Details + name: Summary +- description: Task Management API + name: Task +- description: Tcmu Runner Perf Counters Management API + name: TcmuRunnerPerfCounter +- description: Display Telemetry Report + name: Telemetry +- description: Upgrade Management API + name: Upgrade +- description: Display User Details + name: User +- description: Change User Password + name: UserChangePassword +- description: Get User Password Policy Details + name: UserPasswordPolicy |