Todos os produtos
Search
Central de documentação

Elasticsearch:CreateLogstash

Última atualização: Jun 27, 2026

Cria um cluster Logstash.

Antes de chamar esta operação, observe as seguintes informações:

  • Você compreende totalmente os métodos de faturamento e os preços do Logstash.

    Para obter mais informações, consulte

    Faturamento do produto

    .

  • Você concluiu a verificação de nome real.

    Para obter mais informações, consulte

    Verificação de nome real

    .

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame 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 solicitação

POST /openapi/logstashes

Sintaxe da solicitação

POST /openapi/logstashes HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

clientToken String Query Não. 5A2CFF0E-5718-45B5-9D4D-70B3FF****

Usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas certifique-se de que ele seja exclusivo entre solicitações diferentes. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres de comprimento.

Object Body Sim

Os parâmetros da solicitação.

paymentType String Body Não prepaid

O método de faturamento do cluster. Valores válidos:

  • prepaid: assinatura
  • postpaid: pagamento conforme o uso
version String Body Sim 6.7_with_X-Pack

A versão da instância. Valores válidos:

  • 6.7_with_X-Pack
  • 7.4_with_X-Pack
nodeAmount Integer Body Sim 2

O número de nós no cluster.

nodeSpec Object Body Sim

As configurações dos nós de dados.

disk Long Body Não 50

O tamanho do disco por nó. Unidade: GB.

diskType String Body Não cloud_ssd

O tipo de disco. Valores válidos:

  • cloud_ssd
  • cloud_efficiency
spec String Body Sim elasticsearch.ic5.2xlarge

A categoria de especificação. Para obter mais informações, consulte Especificações do produto.

networkConfig Object Body Sim

As configurações de rede.

type String Body Não vpc

O tipo de rede. Defina o valor como vpc.

vpcId String Body Sim vpc-bp16k1dvzxtmagcva****

O ID da VPC.

vswitchId String Body Sim vsw-bp1k4ec6s7sjdbudw****

O ID do vSwitch.

vsArea String Body Sim cn-hangzhou-i

Selecione uma zona para a instância NLB.

paymentInfo Object Body Não

Os detalhes de faturamento. Este parâmetro é obrigatório ao criar um cluster de assinatura.

duration Long Body Não 1

A duração da assinatura. Unidade: 1 a 9 meses, 1 a 3 anos.

pricingCycle String Body Não Month

A unidade da assinatura. Valores válidos:

  • Year
  • Month
isAutoRenew Boolean Body Não false

Indica se a renovação automática está ativada. Valores válidos:

  • true
  • false
autoRenewDuration Long Body Não 3

A duração da renovação automática. Unidade: mês. Este parâmetro é obrigatório quando isAutoRenew é definido como true. O intervalo de valores é o mesmo da página de compra.

description String Body Não ls-cn-abc

O nome do telefone em nuvem.

resourceGroupId String Body Não rg-acfmxxkk2p7****

O ID do grupo de recursos ao qual a nova instância ECS pertence.

Parâmetros de resposta

Parâmetro

Tipo

Valor de exemplo

Descrição

RequestId

String

5FFD9ED4-C2EC-4E89-B22B-1ACB6FE*

O ID da solicitação.

Result

Logstash

Os parâmetros da resposta.

Exemplos

Exemplos de solicitações

POST /openapi/logstashes?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "paymentType" : "prepaid",
  "version" : "6.7_with_X-Pack",
  "nodeAmount" : 2,
  "nodeSpec" : {
    "disk" : 50,
    "diskType" : "cloud_ssd",
    "spec" : "logstash.n4.small"
  },
  "networkConfig" : {
    "type" : "vpc",
    "vpcId" : "vpc-bp16k1dvzxtmagcva****",
    "vswitchId" : "vsw-bp1k4ec6s7sjdbudw****",
    "vsArea" : "cn-hangzhou-i"
  },
  "paymentInfo" : {
    "duration" : 1,
    "pricingCycle" : "Month",
    "isAutoRenew" : false,
    "autoRenewDuration" : 3
  },
  "description" : "ls-cn-abc"
}

Exemplos de respostas de sucesso

Formato JSON

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

{
  "RequestId" : "5FFD9ED4-C2EC-4E89-B22B-1ACB6FE*****",
  "Result" : [ {
    "instanceId" : "ls-cn-n6w1o5jq****",
    "version" : "6.7_with_X-Pack",
    "description" : "test",
    "nodeAmount" : 1,
    "paymentType" : "postpaid",
    "status" : "active",
    "enablePublic" : false,
    "nodeSpec" : {
      "spec" : "elasticsearch.sn1ne.large",
      "disk" : 20,
      "diskType" : "cloud_ssd"
    },
    "networkConfig" : {
      "vpcId" : "vpc-bp16k1dvzxtmagcva****",
      "vswitchId" : "vsw-bp1k4ec6s7sjdbudw****",
      "vsArea" : "cn-hangzhou-i",
      "type" : "vpc"
    },
    "createdAt" : "2020-05-27T01:30:15.947Z",
    "updatedAt" : "2020-05-27T01:40:51.333Z",
    "commodityCode" : "elasticsearch_logstash_post",
    "extendConfigs" : [ ],
    "endTime" : 4746268800000,
    "clusterTasks" : [ ],
    "resourceGroupId" : "rg-acfm2h5vbzd****",
    "zoneCount" : 1,
    "protocol" : "HTTP",
    "zoneInfos" : [ {
      "zoneId" : "cn-hangzhou-i",
      "status" : "NORMAL"
    } ],
    "instanceType" : "logstash",
    "inited" : true,
    "tags" : [ ],
    "config" : { },
    "endpointList" : [ {
      "host" : "172.16.**.**",
      "port" : 9600,
      "zoneId" : "cn-hangzhou-i"
    } ]
  } ]
}

Código de erro

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