Belirtilen Elasticsearch kümesini yeniden başlatır.
Örnek yeniden başlatıldıktan sonra etkin duruma geçer. Alibaba Cloud Elasticsearch, tek düğüm yeniden başlatmayı destekler. Düğüm yeniden başlatma işlemi normal yeniden başlatma ve mavi-yeşil yeniden başlatma olarak iki şekilde gerçekleştirilebilir.
Hata Ayıklama
İstek üst bilgileri
Bu işlem yalnızca ortak istek üst bilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.
İstek sözdizimi
POST /openapi/instances/{InstanceId}/actions/restart HTTP/1.1
İstek parametreleri
| Parametre | Tür | Konum | Zorunlu | Örnek | Açıklama |
| InstanceId | String | Path | Evet | es-cn-nif1q8auz0003**** |
Örnek kimliği. |
| force | Boolean | Query | Hayır | false |
Örneğin durumunu yoksayıp örneği zorla yeniden başlatıp başlatmayacağınızı belirtir.
|
| clientToken | String | Query | Hayır | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** |
İsteğin tekilleğini (idempotence) sağlamak için kullanılan istemci belirtecidir. Belirteci istemci tarafında oluşturabilirsiniz ancak farklı isteklerde benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterlerinden oluşabilir ve uzunluğu 64 karakteri aşamaz. |
| String | Body | Hayır | { "restartType":"nodeIp", "nodes":["172.16.xx.xx","172.16.xx.xx"], "blueGreenDep":true } |
Yeniden başlatma parametre bilgilerini belirtir. |
RequestBody
Yeniden başlatma parametrelerini belirtmek için RequestBody parametresinde aşağıdaki parametreleri de belirtmeniz gerekir.
|
Parametre |
Tür |
Zorunlu |
Örnek |
Açıklama |
|
|
restartType |
String |
Hayır |
instance |
Yeniden başlatma türü. Geçerli değerler: instance: Örnek yeniden başlatılır. Varsayılan değerdir. nodeIp: Düğüm yeniden başlatılır. Düğümün IP adresini belirtmeniz gerekir. nodeEcsId: Düğüm yeniden başlatılır. Kümedeki bir ECS örneğinin kimliğini belirtmeniz gerekir. |
|
|
nodes |
List<String> |
Hayır |
["127.0.."] |
Düğüm Yeniden Başlatma seçeneğini belirlerseniz yeniden başlatılacak düğümün IP adresini veya kimliğini belirtin. |
|
|
blueGreenDep |
Boolean |
Hayır |
false |
Düğüm yeniden başlatıldığında mavi-yeşil dağıtımın etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false. |
|
|
batchCount |
Double |
Hayır |
25.0 |
Örnek zorla yeniden başlatıldığında belirtilen eşzamanlılık değeri. |
|
|
batchUnit |
String |
Hayır |
percent |
batchCount parametresinin birimi. Varsayılan değer: percent. |
-
restartType belirtilmezse veya boş bir dize olarak ayarlanırsa varsayılan değer instance olur. Parametreyi instance olarak ayarlarsanız blueGreenDep parametresi varsayılan olarak yoksayılır. Aşağıdaki koşulların karşılanması gerekir:
force true olarak ayarlanırsa batchCount 0'dan büyük ve 100'e eşit veya küçük olmalıdır. Aksi takdirde RestartBatchValueError hatası döndürülür.
force false olarak ayarlanırsa batchCount varsayılan olarak 0'dır. Farklı bir değer atanırsa NormalRestartNotSupportBatch hatası döndürülür.
-
restartType nodeIp olarak ayarlanırsa batchCount parametresi varsayılan olarak yoksayılır ve aşağıdaki koşulların karşılanması gerekir:
nodes parametresi boş olamaz. Aksi takdirde hata mesajı döndürülür.
blueGreenDep true olarak ayarlanırsa düğüm yeniden başlatıldığında mavi-yeşil dağıtım etkinleştirilir. false olarak ayarlanırsa mavi-yeşil dağıtım etkinleştirilmez, yani normal yeniden başlatma yapılır.
Örnek ifade:
{
"restartType":"nodeIp",
"nodes": ["172.16.xx.xx"],
"blueGreenDep":true
}
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| RequestId | String | F99407AB-2FA9-489E-A259-40CF6DC**** |
İstek kimliği. |
| Result | Object |
Döndürülen sonuç. |
|
| nodeAmount | Integer | 2 |
Veri düğümlerinin sayısı. |
| publicDomain | String | es-cn-n6w1o1x0w001c****.public.elasticsearch.aliyuncs.com |
Kümenin genel uç noktası. |
| createdAt | String | 2020-07-06T10:18:48.662Z |
Örneğin oluşturulduğu zaman. |
| status | String | active |
Kümenin durumu. Aşağıdaki yapılandırmalar desteklenir:
|
| kibanaPort | Integer | 5601 |
Kümenin Kibana konsoluna internet üzerinden erişmek için kullanılan bağlantı noktası numarası. |
| publicPort | Integer | 9200 |
Kümeye internet üzerinden erişmek için kullanılan bağlantı noktası numarası. |
| paymentType | String | postpaid |
Örneğin faturalandırma yöntemi. Peşin ödeme (abonelik) ve kullandıkça öde desteklenir. |
| domain | String | es-cn-nif1q8auz0003****.elasticsearch.aliyuncs.com |
Kümenin dahili uç noktası. |
| description | String | es-cn-abc |
Örneğin adı. |
| esVersion | String | 6.7.0_with_X-Pack |
Kümenin sürümü. |
| kibanaDomain | String | es-cn-nif1q8auz0003****.kibana.elasticsearch.aliyuncs.com |
Kümenin Kibana konsolunun genel uç noktası. |
| updatedAt | String | 2018-07-18T10:10:04.484Z |
Örneğin en son güncellendiği zaman. |
| instanceId | String | es-cn-n6w1o1x0w001c**** |
Örnek kimliği. |
| dictList | Array of dictList |
IK sözlüklerinin yapılandırmaları. |
|
| fileSize | Long | 2782602 |
Sözlük dosyasının boyutu. Birim: bayt. |
| type | String | MAIN |
Sözlük türü. Geçerli değerler:
|
| name | String | SYSTEM_MAIN.dic |
Sözlük dosyasının adı. |
| sourceType | String | ORIGIN |
Sözlük dosyasının kaynak türü. Geçerli değerler:
|
| synonymsDicts | Array of synonymsDicts |
Eş anlamlı sözlüklerin yapılandırmaları. |
|
| fileSize | Long | 2782602 |
Sözlük dosyasının boyutu. Birim: bayt. |
| type | String | STOP |
Sözlük türü. Geçerli değerler:
|
| name | String | SYSTEM_MAIN.dic |
Sözlük dosyasının adı. |
| sourceType | String | ORIGIN |
Sözlük dosyasının kaynak türü. Geçerli değerler:
|
| kibanaConfiguration | Object |
Kibana düğümlerinin yapılandırmaları. |
|
| spec | String | elasticsearch.n4.small |
Düğümün teknik özellikleri. |
| amount | Integer | 1 |
Düğüm sayısı. |
| disk | Integer | 20 |
Düğüm depolama alanının boyutu. Birim: GB. |
| diskType | String | cloud_ssd |
Depolama türü. |
| masterConfiguration | Object |
Özel ana düğümlerin yapılandırmaları. |
|
| spec | String | elasticsearch.sn2ne.large |
Düğümün teknik özellikleri. |
| amount | Integer | 3 |
Düğüm sayısı. |
| disk | Integer | 20 |
Düğüm depolama alanının boyutu. Birim: GB. |
| diskType | String | cloud_ssd |
Depolama türü. Yalnızca cloud_ssd desteklenir. |
| networkConfig | Object |
Ağ yapılandırmaları. |
|
| vpcId | String | vpc-bp16k1dvzxtmagcva**** |
Kümenin VPC kimliği. |
| vsArea | String | cn-hangzhou-i |
NLB örneği için bir alan seçin. |
| type | String | vpc |
Ağ türü. Yalnızca VPC desteklenir. |
| vswitchId | String | vsw-bp1k4ec6s7sjdbudw**** |
Kümenin vSwitch kimliği. |
| nodeSpec | Object |
Veri düğümlerinin yapılandırmaları. |
|
| spec | String | elasticsearch.n4.small |
Düğümün teknik özellikleri. |
| disk | Integer | 50 |
Düğümün depolama kapasitesi. Birim: GB. |
| diskType | String | cloud_ssd |
Depolama türü. |
Aşağıdaki dönüş örneğinde, bu makale yalnızca döndürülen veri listesindeki parametrelerin dahil olduğunu garanti eder; bahsedilmeyen parametreler yalnızca referans amaçlıdır. Program, bu parametreleri almak için zorunlu olarak bunlara bağımlı olmamalıdır.
Örnekler
Örnek istekler
POST /openapi/instances/es-cn-nif1q8auz0003****/actions/restart HTTP/1.1
Common request header
{
"restartType":"nodeIp",
"nodes":["172.16.xx.xx","172.16.xx.xx"],
"blueGreenDep":true
}
Örnek başarılı yanıt
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"Result" : {
"instanceId" : "es-cn-nif1q8auz0003****",
"version" : "7.4.0_with_X-Pack",
"description" : "es-cn-nif1q8auz0003****",
"nodeAmount" : 3,
"paymentType" : "prepaid",
"status" : "active",
"privateNetworkIpWhiteList" : [ "0.0.0.0/0" ],
"enablePublic" : false,
"nodeSpec" : {
"spec" : "elasticsearch.n4.small",
"disk" : 20,
"diskType" : "cloud_ssd",
"diskEncryption" : false
},
"networkConfig" : {
"vpcId" : "vpc-bp16k1dvzxtmagcva****",
"vswitchId" : "vsw-bp1k4ec6s7sjdbudw****",
"vsArea" : "cn-hangzhou-i",
"type" : "vpc"
},
"createdAt" : "2020-07-06T10:18:48.662Z",
"updatedAt" : "2020-07-06T10:18:48.662Z",
"commodityCode" : "elasticsearchpre",
"extendConfigs" : [ {
"configType" : "usageScenario",
"value" : "general"
}, {
"configType" : "maintainTime",
"maintainStartTime" : "02:00Z",
"maintainEndTime" : "06:00Z"
} ],
"endTime" : 1596729600000,
"clusterTasks" : [ ],
"vpcInstanceId" : "es-cn-nif1q8auz0003****-worker",
"resourceGroupId" : "rg-acfm2h5vbzd****",
"zoneCount" : 1,
"protocol" : "HTTP",
"zoneInfos" : [ {
"zoneId" : "cn-hangzhou-i",
"status" : "NORMAL"
} ],
"instanceType" : "elasticsearch",
"inited" : true,
"tags" : [ ],
"domain" : "es-cn-nif1q8auz0003****.elasticsearch.aliyuncs.com",
"port" : 9200,
"esVersion" : "7.4.0_with_X-Pack",
"esConfig" : {
"action.destructive_requires_name" : "true",
"xpack.watcher.enabled" : "false",
"action.auto_create_index" : "+.*,-*"
},
"esIPWhitelist" : [ "0.0.0.0/0" ],
"esIPBlacklist" : [ ],
"kibanaIPWhitelist" : [ "0.0.0.0/0", "::/0" ],
"kibanaPrivateIPWhitelist" : [ ],
"publicIpWhitelist" : [ ],
"kibanaDomain" : "es-cn-nif1q8auz0003****.kibana.elasticsearch.aliyuncs.com",
"kibanaPort" : 5601,
"haveKibana" : true,
"instanceCategory" : "x-pack",
"dedicateMaster" : false,
"advancedDedicateMaster" : false,
"masterConfiguration" : { },
"haveClientNode" : false,
"warmNode" : false,
"warmNodeConfiguration" : { },
"clientNodeConfiguration" : { },
"kibanaConfiguration" : {
"spec" : "elasticsearch.n4.small",
"amount" : 1,
"disk" : 0
},
"dictList" : [ {
"name" : "SYSTEM_MAIN.dic",
"fileSize" : 2782602,
"sourceType" : "ORIGIN",
"type" : "MAIN"
}, {
"name" : "SYSTEM_STOPWORD.dic",
"fileSize" : 132,
"sourceType" : "ORIGIN",
"type" : "STOP"
} ],
"synonymsDicts" : [ ],
"ikHotDicts" : [ ],
"aliwsDicts" : [ ],
"haveGrafana" : false,
"haveCerebro" : false,
"enableKibanaPublicNetwork" : true,
"enableKibanaPrivateNetwork" : false,
"advancedSetting" : {
"gcName" : "CMS"
}
},
"RequestId" : "BB58A51D-CE72-49F9-AF08-F57F3C8A****"
}
HTTP durum kodu
Hata kodlarının listesi için bkz. Hizmet hata kodları.