Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Gerenciamento de instâncias de banco de dados/ Adição de nós para uma instância de cluster

Atualizado em 2023-05-06 GMT+08:00

Ver PDF

Adição de nós para uma instância de cluster

Descrição da API

Essa API é usada para adicionar nós para uma instância de cluster especificada.

Restrições

Essa API é compatível com instâncias de banco de dados anuais/mensais e de pagamento por uso.
Apenas os nós mongos e shard podem ser adicionados.
As especificações do novo nó devem ser as mesmas dos nós existentes na instância.
A série de especificações inclui uso geral (s6), aprimorado (c3) e aprimorado II (c6).
Exemplo:
- dds.mongodb.s6.large.4.mongos e dds.mongodb.s6.medium.4.mongos têm as mesmas especificações.
- dds.mongodb.s6.large.4.mongos e dds.mongodb.c3.large.4.mongos não são das mesmas especificações.

Depuração

Você pode depurar essa API no API Explorer.

URI

Formato de URI
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/enlarge
Exemplo de URI
https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/enlarge

**Tabela 1** Parâmetros de solicitação
Nome	Tipo	IN	Obrigatório	Descrição
x-auth-token	string	header	Sim	Token do usuário
project_id	string	path	Sim	ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id	string	path	Sim	ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

Solicitações

Descrição do parâmetro

**Tabela 2** Descrição do parâmetro
Nome	Tipo	Obrigatório	Descrição
type	String	Sim	Tipo do objeto a ser dimensionado. Defina o valor como mongos se os nós de mongos forem adicionados. Defina o valor como shard se os nós de shard forem adicionados.
spec_code	String	Sim	O código de especificação do recurso. Para obter detalhes sobre como obter o código de especificação do recurso, consulte o parâmetro flavors.spec_code em Consulta de especificações do banco de dados.
num	String	Sim	O número de mongos ou nós de shard a serem adicionados. Uma instância de cluster suporta até 32 nós de mongos e 32 nós de shard.
volume	Object	Não	A informação do volume. Para obter mais informações, consulte Tabela 3. Este parâmetro não é transferido quando os nós mongos devem ser adicionados. Este parâmetro é obrigatório quando os nós de shard devem ser adicionados. NOTA: Se vários estilhaços forem adicionados simultaneamente, os estilhaços devem ter as mesmas especificações e capacidade do disco.
is_auto_pay	Boolean	Não	Se o pedido é pago automaticamente da sua conta quando você adiciona nós a uma instância de banco de dados anual/mensal. Este parâmetro não afeta o modo de pagamento da renovação automática. true: indica que o pedido é pago automaticamente a partir da conta. false: indica que o pedido é pago manualmente a partir da conta. O valor padrão é false.

**Tabela 3** Descrição da estrutura de dados do campo volume
Nome	Tipo	Obrigatório	Descrição
size	String	Sim	A capacidade do disco de todos os novos estilhaços. O intervalo de valores é de 10 GB a 2000 GB.

Exemplo de solicitação

Número de nós de mongos a serem adicionados:

{ 
	"type": "mongos",
	"spec_code":"dds.mongodb.c6.medium.4.mongos",
	"num": 1
}

Número de nós de shard a serem adicionados:

{
	"type": "shard",
	"spec_code":"dds.mongodb.c6.medium.4.shard",
	"num": 1,
        "volume": { 
             "size": 330 
    }
}

Respostas

Descrição do parâmetro

**Tabela 4** Descrição do parâmetro
Nome	Tipo	Obrigatório	Descrição
job_id	String	Sim	Indica a ID da tarefa.
order_id	String	Não	O ID do pedido. Este parâmetro é retornado somente quando os nós de uma instância de banco de dados anual/mensal são adicionados.

Exemplo de resposta

{ 
    "job_id": "4008c8914b624785a02ab7966d4d" 
}

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.