file-storage

Create share

Creates a new service share by given {service_uuid}.

post/1.3/file-storage/{service-uuid}/shares

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/file-storage/{service-uuid}/shares
  • Auth: HTTP bearer

Path parameters

service-uuidstring uuid required

The unique identifier.

Example:17fd43a5-a97e-44f7-98a8-0a787da67069

Service UUID

Request body

namestring required

A resource name.

pathstring required

The absolute path of the share.

Example request

{
  "name": "read",
  "path": "/public",
  "acl": [
    {
      "name": "test-name",
      "target": "192.168.147.0/24",
      "permission": "ro"
    }
  ]
}

Response

Success

namestring
pathstring

Example response

{
  "acl": [
    {
      "name": "test-name",
      "permission": "rw",
      "target": "*"
    }
  ],
  "name": "write",
  "path": "/project/data"
}

Changes

No recorded changes to this operation across all 1 revision of this API.