Share ACLs

Access Control Lists (ACLs) define which IP addresses or networks can access file storage shares and with what permissions. Each ACL entry specifies a target (IP, CIDR, or wildcard) and permission level.

GET/1.3/file-storage/{service_uuid}/shares/{share_name}/acl

List ACL entries

Returns a list of ACL entries for a share.

Request

GET

/1.3/file-storage/{service_uuid}/shares/{share_name}/acl

curl -X GET https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/shares/public/acl \
  -u your_username:your_password

GET/1.3/file-storage/{service_uuid}/shares/{share_name}/acl/{acl_name}

Get ACL entry details

Returns details of a specific ACL entry.

Request

GET

/1.3/file-storage/{service_uuid}/shares/{share_name}/acl/{acl_name}

curl -X GET https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/shares/public/acl/read-access \
  -u your_username:your_password

POST/1.3/file-storage/{service_uuid}/shares/{share_name}/acl

Create ACL entry

Creates a new ACL entry for a share.

Attributes

Name
name
Type
string
Description
ACL entry name (1-64 chars, alphanumeric with - and _).
Name
target
Type
string
Description
IP address, CIDR range, or "*" for all sources.
Name
permission
Type
string
Description
Access permission: "ro" (read-only) or "rw" (read-write).

Request

POST

/1.3/file-storage/{service_uuid}/shares/{share_name}/acl

curl -X POST https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/shares/public/acl \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "name": "office-network",
    "target": "192.168.1.0/24",
    "permission": "rw"
  }'

PATCH/1.3/file-storage/{service_uuid}/shares/{share_name}/acl/{acl_name}

Modify ACL entry

Modifies an existing ACL entry. Uses JSON Merge Patch semantics.

Attributes

Name
name
Type
string
Description
Updated ACL entry name.
Name
target
Type
string
Description
Updated target IP, CIDR, or wildcard.
Name
permission
Type
string
Description
Updated permission: "ro" or "rw".

Request

PATCH

/1.3/file-storage/{service_uuid}/shares/{share_name}/acl/{acl_name}

curl -X PATCH https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/shares/public/acl/office-network \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "target": "192.168.0.0/16",
    "permission": "ro"
  }'

DELETE/1.3/file-storage/{service_uuid}/shares/{share_name}/acl/{acl_name}

Delete ACL entry

Deletes an ACL entry from a share.

Request

DELETE

/1.3/file-storage/{service_uuid}/shares/{share_name}/acl/{acl_name}

curl -X DELETE https://api.upcloud.com/1.3/file-storage/0ad24fe5-d08a-44ea-a0a8-169a46e0cc90/shares/public/acl/office-network \
  -u your_username:your_password