UpgradeEngineVersion - Elasticsearch: Central de Documentação do Alibaba Cloud

Nota

É possível atualizar a versão da instância apenas nos seguintes caminhos: da versão 5.5.3 para a 5.6.16, da 5.6.16 para a 6.3.2 e da 6.3.2 para a 6.7.0. Para mais informações, consulte

Atualizar versão

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Cabeçalhos de requisição comuns.

Sintaxe da requisição

POST /openapi/instances/{InstanceId}/actions/upgrade-version 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.
clientToken	String	Query	Não	5A2CFF0E-5718-45B5-9D4D-70B3FF****	Token do cliente usado para garantir a idempotência da requisição. Gere esse valor no cliente, mas garanta que seja único entre requisições diferentes. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.
dryRun	Boolean	Query	Não	false	Indica se deve executar a verificação pré-atualização: true: executa a verificação false (padrão): não executa a verificação Aviso A verificação de atualização de versão analisa o YML do cluster, as configurações de plug-ins, o status do cluster, os índices e os recursos. Recomendamos fortemente executar a pré-verificação antes da atualização para evitar problemas durante o processo.
	Object	Body	Não		Corpo da requisição.
version	String	Body	Não	6.7	Versão mais recente. Se type for engineVersion, o valor corresponde à versão da instância (exemplo: 6.7). Se type for aliVersion, o valor corresponde à versão do kernel (exemplo: ali1.2.0).
type	String	Body	Não	engineVersion	Tipo de atualização. Valores válidos: engineVersion (padrão): atualização de versão principal aliVersion: atualização de versão do kernel

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	F99407AB-2FA9-489E-A259-40CF6DC*****	ID da requisição.
Result	Array of Result		Resultados da validação.
validateType	String	checkClusterHealth	Tipo de monitoramento. Valores válidos: checkClusterHealth: status de integridade do cluster checkConfigCompatible: status de compatibilidade de configuração checkClusterResource: status de espaço de recursos checkClusterSnapshot: existência de snapshot
validateResult	Array of validateResult		Informações de verificação.
errorType	String	clusterStatus	Tipo de erro. Valores válidos: clusterStatus: status de integridade do cluster clusterConfigYml: arquivo YML do cluster clusterConfigPlugins: arquivo de configuração do cluster clusterResource: recursos do cluster clusterSnapshot: snapshot do cluster
errorCode	String	ClusterStatusNotHealth	Código de erro retornado caso a requisição falhe.
errorMsg	String	The cluster status is not health	Mensagem de erro retornada.
status	String	success	Resultado da verificação. Valores válidos: success: aprovado failed: falhou

Exemplos

Exemplos de requisição

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/upgrade-version?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF****&dryRun=false HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "version" : "6.7",
  "type" : "engineVersion"
}

Exemplo de resposta de sucesso

Formato JSON

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

{
  "Result" : [ {
    "validateType" : "checkClusterHealth",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterStatus",
      "errorCode" : "ClusterStatusNotHealth",
      "errorMsg" : "ClusterStatusNotHealth"
    } ]
  }, {
    "validateType" : "checkConfigCompatible",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterConfigYml",
      "errorCode" : "ClusterYamlNotCompatible",
      "errorMsg" : "ClusterYamlNotCompatible"
    }, {
      "errorType" : "clusterConfigPlugins",
      "errorCode" : "ClusterPluginsNotSupport",
      "errorMsg" : "ClusterPluginsNotSupport"
    } ]
  }, {
    "validateType" : "checkClusterResource",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterResource",
      "errorCode" : "ClusterResourceNotEnough",
      "errorMsg" : "ClusterResourceNotEnough"
    } ]
  }, {
    "validateType" : "checkClusterSnapshot",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterSnapshot",
      "errorCode" : "ClusterSnapshotNotAvaild",
      "errorMsg" : "ClusterSnapshotNotAvaild"
    } ]
  } ],
  "RequestId" : "F99407AB-2FA9-489E-A259-40CF6DC****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.