---
title: "测试存储引擎连通性"
method: POST
path: "/system/storage-engine-check"
tags: ["系统"]
---

# 测试存储引擎连通性

`POST /system/storage-engine-check`

使用当前填写的参数测试 MinIO/COS 连通性，不保存配置

## Request body

- InternalHandlerStorageCheckRequest
  - `cos` GithubComTencentWeKnoraInternalTypesCOSEngineConfig
    - `app_id` string
    - `bucket_name` string
    - `path_prefix` string
    - `region` string
    - `secret_id` string
    - `secret_key` string
  - `minio` GithubComTencentWeKnoraInternalTypesMinIOEngineConfig
    - `access_key_id` string
    - `bucket_name` string
    - `endpoint` string
    - `mode` string — "docker" or "remote"
    - `path_prefix` string
    - `secret_access_key` string
    - `use_ssl` boolean
  - `provider` string — "minio", "cos", "tos", or "s3"
  - `s3` GithubComTencentWeKnoraInternalTypesS3EngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `path_prefix` string
    - `region` string
    - `secret_key` string
  - `tos` GithubComTencentWeKnoraInternalTypesTOSEngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `path_prefix` string
    - `region` string
    - `secret_key` string

## Response `200`

OK

- InternalHandlerStorageCheckResponse
  - `bucket_created` boolean
  - `message` string
  - `ok` boolean

## Changes

- **2026-03-30** `08f8a25fbf1d` — 1 info
  - endpoint added
- **2025-12-16** `edf61e68559d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/system/storage-engine-check/post.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/08f8a25fbf1d/schema)