全部产品
Search
文档中心

运维安全中心(堡垒机):ListProjects - 查询项目列表

更新时间:Aug 14, 2026

查询项目列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

堡垒机实例的 ID。

说明

您可以调用 DescribeInstances 接口获取该参数。

bastionhost-cn-st220aw****

RegionId

string

堡垒机的区域 ID。

说明

区域 ID 和区域名称的对应关系,请参见地域和可用区

cn-hangzhou

NextToken

string

游标查询下次查询所需的 Token。

说明

首次查询时留空,下次请求时传上次查询返回值中的 NextToken 字段值。

42bc833a0a0002dae0b5e8707e68181f

MaxResults

integer

要查询的条数。不填时默认查询 20 条。单次最多查询 100 条。

20

Keyword

string

要查询的项目名称。模糊查询。

test

Skip

integer

跳过数量。

说明

仅在 NextToken 取值为空时生效。

2

返回参数

名称

类型

描述

示例值

object

Schema of Response

TotalCount

integer

查询到的项目总数。

10

NextToken

string

下一个查询开始的 Token。

4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****

MaxResults

integer

请求参数中传了有效 MaxResults 时返回请求时所传的值,否则返回默认值。

20

RequestId

string

阿里云为该请求生成的唯一标识符。

81500666-d7f5-4143-8329-0223cc738105

Projects

array<object>

项目列表信息。

object

项目信息。

ProjectId

integer

项目 ID。

3

Name

string

项目名称。

Project_name

Description

string

项目备注。

comment

IsDefault

boolean

是否为 Default 项目。取值:

  • true:是。

  • false:否。

false

MemberIds

array

项目中关联的成员账号 UID 列表。

string

项目中关联的成员账号 UID。

170****9123

HostCount

integer

项目中的主机总数。

21

DatabaseCount

integer

项目中的数据库实例总数。

1

AppCount

integer

项目中的应用总数。

0

示例

正常返回示例

JSON格式

{
  "TotalCount": 10,
  "NextToken": "4ieSWJCwxvW3dk3wF.BqkrZmP72nWu5zJ5NWydMqyEs****",
  "MaxResults": 20,
  "RequestId": "81500666-d7f5-4143-8329-0223cc738105",
  "Projects": [
    {
      "ProjectId": 3,
      "Name": "Project_name",
      "Description": "comment",
      "IsDefault": false,
      "MemberIds": [
        "170****9123"
      ],
      "HostCount": 21,
      "DatabaseCount": 1,
      "AppCount": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情