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
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.
Código de status
Para obter mais informações, consulte Código de status.
Código de erro
Para obter mais informações, consulte Código de erro.