Tüm Ürünler
Search
Belge Merkezi

:createInstance

Son Güncelleme:Oct 04, 2026

Bir Elasticsearch örneği oluşturmak için createInstance işlemini çağırın.

Kullanım notları

  • Alibaba Cloud Elasticsearch faturalandırma ve fiyatlandırma standartlarına hakim olmanız gerekir. Daha fazla bilgi için bkz. Alibaba Cloud Elasticsearch Fiyatlandırması.

  • Gerçek kimlik doğrulamasından geçmiş olmanız gerekir.

  • Küme oluştururken bir alan belirtmeniz gerekmez. Küme, varsayılan olarak belirtilen sanal özel bulut (VPC) ile aynı alanda dağıtılır.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlem örnek kodunu dinamik olarak oluşturur.

İstek üst bilgileri

Bu işlemde işleme özgü istek üst bilgileri bulunmaz; yalnızca ortak istek üst bilgileri kullanılır. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.

İstek sözdizimi

POST /openapi/instances HTTP/1.1

İstek parametreleri

Parametre

Tür

Konum

Gerekli

Örnek

Açıklama

clientToken

String

Query

Hayır.

5A2CFF0E-5718-45B5-9D4D-70B3FF****

İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılır. Belirteci istemci tarafında üretebilirsiniz ancak farklı isteklerde benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.

Object

Body

Hayır

İstek parametreleri.

zoneCount

Integer

Body

Hayır.

2

Kümenin dağıtılacağı alan sayısı. Geçerli değerler: 1, 2 ve 3. Varsayılan değer: 1.

paymentType

String

Body

Hayır

postpaid

Faturalandırma yöntemi. Geçerli değerler:

  • postpaid: kullandıkça öde

  • prepaid: abonelik

paymentInfo

PaymentInfo

Body

Hayır

Kümenin faturalandırma ayrıntıları. paymentType değerini prepaid olarak ayarlarsanız bu parametre zorunludur.

nodeAmount

Integer

Body

Evet

3

Veri düğümlerinin sayısı. Geçerli değerler: 2 ila 50.

instanceCategory

String

Body

Hayır

advanced

Sürüm türü:

  • x-pack: Ticari Sürüm veya Dizinleme Hizmeti ve OpenStore devre dışı bırakılmış Çekirdek Geliştirilmiş Sürüm örneği oluşturun.

  • IS: Dizinleme Hizmeti veya OpenStore etkinleştirilmiş çekirdek geliştirilmiş örnek oluşturur.

esAdminPassword

String

Body

Evet

Es_password

Kümeye erişim için kullanılan parola. Parola 8 ila 32 karakter uzunluğunda olmalı ve aşağıdaki karakter türlerinden en az üçünü içermelidir: büyük harfler, küçük harfler, rakamlar ve özel karakterler. Desteklenen özel karakterler şunlardır: ! @ # $ % ^ & * ( ) _ + - =

esVersion

String

Body

Evet

5.5.3_with_X-Pack

Örneğin sürümü. Geçerli değerler:

  • 8.5.1_with_X-Pack

  • 7.10_with_X-Pack

  • 6.7_with_X-Pack

  • 7.7_with_X-Pack

  • 6.8_with_X-Pack

  • 6.3_with_X-Pack

  • 5.6_with_X-Pack

  • 5.5.3_with_X-Pack

Not

Yukarıdaki sürümler, Elasticsearch örneği tarafından desteklenen tüm sürümleri içermeyebilir. Desteklenen sürümleri görüntülemek için GetRegionConfiguration işlemini çağırabilirsiniz.

nodeSpec

NodeSpec

Body

Hayır

Veri düğümlerinin yapılandırmaları.

Not

Çin (Pekin), Çin (Şanghay), Çin (Hangzhou) ve Çin (Shenzhen) bölgelerinde yeni nesil disk tabanlı veri düğümleri oluşturmak için createInstance işlemini kullanırken örnek ailesini ve .new son ekini belirtmeniz gerekir; örneğin: elasticsearch.sn1ne.large.new.

masterConfiguration

MasterNodeConfiguration

Body

Hayır

Adanmış master düğümlerin yapılandırmaları.

Not

Çin (Pekin), Çin (Şanghay), Çin (Hangzhou) ve Çin (Shenzhen) bölgelerinde yeni nesil disk tabanlı veri düğümleri oluşturmak için createInstance işlemini kullanırken örnek ailesini ve .new son ekini belirtmeniz gerekir; örneğin: elasticsearch.sn1ne.large.new.

warmNodeConfiguration

WarmNodeConfiguration

Body

Hayır

Sıcak düğümlerin yapılandırmaları.

clientNodeConfiguration

ClientNodeConfiguration

Body

Hayır

İstemci düğümlerin yapılandırmaları.

elasticDataNodeConfiguration

ElasticDataNodeConfiguration

Body

Hayır

Esnek düğümlerin yapılandırmaları.

kibanaConfiguration

KibanaNodeConfiguration

Body

Hayır

Kibana düğümlerinin yapılandırmaları.

Not

Kibana düğümünü etkinleştirmenizi kesinlikle öneririz.

networkConfig

NetworkConfig

Body

Evet

Ağ yapılandırmaları.

Not

Örnek oluştururken bir IP adresi izin listesi belirtemezsiniz.

resourceGroupId

String

Body

Hayır

rg-aekzu7tsu4n****

Örneğin ait olduğu kaynak grubunun ID değeri.

description

String

Body

Hayır

es

Örneğin adı.

tags

Array

Body

Hayır

Örneğin etiket grubu.

tagKey

String

Body

Hayır

KeyTest

Örneğin etiket anahtarı.

tagValue

String

Body

Hayır

KeyValue

Örneğin etiket değeri.

Not
  • Alibaba Cloud Elasticsearch tarafından desteklenen düğüm teknik özelliklerinin listesi için bkz. Alibaba Cloud Elasticsearch Fiyatlandırması ve Teknik Özellikler.

  • diskType parametresi, düğümün depolama türünü belirtir. Bu parametre temel diskler için zorunludur. Yerel diskler için gerekli değildir.

İstek gövdesi örnekleri:

  • Hem sıcak hem de soğuk düğümler içeren Genel Amaçlı İşletme Sürümü örneği oluşturun.

    {
      "description": "xpack-hot-cold",
      "nodeAmount": 2,
      "esVersion": "7.10_with_X-Pack",
      "instanceCategory": "x-pack",
      "nodeSpec": {
        "spec": "elasticsearch.sn2ne.xlarge",
        "disk": 20,
        "diskType": "cloud_ssd"
      },
      "warmNodeConfiguration": {
        "spec": "elasticsearch.sn1ne.xlarge",
        "amount": 3,
        "diskType": "cloud_efficiency",
        "disk": 500
      },
      "networkConfig": {
        "type": "vpc",
        "vpcId": "vpc-8vbfu74bmw4m7m84a****",
        "vswitchId": "vsw-8vbnk6cmurbpump2f****",
        "vsArea": "cn-zhangjiakou-c"
      },
      "paymentType": "postpaid",
      "esAdminPassword": "yourPassword",
      "kibanaConfiguration": {
        "spec": "elasticsearch.sn1ne.large"
      }
    }
    
  • Yalnızca sıcak düğümler içeren bir Dizinleme Hizmeti serisi örneği oluşturun.

    {
      "description": "is-hot",
      "nodeAmount": 2,
      "esVersion": "7.10_with_X-Pack",
      "instanceCategory": "IS",
      "nodeSpec": {
        "spec": "elasticsearch.sn1ne.xlarge",
        "disk": 20,
        "diskType": "cloud_ssd"
      },
      "networkConfig": {
        "type": "vpc",
        "vpcId": "vpc-8vbfu74bmw4m7m84a****",
        "vswitchId": "vsw-8vbnk6cmurbpump2f****",
        "vsArea": "cn-zhangjiakou-c"
      },
      "paymentType": "postpaid",
      "esAdminPassword": "yourPassword",
      "kibanaConfiguration": {
        "spec": "elasticsearch.sn1ne.large"
      }
    }
    
  • Yalnızca soğuk düğümler içeren bir Dizinleme Hizmeti serisi örneği oluşturun.

    {
      "description": "is-cold",
      "nodeAmount": 2,
      "esVersion": "7.10_with_X-Pack",
      "instanceCategory": "IS",
      "warmNodeConfiguration": {
        "spec": "group.c6.large.500",
        "amount": 3,
        "disk": 300
      },
      "networkConfig": {
        "type": "vpc",
        "vpcId": "vpc-8vbfu74bmw4m7m84a****",
        "vswitchId": "vsw-8vbnk6cmurbpump2f****",
        "vsArea": "cn-zhangjiakou-c"
      },
      "paymentType": "postpaid",
      "esAdminPassword": "yourPassword",
      "kibanaConfiguration": {
        "spec": "elasticsearch.sn1ne.large"
      }
    }
    
  • Hem sıcak hem de soğuk düğümler içeren bir Dizinleme Hizmeti serisi örneği oluşturun.

    {
      "description": "is-hot-cold",
      "nodeAmount": 2,
      "esVersion": "7.10_with_X-Pack",
      "instanceCategory": "IS",
      "nodeSpec": {
        "spec": "elasticsearch.sn2ne.xlarge",
        "disk": 50,
        "diskType": "cloud_ssd"
      },
      "warmNodeConfiguration": {
        "spec": "group.c6.large.500",
        "amount": 3,
        "disk": 300
      },
      "networkConfig": {
        "type": "vpc",
        "vpcId": "vpc-8vbfu74bmw4m7m84a****",
        "vswitchId": "vsw-8vbnk6cmurbpump2f****",
        "vsArea": "cn-zhangjiakou-c"
      },
      "paymentType": "postpaid",
      "esAdminPassword": "yourPassword",
      "kibanaConfiguration": {
        "spec": "elasticsearch.sn1ne.large"
      }
    }
    
  • OpenStore depolamayı etkinleştiren ve hem soğuk hem de sıcak düğümler içeren bir Dizinleme Hizmeti serisi örneği oluşturun.

    {
      "description": "os-1",
      "nodeAmount": 2,
      "esVersion": "7.10_with_X-Pack",
      "instanceCategory": "IS",
      "nodeSpec": {
        "spec": "elasticsearch.sn2ne.xlarge",
        "disk": 50,
        "diskType": "cloud_ssd"
      },
      "warmNodeConfiguration": {
        "spec": "openstore.i2g.4xlarge",
        "amount": 3
      },
      "networkConfig": {
        "type": "vpc",
        "vpcId": "vpc-8vbfu74bmw4m7m84a****",
        "vswitchId": "vsw-8vbnk6cmurbpump2f****",
        "vsArea": "cn-zhangjiakou-c"
      },
      "paymentType": "postpaid",
      "esAdminPassword": "yourPassword",
      "kibanaConfiguration": {
        "spec": "elasticsearch.sn1ne.large"
      }
    }
    
  • OpenStore'u etkinleştiren ve hem sıcak hem de soğuk paylaşımlı düğümler içeren bir Dizinleme Hizmeti serisi örneği oluşturun.

    {
      "description": "os-2",
      "nodeAmount": 2,
      "esVersion": "7.10_with_X-Pack",
      "instanceCategory": "IS",
      "nodeSpec": {
        "spec": "openstore.i2g.4xlarge",
        "disk": 50,
        "diskType": "cloud_ssd"
      },
      "networkConfig": {
        "type": "vpc",
        "vpcId": "vpc-8vbfu74bmw4m7m84a****",
        "vswitchId": "vsw-8vbnk6cmurbpump2f****",
        "vsArea": "cn-zhangjiakou-c"
      },
      "paymentType": "postpaid",
      "esAdminPassword": "yourPassword",
      "kibanaConfiguration": {
        "spec": "elasticsearch.sn1ne.large"
      }
    }
    
  • Evrensel İşletme Sürümü 7.10 örneği oluşturun ve otomatik yenilemeyi etkinleştirin.

    Not

    paymentType değeri prepaid olarak ayarlanırsa örnek abonelik modundadır. Otomatik yenileme, paymentInfo parametresinde ayarlanır.

    {
     "description": "auto-renewal",
     "nodeAmount": 3,
     "instanceCategory": "x-pack",
     "esVersion": "7.10_with_X-Pack",
     "nodeSpec": {
     "spec": "elasticsearch.sn2ne.xlarge",
     "disk": 50,
     "diskType": "cloud_ssd"
     },
     "kibanaConfiguration": {
     "spec": "elasticsearch.sn1ne.large"
     },
     "networkConfig": {
     "type": "vpc",
     "vpcId": "vpc-8vbfu74bmw4m7m84a****",
     "vswitchId": "vsw-8vbnk6cmurbpump2f****",
     "vsArea": "cn-zhangjiakou-c"
     },
     "paymentType": "prepaid",
     "paymentInfo": {
     "duration": 1,
     "pricingCycle": "Month",
     "isAutoRenew": true,
     "autoRenewDuration": 1
     },
     "esAdminPassword": "yourPassword"
    }
    

Yanıt parametreleri


Parametre


Tür


Örnek


Açıklama


RequestId


String


838D9D11-8EEF-46D8-BF0D-BC8FC2B0C2F3


İstek Kimliği.


Result


object


Döndürülen veriler.


└instanceId


string


es-is-0u2ecp69tt****


Elasticsearch örneğinin ID değeri.

Örnekler

Örnek istekler

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

{
  "description": "xpack-hot-cold",
  "nodeAmount": 2,
  "esVersion": "7.10_with_X-Pack",
  "instanceCategory": "x-pack",
  "nodeSpec": {
    "spec": "elasticsearch.sn2ne.xlarge",
    "disk": 20,
    "diskType": "cloud_ssd"
  },
  "warmNodeConfiguration": {
    "spec": "elasticsearch.sn1ne.xlarge",
    "amount": 3,
    "diskType": "cloud_efficiency",
    "disk": 500
  },
  "networkConfig": {
    "type": "vpc",
    "vpcId": "vpc-8vbfu74bmw4m7m84a****",
    "vswitchId": "vsw-8vbnk6cmurbpump2f****",
    "vsArea": "cn-zhangjiakou-c"
  },
  "paymentType": "postpaid",
  "esAdminPassword": "yourPassword",
  "kibanaConfiguration": {
    "spec": "elasticsearch.sn1ne.large"
  }
}

Örnek başarılı yanıt

XML biçimi

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

<createInstanceResponse>
    <RequestId>838D9D11-8EEF-46D8-BF0D-BC8FC2B0C2F3</RequestId>
    <Result>
        <instanceId>es-is-0u2ecp69tt****</instanceId>
    </Result>
</createInstanceResponse>

JSON biçimi

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

{
  "RequestId" : "838D9D11-8EEF-46D8-BF0D-BC8FC2B0C2F3",
  "Result" : {
    "instanceId" : "es-is-0u2ecp69tt****"
  }
}

Hata kodu

Hata kodlarının listesi için bkz. Hizmet hata kodları.