全部產品
Search

搜尋本產品

    ApsaraDB for MongoDB：EvaluateResource - 評估是否有足夠的資源

    文件中心

    ApsaraDB for MongoDB：EvaluateResource - 評估是否有足夠的資源

    更新時間：Jan 30, 2026

    在新購執行個體或對執行個體進行變更配置之前，評估是否有足夠的資源。

    介面說明

    本介面適用於 MongoDB 複本集、分區叢集資源的評估。支援對複本集和分區叢集的新購、變更配置，以及分區叢集新增節點進行資源評估。

    說明

    本介面每分鐘調用不得超過 200 次，超出會被限制流量。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dds:EvaluateResource

    none

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID，您可以調用 DescribeRegions 查詢。

    cn-hangzhou
    ZoneId

    string

    是

    可用性區域 ID，您可以調用 DescribeRegions 查詢。

    cn-hangzhou-h
    Engine

    string

    否

    資料庫引擎，取值：MongoDB。

    MongoDB
    EngineVersion

    string

    是

    資料庫版本號碼。

    枚舉值：

    • 4.0 :

      4.0

    • 5.0 :

      5.0

    • 4.2 :

      4.2

    • 6.0 :

      6.0

    • 3.4 :

      3.4

    • 7.0 :

      7.0

    • 4.4 :

      4.4

    • 8.0 :

      8.0

    4.2
    DBInstanceClass

    string

    否

    執行個體規格。

    說明

    評估複本集資源時必須配置該參數，規格詳情請參見執行個體規格表。

    dds.mongo.mid
    ShardsInfo

    string

    否

    分區叢集的分區資訊，評估分區叢集資源時必須配置該參數。

    評估新購分區叢集資源時，需指定每個分區的規格，格式為 JSON 格式字串。樣本如下：

    {
     "ConfigSvrs":
         [{"Storage":20,"DBInstanceClass":"dds.cs.mid"}],
     "Mongos":
         [{"DBInstanceClass":"dds.mongos.standard"},{"DBInstanceClass":"dds.mongos.standard"}],
     "Shards":
         [{"Storage":50,"DBInstanceClass":"dds.shard.standard"},{"Storage":50,"DBInstanceClass":"dds.shard.standard"},   {"Storage":50,"DBInstanceClass":"dds.shard.standard"}]
 }

    樣本中參數說明如下：

    • ConfigSvrs：ConfigServer 節點。

    • Mongos：Mongos 節點。

    • Shards：Shard 節點。

    • Storage：指定目標分區的儲存空間。

    • DBInstanceClass：指定目標分區的規格，規格詳情請參見分區叢集執行個體規格表。

    評估分區叢集變更配置資源時，僅需指定節點資訊即可，格式為 JSON 格式字串。樣本如下：

    {
     "NodeId": "d-bp147c4d9ca7****", "NodeClass": "dds.shard.standard"
}

    樣本中參數說明如下：

    {"NodeId": "d-bp147c4d9ca7****", "NodeClass": "dds.shard.standard"}
    DBInstanceId

    string

    否

    執行個體 ID，評估變更配置資源時必須配置該參數。

    dds-bp14bf67a76d****
    ReplicationFactor

    string

    否

    設定執行個體的節點個數。

    • 單節點執行個體取值固定為 1。

    • 共用儲存版執行個體取值固定為 2。

    • 複本集執行個體取值為 3，5，7。

    3
    ReadonlyReplicas

    string

    否

    設定執行個體中唯讀節點的個數，取值範圍為 1~5。

    說明

    單節點執行個體不需要配置該參數。

    1
    Storage

    string

    否

    複本集的儲存空間，單位為 GB。

    說明

    執行個體規格為雲端硬碟型時，該參數必填。

    10

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    DBInstanceAvailable

    string

    展示目前範圍是否有可用的資源。傳回值：

    • 1：資源足夠。

    • 0：資源不足。

    1
    EngineVersion

    string

    資料庫版本號碼。

    4.0
    RequestId

    string

    請求 ID。

    AE2DE465-E45F-481F-ABD8-37D64173****
    Engine

    string

    資料庫引擎，固定為 MongoDB。

    MongoDB

    樣本

    正常返回樣本

    JSON格式

    {
  "DBInstanceAvailable": "1",
  "EngineVersion": "4.0",
  "RequestId": "AE2DE465-E45F-481F-ABD8-37D64173****",
  "Engine": "MongoDB"
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。