すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:CreateLogstash

最終更新日:Mar 17, 2025

Logstash クラスターを作成します。

この操作を呼び出す前に、次の情報に注意してください。

  • Logstash の課金方法と料金を十分に理解している。
  • 実名登録が完了している。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

POST /openapi/logstashes

リクエスト構文

POST /openapi/logstashes HTTP/1.1

リクエストパラメーター

パラメーター

タイプ

位置

必須

説明

clientToken String Query いいえ 5A2CFF0E-5718-45B5-9D4D-70B3FF****

リクエストのべき等性を確保するために使用されます。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

Object Body はい

リクエストパラメーター。

paymentType String Body いいえ prepaid

クラスターの課金方法。有効値:

  • prepaid: サブスクリプション
  • postpaid: 従量課金
version String Body はい 6.7_with_X-Pack

インスタンスのバージョン。有効値:

  • 6.7_with_X-Pack
  • 7.4_with_X-Pack
nodeAmount Integer Body はい 2

クラスター内のノード数。

nodeSpec Object Body はい

データノードの構成。

disk Long Body いいえ 50

ノードあたりのディスクサイズ。単位:GB。

diskType String Body いいえ cloud_ssd

ディスクタイプ。有効値:

  • cloud_ssd
  • cloud_efficiency
spec String Body はい elasticsearch.ic5.2xlarge

仕様カテゴリ。詳細については、「製品仕様」をご参照ください。

networkConfig Object Body はい

ネットワーク構成。

type String Body いいえ vpc

ネットワークタイプ。値を vpc に設定します。

vpcId String Body はい vpc-bp16k1dvzxtmagcva****

VPC ID。

vswitchId String Body はい vsw-bp1k4ec6s7sjdbudw****

vSwitch ID。

vsArea String Body はい cn-hangzhou-i

NLB インスタンスのゾーンを選択します。

paymentInfo Object Body いいえ

課金詳細。サブスクリプションクラスターを作成する場合、このパラメーターは必須です。

duration Long Body いいえ 1

サブスクリプション期間。単位:1~9か月、1~3年。

pricingCycle String Body いいえ Month

サブスクリプション単位。有効値:

  • Year
  • Month
isAutoRenew Boolean Body いいえ false

自動更新が有効かどうかを示します。有効値:

  • true
  • false
autoRenewDuration Long Body いいえ 3

isAutoRenewtrue に設定されている場合、このパラメーターは必須です。値の範囲は購入ページと同じです。単位:月。

description String Body いいえ ls-cn-abc

クラウドフォンの名前。

resourceGroupId String Body いいえ rg-acfmxxkk2p7****

新しい ECS インスタンスが属するリソースグループの ID。

レスポンスパラメーター

パラメーター

タイプ

サンプル値

説明

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

リクエスト ID。

Result Logstash

レスポンスパラメーター。

サンプルリクエスト

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

サンプルの成功レスポンス

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

エラーコード

エラーコードのリストについては、「サービスエラーコード」をご参照ください。