List available storage policies

GET

/user/setting/policies

List available storage policies for authenticated user.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

data

array[object (StoragePolicy) {8}] | null

optional

Response content. In some error type, e.g. lock conflicting errors, this field wil present details of the error, e.g. who is locking the current file.

string

required

ID of the storage policy.

Example:

96u1

name

string

required

Display name of the storage policy.

Example:

Default storage policy

allowed_suffix

array[string] | null

optional

List of file extensions allowed in this storage policy. Empty list means no limit.

type

enum<string>

required

Storage provider type.

Allowed values:

localqiniuupyunosscoss3onedriveremoteobsload_balance

Example:

local

max_size

number

required

Max allowed size of a single file. 0 means no limit.

relay

boolean | null

optional

Indicates whether upload needs to be proxyed by Cloudreve. If true, the client should treat it as a local storage policy to process uploading.

weight

number | null

optional

Load balance weight of this storage policy. Only presented if this storage policy is child of a load balance storage policy.

children

array[object (StoragePolicy) {8}] | null

optional

Child storage policies, only presented if policy type equals load_balance.

code

integer

required

Response code.
0 - Success.

Default:

Example:

msg

string

optional

Human readable error message (if any).

error

string | null

optional

Internal error message, only visable in debug mode.

correlation_id

string <uuid> | null

optional

Correlation ID of the request. Only presented on failed reqeust.

Example:

b4351ecc-ee1a-4455-bc94-2c3dbcc58538

Example

{
    "code": 0,
    "data": [
        {
            "id": "B1Fy",
            "name": "Minio",
            "type": "s3",
            "max_size": 0
        },
        {
            "id": "mqHp",
            "name": "Cloudflare R2",
            "type": "s3",
            "max_size": 0
        },
        {
            "id": "0dsD",
            "name": "Google Cloud Storage",
            "type": "s3",
            "max_size": 0
        },
        {
            "id": "NrTZ",
            "name": "Qiniu",
            "type": "qiniu",
            "max_size": 0,
            "relay": true
        }
    ],
    "msg": ""
}

Modified at 2025-06-27 03:08:29

Delete passkey

List available nodes