Criação de um backup manual
Função
Essa API é usada para criar um backup manual. Antes de chamar essa API:
Esta API estará indisponível em 31 de março de 2024. É aconselhável mudar as cargas de trabalho para a nova API (Criação de um backup manual) antes disso.
- Saiba como autorizá-la e autenticá-la.
- Obtenha a região e o ponto de extremidade necessários.
URI
- Formato de URI
POST https://{endpoint}/mysql/v3/{project_id}/backups/create
- Exemplo
POST https://{endpoint}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/backups/create
- Descrição do parâmetro
Tabela 1 Descrição do parâmetro Nome
Obrigatório
Descrição
project_id
Sim
ID do projeto de um locatário em uma região.
Para obter esse valor, consulte Obtenção de um ID de projeto.
Solicitação
Nome |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
instance_id |
Sim |
String |
ID da instância, que é compatível com o formato UUID. |
name |
Sim |
String |
Nome do backup. O valor consiste de 4 a 64 caracteres e começa com uma letra. Ele diferencia maiúsculas de minúsculas e contém apenas letras, dígitos, hifens (-) e sublinhados (_). |
description |
Não |
String |
Descrição do backup. Ela contém um máximo de 256 caracteres e não pode conter os caracteres especiais (>!<"&'=) |
- Exemplo de solicitação
{ "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "name": "backup-1", "description": "manual backup" }
Resposta
- Resposta normal
Tabela 3 Descrição do parâmetro Nome
Tipo
Descrição
backup
Object
Informações de backup.
Para mais detalhes, consulte Tabela 4.
Tabela 4 Descrição da estrutura de dados do campo de backup Nome
Tipo
Descrição
id
String
ID de backup.
name
String
Nome do backup.
description
String
Descrição do backup.
begin_time
String
Hora de início do backup no formato "yyyy-mm-ddThh:mm:ssZ", em que "T" indica a hora de início do campo de tempo e "Z" indica o deslocamento do fuso horário.
status
String
Status do backup. Valor:
- BUILDING: backup em andamento
- COMPLETED: backup concluído
- FAILED: falha no backup
- AVAILABLE: backup disponível
type
String
Tipo de backup. Valor:
- manual: backup completo manual
instance_id
String
ID da instância de BD.
- Exemplo de resposta normal
{ "backup": { "id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe", "name": "backup-1", "begin_time": "2020-07-07T01:17:05+0800", "status": "BUILDING", "type": "manual", "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01", "description": "desc" } }
Código de status
Para mais detalhes, consulte Códigos de status.
Código de erro
Para mais detalhes, consulte Códigos de erro.