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
İ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:
|
|
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ü:
|
|
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:
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 |
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 |
||
|
masterConfiguration |
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 |
||
|
warmNodeConfiguration |
Body |
Hayır |
Sıcak düğümlerin yapılandırmaları. |
||
|
clientNodeConfiguration |
Body |
Hayır |
İstemci düğümlerin yapılandırmaları. |
||
|
elasticDataNodeConfiguration |
Body |
Hayır |
Esnek düğümlerin yapılandırmaları. |
||
|
kibanaConfiguration |
Body |
Hayır |
Kibana düğümlerinin yapılandırmaları. Not
Kibana düğümünü etkinleştirmenizi kesinlikle öneririz. |
||
|
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. |
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.
NotpaymentType 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Ö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ı.