全部产品
Search

搜索本产品

    云数据库 MongoDB：EvaluateResource - 评估是否有足够的资源

    文档中心

    云数据库 MongoDB：EvaluateResource - 评估是否有足够的资源

    更新时间：Jan 17, 2023

    在新购实例或对实例进行变配之前，评估是否有足够的资源。

    接口说明

    本接口适用于MongoDB副本集、分片集群资源的评估。支持评估新购资源以及副本集、分片集群或单个分片的变配。

    说明 本接口每分钟调用不得超过200次，超出会被限制流量。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作 访问级别 资源类型 条件关键字 关联操作
    dds:EvaluateResource READ
    • MongoDB
      acs:dds:{#regionId}:{#accountId}:dbinstance/*
      无
    		无

    请求参数

    名称 类型 必填 描述 示例值
    RegionId string 是

    地域ID，您可以调用DescribeRegions查询。

    		 cn-hangzhou
    ZoneId string 是

    可用区ID，您可以调用DescribeRegions查询。

    		 cn-hangzhou-h
    Engine string 否

    数据库引擎，取值：MongoDB。

    		 MongoDB
    EngineVersion string 是

    数据库版本号。取值如下：

    • 6.0
    • 5.0
    • 4.4
    • 4.2
    • 4.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。

    • 副本集实例取值为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"
}

    错误码

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