全部產品
Search
文件中心

:ListProjects - 查詢所有專案資訊

更新時間:Feb 26, 2026

查詢所有專案(Project)的資訊,包含基礎資訊,資料集(Dataset)和檔案相關的統計資訊等。

介面說明

支援分頁查看返回資料:分頁查詢首頁時,僅需設定 MaxResults 以限制返回資訊的條目數,返回結果中的 NextToken 將作為查詢後續頁的憑證。查詢後續頁時,將 NextToken 參數設定為上一次返回結果中擷取到的 NextToken 作為查詢憑證,並設定 MaxResults 限制返回條目數。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

imm:ListProjects

list

*Project

acs:imm:{#regionId}:{#accountId}:project/*

請求參數

名稱

類型

必填

描述

樣本值

MaxResults

integer

返回專案的最大個數,取值範圍為 0~200。不設定此參數或者設定為 0 時,則預設值為 100。

100

NextToken

string

查詢憑證(Token),取值為上一次 API 呼叫返回的 NextToken 參數值。從 NextToken 開始按字典序返回專案資訊列表。第一次調用此介面時,設定為空白。

MTIzNDU2Nzg6aW1tdGVzdDAx

Prefix

string

列出指定首碼的專案,長度限制為 0~128 字元。

immtest

Tag

array<object>

標籤列表

object

標籤資訊

Key

string

標籤鍵

TestKey

Value

string

標籤值

TestValue

返回參數

名稱

類型

描述

樣本值

object

響應結構體。

NextToken

string

當預期返回的專案總數大於設定的 MaxResults 時,將作為查詢後續頁的憑證。只有當專案未全部返回時,此參數才有值。

MTIzNDU2Nzg6aW1tdGVzdDAx

Projects

array

由 Project 組成的數組格式,返回 Project 的資訊。

Project

專案資訊。

RequestId

string

請求 ID。

4A7A2D0E-D8B8-4DA0-8127-EB32C660

樣本

正常返回樣本

JSON格式

{
  "NextToken": "MTIzNDU2Nzg6aW1tdGVzdDAx",
  "Projects": [
    {
      "ProjectName": "immtest",
      "ServiceRole": "AliyunIMMDefaultRole",
      "TemplateId": "Official:ImageManagement",
      "CreateTime": "2021-06-29T14:50:13.011643661+08:00",
      "UpdateTime": "2021-06-29T14:50:13.011643661+08:00",
      "Description": "測試專案",
      "ProjectQueriesPerSecond": 100,
      "EngineConcurrency": 100,
      "ProjectMaxDatasetCount": 1000000000,
      "DatasetMaxBindCount": 10,
      "DatasetMaxFileCount": 100000000,
      "DatasetMaxEntityCount": 10000000000,
      "DatasetMaxRelationCount": 100000000000,
      "DatasetMaxTotalFileSize": 90000000000000000,
      "DatasetCount": 5,
      "FileCount": 10,
      "TotalFileSize": 100000,
      "Tags": [
        {
          "TagKey": "TestKey",
          "TagValue": "TestValue"
        }
      ]
    }
  ],
  "RequestId": "4A7A2D0E-D8B8-4DA0-8127-EB32C660"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情