Criação de um snapshot

Função

Essa API é usada para criar snapshots para um cluster especificado.

Depuração

Você pode depurar essa API no Explorador da API.

URI

• Formato URI

  POST /v1.0/{project_id}/snapshots

• Descrição do parâmetro

  Tabela 1 Parâmetros URI

  Parâmetro	Obrigatório	Tipo	Descrição
  project_id	Sim	String	Project ID. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID do projeto.

Mensagem de solicitação

• Exemplo de solicitação

  POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots
  
  {
    "snapshot" : {
      "name" : "snapshot-3",
      "cluster_id" : "44b277eb-39be-4921-be31-3d61b43651d7",
      "description" : "Snapshot-3 description"
    }
  }

• Descrição do parâmetro

  Tabela 2 Parâmetros de solicitação

  Parâmetro	Obrigatório	Tipo	Descrição
  snapshot	Sim	Snapshot object	Objeto Snapshot.

  Tabela 3 Captura

  Parâmetro	Obrigatório	Tipo	Descrição
  name	Sim	String	Nome do instantâneo, que deve ser exclusivo e começar com uma letra. Consiste de 4 a 64 caracteres, que não diferencia maiúsculas de minúsculas e contêm letras, dígitos, hífens (-) e sublinhados (_) apenas.
  cluster_id	Sim	String	ID do cluster para o qual você deseja criar um snapshot. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de ID de cluster.
  description	Não	String	Descrição do snapshot. Se nenhum valor for especificado, a descrição ficará vazia. Insira um máximo de 256 caracteres. Os seguintes caracteres especiais não são permitidos: !<>'=&"

Mensagem de resposta

• Exemplo de resposta

  {
      "snapshot": {
          "id": "2a4d0f86-67cd-408a-8b66-017454fb7793"
      }
  }

• Descrição do parâmetro

  Tabela 4 Descrição do parâmetro de resposta

  Parâmetro	Tipo	Descrição
  snapshot	SnapshotResp object	Objeto de snapshot

  Tabela 5 SnapshotResp

  Parâmetro	Tipo	Descrição
  id	String	ID do snapshot

Código de status

• Normal

  200

• Exceção

  Tabela 6 Valores retornados

  Valor retornado	Descrição
  400 Bad Request	Erro na solicitação.
  401 Unauthorized	Autenticação falhou.
  403 Forbidden	Sem permissão de operação.
  404 Not Found	Nenhum recurso encontrado.
  500 Internal Server Error	Erro de serviço interno.
  503 Service Unavailable	Serviço não está disponível.