Todos os produtos
Search

Este produto

    ApsaraDB for MongoDB:EvaluateResource

    Central de documentação

    ApsaraDB for MongoDB:EvaluateResource

    Última atualização: Jun 28, 2026

    Avalia a disponibilidade de recursos antes de comprar uma nova instância ou alterar a configuração de uma instância existente.

    Descrição da operação

    Avalia a disponibilidade de recursos para instâncias de conjunto de réplicas e instâncias de cluster fragmentado do MongoDB. Os cenários suportados incluem a compra de uma nova instância, a alteração da configuração de uma instância e a adição de nós a um cluster fragmentado.

    Nota

    Você pode chamar esta operação até 200 vezes por minuto. As chamadas que excederem esse limite estarão sujeitas à limitação de tráfego.

    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. Para mais informações, consulte DescribeRegions.

    cn-hangzhou
    ZoneId

    string

    Sim

    O ID da zona. Para mais informações, consulte DescribeRegions.

    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 detalhes sobre os tipos de instância, consulte Tipos de instância.

    dds.mongo.mid
    ShardsInfo

    string

    Não

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

    Para avaliar recursos para uma nova instância de cluster fragmentado, especifique o tipo de instância para cada fragmento em uma string 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"}]
 }

    Os parâmetros no exemplo são descritos da seguinte forma:

    • ConfigSvrs: Os nós ConfigServer.

    • Mongos: Os nós Mongos.

    • Shards: Os nós de fragmento.

    • Storage: O espaço de armazenamento do fragmento de destino.

    • DBInstanceClass: O tipo de instância do fragmento de destino. Para obter detalhes sobre os tipos de instância, consulte Tipos de instância de cluster fragmentado.

    Para avaliar recursos para o upgrade ou downgrade de uma instância de cluster fragmentado, especifique apenas as informações do nó em uma string JSON. Exemplo:

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

    Os parâmetros no exemplo são descritos da seguinte forma:

    {"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 um upgrade ou downgrade de instância.

    dds-bp14bf67a76d****
    ReplicationFactor

    string

    Não

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

    • Defina o valor como 1 para uma instância independente.

    • Defina o valor como 2 para uma instância que usa armazenamento compartilhado.

    • 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 independentes.

    1
    Storage

    string

    Não

    O espaço de armazenamento do conjunto de réplicas. Unidade: GB.

    Nota

    Este parâmetro é obrigatório se a instância usar discos em nuvem.

    10

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    DBInstanceAvailable

    string

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

    • 1: Os recursos são suficientes.

    • 0: Os recursos são insuficientes.

    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.