Tous les produits
Search
Centre de documentation

Elasticsearch:CreateLogstash

Dernière mise à jour :Aug 09, 2026

Crée un cluster Logstash.

Avant d'appeler cette opération, tenez compte des informations suivantes :

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

En-têtes de requête

POST /openapi/logstashes

Syntaxe de la requête

POST /openapi/logstashes HTTP/1.1

Paramètres de requête

Paramètre

Type

Emplacement

Obligatoire

Exemple

Description

clientToken String Query Non. 5A2CFF0E-5718-45B5-9D4D-70B3FF****

utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères de longueur.

Object Body Oui

Les paramètres de la requête.

paymentType String Body Non prepaid

La méthode de facturation du cluster. Valeurs valides :

  • prepaid : abonnement
  • postpaid : paiement à l'utilisation
version String Body Oui 6.7_with_X-Pack

La version de l'instance. Valeurs valides :

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

Le nombre de nœuds dans le cluster.

nodeSpec Object Body Oui

Les configurations des nœuds de données.

disk Long Body Non 50

La taille du disque par nœud. Unité : Go.

diskType String Body Non cloud_ssd

Le type de disque. Valeurs valides :

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

La catégorie de spécification. Pour plus d'informations, consultez Spécifications du produit.

networkConfig Object Body Oui

Les configurations réseau.

type String Body Non vpc

Le type de réseau. Définissez la valeur sur vpc.

vpcId String Body Oui vpc-bp16k1dvzxtmagcva****

L'ID du VPC.

vswitchId String Body Oui vsw-bp1k4ec6s7sjdbudw****

L'ID du vSwitch.

vsArea String Body Oui cn-hangzhou-i

Sélectionnez une zone pour l'instance NLB.

paymentInfo Object Body Non

Les détails de facturation. Ce paramètre est requis lors de la création d'un cluster par abonnement.

duration Long Body Non 1

La durée de l'abonnement. Unité : 1 à 9 mois, 1 à 3 ans.

pricingCycle String Body Non Month

L'unité d'abonnement. Valeurs valides :

  • Year
  • Month
isAutoRenew Boolean Body Non false

Indique si le renouvellement automatique est activé. Valeurs valides :

  • true
  • false
autoRenewDuration Long Body Non 3

La durée du renouvellement automatique. Unité : mois. Ce paramètre est requis lorsque isAutoRenew est défini sur true. La plage de valeurs est la même que celle de la page d'achat.

description String Body Non ls-cn-abc

Le nom du téléphone cloud.

resourceGroupId String Body Non rg-acfmxxkk2p7****

L'ID du groupe de ressources auquel appartient la nouvelle instance ECS.

Paramètres de réponse

Paramètre

Type

Valeur d'exemple

Description

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

L'ID de la requête.

Result Logstash

Les paramètres de réponse.

Exemples

Exemples de requêtes

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"
}

Exemples de réponses réussies

Format 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"
    } ]
  } ]
}

Code d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.