Todos os produtos
Search
Central de documentação

Elasticsearch:InstallLogstashSystemPlugin

Última atualização: Jun 27, 2026

Instala um plug-in.

Antes de chamar esta operação, observe o seguinte:

Os plug-ins a serem instalados devem constar na lista de Plug-ins padrão do sistema do Alibaba Cloud Logstash. O sistema não oferece suporte a plug-ins open-source externos.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

A operação GetLogs não possui cabeçalhos de requisição específicos e utiliza apenas cabeçalhos comuns. Para mais informações, consulte a seção "Cabeçalhos comuns de requisição" no tópico "Cabeçalhos HTTP comuns" na Referência da API.

Sintaxe da requisição

POST /openapi/logstashes/{InstanceId}/plugins/system/actions/install HTTP/1.1

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

InstanceId

String

Path

Sim

ls-cn-oew1qbgl****

O 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. Use o cliente para gerar o valor, mas certifique-se de que ele seja único entre diferentes requisições. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres.

RequestBody

No RequestBody, insira também o nome do plug-in a ser instalado no formato ["pluginName1","pluginName2",.."pluginNamen"]. Exemplo:


[
    "logstash-input-datahub",
    "logstash-input-maxcompute"
]

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

F99407AB-2FA9-489E-A259-40CF6DCC4****

O ID da requisição.

Result

Array of String

["logstash-input-datahub", "logstash-input-maxcompute"]

A lista de plug-ins instalados com sucesso.

Os dados retornados também contêm parâmetros Headers, indicando que informações de cabeçalho foram devolvidas.

Exemplos

Exemplos de requisições

POST /openapi/logstashes/ls-cn-oew1qbgl****/plugins/system/actions/install?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
[
    "logstash-input-datahub",
    "logstash-input-maxcompute"
]

Exemplos de respostas de sucesso

Formato JSON

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

{
  "Result" : [ "logstash-input-datahub", "logstash-input-maxcompute" ],
  "RequestId" : "93DE9165-49A9-455E-AD7E-64B6694F****",
  "Headers" : { }
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InstanceActivating

Instance is activating.

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

400

InstanceNotFound

The instanceId provided does not exist.

Mensagem retornada porque a instância não foi encontrada. Verifique o status da instância.

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