XSKY block-snapshots API
BlockSnapshotController Operations about Block Snapshot
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/xsky-block-snapshots-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: XMS is the controller of distributed storage system
version: SDS_4.2.000.0.200302
title: XMS access-paths Block Snapshots API
contact: {}
license:
name: Commercial
servers:
- url: /v1
tags:
- name: block-snapshots
description: 'BlockSnapshotController Operations about Block Snapshot
'
paths:
/block-snapshots/:
get:
tags:
- block-snapshots
description: List block snapshots
operationId: ListBlockSnapshots
parameters:
- name: limit
in: query
description: paging param
required: false
x-exportParamName: Limit
schema:
type: integer
format: int64
- name: offset
in: query
description: paging param
required: false
x-exportParamName: Offset
schema:
type: integer
format: int64
- name: pool_id
in: query
description: pool id
required: false
x-exportParamName: PoolId
schema:
type: integer
format: int64
- name: block_volume_id
in: query
description: volume id
required: false
x-exportParamName: BlockVolumeId
schema:
type: integer
format: int64
- name: reserved
in: query
description: show reserved snapshot or not, default not
required: false
x-exportParamName: Reserved
schema:
type: boolean
- name: q
in: query
description: query param of search
required: false
x-exportParamName: Q
schema:
type: string
- name: sort
in: query
description: sort param of search
required: false
x-exportParamName: Sort
schema:
type: string
- name: all
in: query
description: show all snapshots
required: false
x-exportParamName: All
schema:
type: boolean
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotsResp'
400:
description: BadRequest
500:
description: InternalServerError
security:
- tokenInQuery: []
- tokenInHeader: []
post:
tags:
- block-snapshots
description: Create block snapshot
operationId: CreateBlockSnapshot
responses:
202:
description: Accepted
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotResp'
400:
description: BadRequest
500:
description: InternalServerError
security:
- tokenInQuery: []
- tokenInHeader: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotCreateReq'
description: snapshot info
required: true
/block-snapshots/{block_snapshot_id}:
get:
tags:
- block-snapshots
description: get block snapshot
operationId: GetBlockSnapshot
parameters:
- name: block_snapshot_id
in: path
description: the block snapshot id
required: true
x-exportParamName: BlockSnapshotId
schema:
type: integer
format: int64
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotResp'
404:
description: NotFound
500:
description: InternalServerError
security:
- tokenInQuery: []
- tokenInHeader: []
/block-snapshots/{snapshot_id}:
delete:
tags:
- block-snapshots
description: Delete block snapshot
operationId: DeleteBlockSnapshot
parameters:
- name: snapshot_id
in: path
description: snapshot id
required: true
x-exportParamName: SnapshotId
schema:
type: integer
format: int64
responses:
202:
description: Accepted
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotResp'
404:
description: NotFound
500:
description: InternalServerError
security:
- tokenInQuery: []
- tokenInHeader: []
patch:
tags:
- block-snapshots
description: Update block snapshot info
operationId: UpdateSnapshot
parameters:
- name: snapshot_id
in: path
description: snapshot id
required: true
x-exportParamName: SnapshotId
schema:
type: integer
format: int64
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotResp'
400:
description: BadRequest
404:
description: NotFound
500:
description: InternalServerError
security:
- tokenInHeader: []
- tokenInQuery: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SnapshotUpdateReq'
description: snapshot info
required: true
components:
schemas:
VolumeGroupSnapshot_Nestview:
type: object
properties:
id:
type: integer
format: int64
name:
type: string
title: VolumeGroupSnapshot_Nestview
example:
name: name
id: 6
SnapshotResp:
type: object
required:
- block_snapshot
properties:
block_snapshot:
description: snapshot
$ref: '#/components/schemas/Snapshot'
title: SnapshotResp
example:
block_snapshot:
cloned_block_volume_num: 1
creator: creator
hidden: true
pool:
name: name
id: 5
snap_name: snap_name
description: description
update: '2000-01-23T04:56:07.000+00:00'
allocated_size: 0
passive: true
volume:
original_name: original_name
name: name
id: 9
protected: true
size: 7
remote_cluster:
name: name
id: 2
fs_id: fs_id
url: url
reserved: true
name: name
create: '2000-01-23T04:56:07.000+00:00'
id: 5
action_status: action_status
block_volume_group_snapshot:
name: name
id: 6
status: status
Pool_Nestview:
type: object
properties:
id:
type: integer
format: int64
name:
type: string
title: Pool_Nestview
example:
name: name
id: 5
SnapshotCreateReq_Snapshot:
type: object
required:
- block_volume_id
- description
- name
properties:
block_volume_id:
type: integer
format: int64
description:
type: string
name:
type: string
title: SnapshotCreateReq_Snapshot
example:
block_volume_id: 0
name: name
description: description
SnapshotUpdateReq:
type: object
required:
- block_snapshot
properties:
block_snapshot:
$ref: '#/components/schemas/SnapshotUpdateReq_Snapshot'
title: SnapshotUpdateReq
example:
block_snapshot:
name: name
description: description
RemoteCluster_Nestview:
type: object
properties:
fs_id:
type: string
id:
type: integer
format: int64
name:
type: string
url:
type: string
title: RemoteCluster_Nestview
example:
name: name
id: 2
fs_id: fs_id
url: url
SnapshotsResp:
type: object
required:
- block_snapshots
properties:
block_snapshots:
type: array
description: snapshots
items:
$ref: '#/components/schemas/Snapshot'
title: SnapshotsResp
example:
block_snapshots:
- cloned_block_volume_num: 1
creator: creator
hidden: true
pool:
name: name
id: 5
snap_name: snap_name
description: description
update: '2000-01-23T04:56:07.000+00:00'
allocated_size: 0
passive: true
volume:
original_name: original_name
name: name
id: 9
protected: true
size: 7
remote_cluster:
name: name
id: 2
fs_id: fs_id
url: url
reserved: true
name: name
create: '2000-01-23T04:56:07.000+00:00'
id: 5
action_status: action_status
block_volume_group_snapshot:
name: name
id: 6
status: status
- cloned_block_volume_num: 1
creator: creator
hidden: true
pool:
name: name
id: 5
snap_name: snap_name
description: description
update: '2000-01-23T04:56:07.000+00:00'
allocated_size: 0
passive: true
volume:
original_name: original_name
name: name
id: 9
protected: true
size: 7
remote_cluster:
name: name
id: 2
fs_id: fs_id
url: url
reserved: true
name: name
create: '2000-01-23T04:56:07.000+00:00'
id: 5
action_status: action_status
block_volume_group_snapshot:
name: name
id: 6
status: status
Snapshot:
type: object
properties:
action_status:
type: string
allocated_size:
type: integer
format: int64
block_volume_group_snapshot:
$ref: '#/components/schemas/VolumeGroupSnapshot_Nestview'
cloned_block_volume_num:
type: integer
format: int64
create:
type: string
format: date-time
creator:
type: string
description:
type: string
hidden:
type: boolean
id:
type: integer
format: int64
name:
type: string
passive:
type: boolean
pool:
$ref: '#/components/schemas/Pool_Nestview'
protected:
type: boolean
remote_cluster:
description: the snapshot is replicated from a remote cluster
$ref: '#/components/schemas/RemoteCluster_Nestview'
reserved:
type: boolean
size:
type: integer
format: int64
snap_name:
type: string
status:
type: string
update:
type: string
format: date-time
volume:
$ref: '#/components/schemas/Volume_Nestview'
title: Snapshot
description: Snapshot is the corresponding rbd snapshot
example:
cloned_block_volume_num: 1
creator: creator
hidden: true
pool:
name: name
id: 5
snap_name: snap_name
description: description
update: '2000-01-23T04:56:07.000+00:00'
allocated_size: 0
passive: true
volume:
original_name: original_name
name: name
id: 9
protected: true
size: 7
remote_cluster:
name: name
id: 2
fs_id: fs_id
url: url
reserved: true
name: name
create: '2000-01-23T04:56:07.000+00:00'
id: 5
action_status: action_status
block_volume_group_snapshot:
name: name
id: 6
status: status
Volume_Nestview:
type: object
properties:
id:
type: integer
format: int64
name:
type: string
original_name:
type: string
title: Volume_Nestview
example:
original_name: original_name
name: name
id: 9
SnapshotUpdateReq_Snapshot:
type: object
properties:
description:
type: string
name:
type: string
title: SnapshotUpdateReq_Snapshot
example:
name: name
description: description
SnapshotCreateReq:
type: object
required:
- block_snapshot
properties:
block_snapshot:
$ref: '#/components/schemas/SnapshotCreateReq_Snapshot'
title: SnapshotCreateReq
example:
block_snapshot:
block_volume_id: 0
name: name
description: description
securitySchemes:
tokenInHeader:
description: auth by token
type: apiKey
name: Xms-Auth-Token
in: header
tokenInQuery:
description: auth by token
type: apiKey
name: token
in: query