查询仓库列表

最近更新时间: 2026-10-11 00:12:04

1. 接口描述

接口请求域名： tsf.api3.fincloud.tencent.com。

查询仓库列表

默认接口请求频率限制：20次/秒。

接口更新时间：2026-02-09 13:24:43。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeRepositories
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Limit	否	否	Uint64	返回数量限制，大于0，默认为不分页示例值： 10
RepositoryType	否	否	String	仓库类型（默认仓库：default，私有仓库：private，公共仓库：public-demo）示例值： public
SearchWord	否	否	String	查询关键字（按照仓库名称搜索）示例值： demo
Offset	否	否	Uint64	查询起始偏移，大于等于0，默认值为0 示例值： 0

3. 输出参数

参数名称	类型	描述
Result	RepositoryList	符合查询仓库信息列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter.ParamError	参数错误。
InternalError.RuntimeError	仓库内部错误。
UnsupportedOperation.UnsupportAction	不支持的ACTION。。

5. 示例

示例1 获取所有仓库列表

输入示例

https://tsf.api3.fincloud.tencent.com/?Action=DescribeRepositories
&Offset=0
&Limit=20
&SearchWord=demo
&RepositoryType=default
&<Common Parameters>

输出示例

{
  "Response": {
    "Result": {
      "TotalCount": 0,
      "Content": [
        {
          "RepositoryId": "repo-6a79x94v",
          "RepositoryName": "repo-mock",
          "RepositoryType": "cos",
          "RepositoryDesc": "this is a desc",
          "IsUsed": true,
          "CreateTime": "2019-12-20 09:33:22",
          "BucketName": "testBucket",
          "BucketRegion": "ap-gz",
          "Directory": "/app"
        }
      ]
    },
    "RequestId": "96561cf1-738a-47d6-943b-dec7ebbccabe"
  }
}