Tüm Ürünler
Search
Belge Merkezi

:RestartInstance

Son Güncelleme:Oct 04, 2026

Belirtilen Elasticsearch kümesini yeniden başlatır.

Not

Ö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

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'lar için örnek kodları dinamik olarak oluşturur.

İ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.

  • true
  • false: Bu parametreyi yoksaymaz. Varsayılan değerdir.
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.

Not
  • 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:

  • active: Normal
  • activating: Etkinleşiyor
  • inactive: Donmuş
  • invalid: Başarısız
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:

  • STOP: durdurma sözcüğü listesi
  • MAIN: ana sözlük
  • SYNONYMS: eş anlamlı sözlük
  • ALI_WS: Alibaba Cloud sözlüğü
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:

  • OSS: Object Storage Service (OSS). İlgili OSS paketinin ACL'sinin herkese açık okuma olarak ayarlandığından emin olun.
  • ORIGIN: Açık kaynak Elasticsearch
  • UPLOAD: yüklenen dosyalar
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:

  • STOP: durdurma sözcüğü listesi
  • MAIN: ana sözlük
  • SYNONYMS: eş anlamlı sözlük
  • ALI_WS: Alibaba Cloud sözlüğü
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:

  • OSS: Object Storage Service (OSS). İlgili OSS paketinin ACL'sinin herkese açık okuma olarak ayarlandığından emin olun.
  • ORIGIN: Açık kaynak Elasticsearch
  • UPLOAD: yüklenen dosyalar
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ı.