---
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
    - `temp_bucket_name` string
    - `temp_region` string
  - `ks3` GithubComTencentWeKnoraInternalTypesKS3EngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `path_prefix` string
    - `region` 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
  - `obs` GithubComTencentWeKnoraInternalTypesOBSEngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `path_prefix` string
    - `region` string
    - `secret_key` string
    - `use_ssl` boolean
  - `oss` GithubComTencentWeKnoraInternalTypesOSSEngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `path_prefix` string
    - `region` string
    - `secret_key` string
    - `temp_bucket_name` string
    - `temp_region` string
    - `use_temp_bucket` boolean
  - `provider` string — "minio", "cos", "tos", "s3", "oss", "ks3", "obs"
  - `s3` GithubComTencentWeKnoraInternalTypesS3EngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `force_path_style` boolean
    - `path_prefix` string
    - `region` string
    - `secret_key` string
    - `use_ssl` boolean
  - `tos` GithubComTencentWeKnoraInternalTypesTOSEngineConfig
    - `access_key` string
    - `bucket_name` string
    - `endpoint` string
    - `path_prefix` string
    - `region` string
    - `secret_key` string
    - `temp_bucket_name` string
    - `temp_region` string

## Response `200`

OK

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

## Changes

> 62 revisions in range; 11 could not be searched.

- **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/a5ce73ad8921/schema)