Criação de uma réplica de leitura
Função
Essa API é usada para criar uma réplica de leitura. Antes de chamar essa API:
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
POST /v3/{project_id}/instances/{instance_id}/nodes/enlarge
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
project_id | Sim | String | ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto. |
instance_id | Sim | String | ID da instância, que é compatível com o formato UUID. |
Parâmetros de solicitação
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
X-Auth-Token | Sim | String | Token do usuário. Para obter esse valor, chame a API do IAM para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o valor do token. |
X-Language | Não | String | Tipo de linguagem da solicitação. O valor padrão é en-us. Valores:
|
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
priorities | Sim | Array of integers | Prioridade de failover de uma réplica de leitura. A prioridade de failover varia de 1 para a primeira prioridade a 16 para a última prioridade. Esta prioridade determina a ordem na qual as réplicas de leitura são promovidas durante a recuperação de uma falha no nó primário. As réplicas de leitura com a mesma prioridade têm a mesma probabilidade de serem promovidas para o novo nó primário. Você pode configurar uma prioridade de failover para até 9 réplicas de leitura, e a prioridade padrão para as réplicas de leitura restantes é -1, indicando que essas réplicas de leitura não podem ser promovidas a primárias. Você pode alterar a prioridade de failover de uma réplica de leitura. |
is_auto_pay | Não | String | Se o pedido será pago automaticamente após a criação de instâncias anuais/mensais. Este parâmetro não afeta o método de pagamento de renovação automática.
|
availability_zones | Não | Array of strings | AZ. Você pode especificar uma AZ para criar uma réplica de leitura. Se esse parâmetro não for especificado, uma AZ será automaticamente atribuída por padrão. A função está na fase de teste beta aberto (OBT). Para usá-la, envie um tíquete de serviço. Para obter o valor, consulte a chave availability_zone em az_status de Consulta de especificações de banco de dados. Observação: a criação de uma réplica de leitura em uma AZ especificada pode falhar devido a recursos insuficientes. |
Parâmetros de resposta
Código de status: 201
Parâmetro | Tipo | Descrição |
|---|---|---|
instance_id | String | ID da instância. |
node_names | Array of strings | Nomes de nós. |
job_id | String | ID da tarefa para criar uma réplica de leitura. Esse parâmetro é retornado somente quando uma réplica de leitura de pagamento por uso é criada. |
order_id | String | ID do pedido. Este parâmetro é retornado quando réplicas de leitura anuais/mensais são criadas. |
Código de status: 400
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro. |
error_msg | String | Mensagem de erro. |
Código de status: 500
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro. |
error_msg | String | Mensagem de erro. |
Exemplo de solicitação
Criação de uma réplica de leitura para uma instância de BD
POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/nodes/enlarge
{
"priorities" : [ 1, 2 ]
} Exemplo de resposta
Código de status: 201
Bem-sucedido.
{
"instance_id" : "ba62a0b83a1b42bfab275829d86ac0fdin07",
"node_names" : [ "gauss-ccf5_node03" ],
"job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
} Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.
