v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
File Shares

Create file share

post/cloud/v1/file_shares/{project_id}/{region_id}

Path parameters

project_idinteger required

Project ID

Example:1

Project ID

region_idinteger required

Region ID

Example:1

Region ID

Request body

OR

Example request

{
  "access": [
    {
      "access_mode": "ro",
      "ip_address": "10.0.0.1"
    }
  ],
  "name": "test-share-file-system",
  "network": {
    "network_id": "024a29e9-b4b7-4c91-9a46-505be123d9f8",
    "subnet_id": "91200a6c-07e0-42aa-98da-32d1f6545ae7"
  },
  "protocol": "NFS",
  "size": 5
}

Response

OK

tasksstring[] required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
idstring required

Example response

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}