Todos os produtos
Search
Central de documentação

Elasticsearch:AddSnapshotRepo

Última atualização: Jun 27, 2026

Cria um repositório OSS compartilhado para um cluster.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Cabeçalhos da requisição

Esta operação não possui cabeçalhos específicos e utiliza apenas os cabeçalhos comuns. Para mais informações, consulte a documentação dos parâmetros de requisição comuns.

Sintaxe da requisição

POST /openapi/instances/{InstanceId}/snapshot-repos HTTP/1.1

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

InstanceId

String

Path

Sim

es-cn-n6w1o1x0w001c****

ID da instância de destino. Defina o ID da instância do repositório OSS entre clusters.

String

Body

Não

{ "repoPath" :"es-cn-4591jumei000u****" }

Especifica as informações de backup entre clusters, ou seja, a instância de referência indicada.

RequestBody

Especifique também os seguintes parâmetros no RequestBody para definir as informações de backup entre clusters, isto é, a instância de referência.

Header

Tipo

Obrigatório

Exemplo

Descrição

repoPath

String

Sim

es-cn-4591jumei000u****

Instância source cujos dados serão restaurados. Obtenha as informações do parâmetro. Para mais detalhes, consulte ListAlternativeSnapshotRepos. Após especificar o snapshot, o Elasticsearch cria um repositório de referência de snapshot para a instância source, permitindo a restauração de dados.

A instância source e a instância de destino devem atender aos seguintes requisitos:

Ambas devem estar na mesma região e pertencer à mesma conta. A versão da instância source deve ser igual ou inferior à da instância de destino. Para mais informações, consulte Configurar um repositório OSS entre clusters.

Veja o exemplo de código a seguir.

{
    "repoPath" :"es-cn-4591jumei000u****"
}

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Result Boolean true

Resultado retornado:

  • true: Repositório de referência criado com sucesso.
  • false: Falha na criação do repositório de referência.
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

ID da requisição.

Exemplos

Exemplos de requisições

POST /openapi/instances/es-cn-n6w1o1x0w001c****/snapshot-repos HTTP/1.1
{
    "repoPath" :"es-cn-4591jumei000u****"
}

Exemplos de respostas de sucesso

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : true,
  "RequestId" : "D21379E3-A54E-4C86-A64C-3717365F****"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Mensagem de erro

400

InstanceActivating

Instance is activating.

A instância está em ativação.

400

InstanceNotFound

The instanceId provided does not exist.

Instância não encontrada. Verifique o status da instância.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.