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> Expansão do espaço de armazenamento

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

Ver PDF

Expansão do espaço de armazenamento

Descrição da API

Essa API é usada para expandir o espaço de armazenamento de uma instância de banco de dados.

Restrições

Essa API é compatível com instâncias de banco de dados anuais/mensais e de pagamento por uso.

Depuração

Você pode depurar essa API no API Explorer.

URI

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

**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
volume	Object	Sim	As informações detalhadas sobre a solicitação de volume. Para obter mais informações, consulte Tabela 3.
is_auto_pay	Boolean	Não	Se o pedido é pago automaticamente da sua conta quando você aumenta o armazenamento de 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
group_id	String	Não	A ID da função. Para uma instância de cluster, esse parâmetro é definido como o ID do grupo de estilhaços. Esse parâmetro não é transferido para instâncias do conjunto de réplicas.
size	String	Sim	A capacidade de disco solicitada. O valor deve ser um múltiplo inteiro de 10 e maior que o espaço de armazenamento atual. Em uma instância de cluster, esse parâmetro indica o espaço de armazenamento dos nós de shard. O intervalo de valores é de 10 GB a 2000 GB. Em uma instância de conjunto de réplicas, esse parâmetro indica a capacidade de disco da instância de banco de dados a ser expandida. O intervalo de valores é de 10 GB a 3000 GB. Em uma instância de nó único, esse parâmetro indica a capacidade de disco da instância de banco de dados a ser expandida. O intervalo de valores é de 10 GB a 1000 GB.
node_ids	Array of strings	Não	Esse parâmetro é necessário quando a capacidade do disco da réplica de leitura de uma instância do conjunto de réplicas é expandida. Apenas um elemento pode ser transferido na lista.

Exemplo de solicitação

Clusters:

POST https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/enlarge-volume 
  
 { 
   "volume" : { 
     "group_id" : "1b0c008adbcb495c81a3d5762a02a2abgr02", 
     "size" : 20 
   } 
 }

Conjuntos de réplicas:

POST https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/enlarge-volume 
  
 { 
   "volume" : { 
     "size" : 20 
   } 
 }

Nós únicos:

POST https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/enlarge-volume 
  
 { 
   "volume" : { 
     "size" : 20 
   } 
 }

Réplica de leitura de uma instância do conjunto de réplicas.
POST https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3ein02/enlarge-volume

{

"volume" : {

"size" : 20,

"node_ids" : [ "8f643d252d834a4c916b2db4322f9955in02" ]

}

}

Respostas

Descrição do parâmetro

**Tabela 4** Descrição do parâmetro
Nome	Tipo	Obrigatório	Descrição
job_id	String	Sim	A ID da tarefa.
order_id	String	Não	O ID do pedido. Esse parâmetro é retornado somente quando a capacidade de armazenamento de uma instância de banco de dados anual/mensal é expandida.

Exemplo de resposta

{
     "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890" 
}

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.