Todos os produtos
Search

Este produto

    ApsaraDB for MongoDB:EvaluateResource

    Central de documentação

    ApsaraDB for MongoDB:EvaluateResource

    Última atualização: Oct 12, 2026

    Avalia se há recursos suficientes disponíveis antes de criar uma instância ou alterar as especificações de uma instância.

    Descrição da operação

    Esta operação avalia recursos para instâncias de conjunto de réplicas e cluster fragmentado do ApsaraDB for MongoDB. Ela oferece suporte à avaliação de recursos para a criação de instâncias de conjunto de réplicas e cluster fragmentado, alteração de especificações de instâncias e adição de nós a instâncias de cluster fragmentado.

    Nota

    Você pode chamar esta operação até 200 vezes por minuto. Exceder esse limite aciona a limitação de taxa.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    dds:EvaluateResource

    none

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região. Você pode chamar DescribeRegions para consultar as regiões disponíveis.

    cn-hangzhou
    ZoneId

    string

    Sim

    O ID da zona. Você pode chamar DescribeRegions para consultar as zonas disponíveis.

    cn-hangzhou-h
    Engine

    string

    Não

    O mecanismo de banco de dados. Defina o valor como MongoDB.

    MongoDB
    EngineVersion

    string

    Sim

    A versão do mecanismo de banco de dados.

    4.2
    DBInstanceClass

    string

    Não

    O tipo de instância.

    Nota

    Este parâmetro é obrigatório quando você avalia recursos para uma instância de conjunto de réplicas. Para obter mais informações sobre os tipos de instância, consulte Tipos de instância.

    dds.mongo.mid
    ShardsInfo

    string

    Não

    As informações de fragmento da instância de cluster fragmentado. Este parâmetro é obrigatório quando você avalia recursos para uma instância de cluster fragmentado.

    Ao avaliar recursos para uma nova instância de cluster fragmentado, você deve especificar as especificações de cada fragmento em uma string de caracteres formatada em JSON. Exemplo:

    {
     "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"}]
 }

    As descrições dos parâmetros no exemplo são as seguintes:

    • ConfigSvrs: os nós Configserver.

    • Mongos: os nós mongos.

    • Shards: os nós de fragmento.

    • Storage: a capacidade de armazenamento do fragmento de destino.

    • DBInstanceClass: o tipo de instância do fragmento de destino. Para obter mais informações, consulte Tipos de instância de cluster fragmentado.

    Ao avaliar recursos para fazer upgrade ou downgrade de uma instância de cluster fragmentado, você só precisa especificar as informações do nó em uma string de caracteres formatada em JSON. Exemplo:

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

    As descrições dos parâmetros no exemplo são as seguintes:

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

    string

    Não

    O ID da instância. Este parâmetro é obrigatório quando você avalia recursos para alterar as especificações da instância.

    dds-bp14bf67a76d****
    ReplicationFactor

    string

    Não

    O número de nós na instância.

    • Para uma instância autônoma, defina o valor como 1.

    • Para uma instância com armazenamento compartilhado, defina o valor como 2.

    • Para uma instância de conjunto de réplicas, os valores válidos são 3, 5 e 7.

    3
    ReadonlyReplicas

    string

    Não

    O número de nós somente leitura na instância. Valores válidos: 1 a 5.

    Nota

    Este parâmetro não é obrigatório para instâncias autônomas.

    1
    Storage

    string

    Não

    A capacidade de armazenamento da instância de conjunto de réplicas. Unidade: GB.

    Nota

    Este parâmetro é obrigatório quando a instância usa discos em nuvem.

    10

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    DBInstanceAvailable

    string

    Indica se há recursos suficientes disponíveis na região atual. Valores válidos:

    • 1: Recursos suficientes disponíveis.

    • 0: Recursos insuficientes disponíveis.

    1
    EngineVersion

    string

    A versão do mecanismo de banco de dados.

    4.0
    RequestId

    string

    O ID da solicitação.

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

    string

    O mecanismo de banco de dados. O valor é fixo como MongoDB.

    MongoDB

    Exemplos

    Resposta de sucesso

    JSON formato

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

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.