获取 SFTP 连接

POST

/api/storage/nas/v1/sftp/obtain

接口说明

当前版本	旧版本	是否需要加密	是否需要加签
v1.0.0	-	否	是

描述

获取指定卷的 SFTP 会话，可重复调用。status 为 Running 时返回连接信息；为 Pending 时表示开通中，请稍后再次查询。
加签详见：加签流程

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "storage_id": 1001
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.suanli.cn/api/storage/nas/v1/sftp/obtain' \
--header 'token: a69abd35-1df0-4c21-9c2b-82a20a72d3b2-20260417200925' \
--header 'timestamp: {{$date.millisecondsTimestamp}}' \
--header 'version: 1.0.0' \
--header 'sign_str;' \
--header 'Content-Type: application/json' \
--data '{
    "storage_id": 1001
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": "0000",
    "message": "success",
    "data": {
        "id": 1,
        "status": "Running",
        "username": "sftp_user",
        "password": "example-password",
        "sftp_url": "sftp.example.com:22",
        "web_url": "sftp.example.com:80",
        "webdav_url": "sftp.example.com:81",
        "expire_at": "2026-07-09 12:00:00",
        "error_code": null,
        "error_message": null
    }
}

校验对象存储连接

关闭 SFTP 连接

获取 SFTP 连接

接口说明#

描述#

请求参数

请求示例代码

返回响应

接口说明

描述