調(diào)用該接口時，請注意：

• 當(dāng)實(shí)例狀態(tài)為生效中（activating）、失效（invalid）和凍結(jié)（inactive）時，無法變更配置。
• 如果集群負(fù)載過高且索引沒有副本，同時在升配或者降配過程中存在大量的寫入或查詢等情況，業(yè)務(wù)可能會出現(xiàn)偶發(fā)的訪問超時現(xiàn)象。建議在集群變更前，在客戶端訪問機(jī)制中配置重試機(jī)制，以減小對業(yè)務(wù)的影響。
• 每次只能變更一種類型的節(jié)點(diǎn)（數(shù)據(jù)節(jié)點(diǎn)、專有主節(jié)點(diǎn)、冷數(shù)據(jù)節(jié)點(diǎn)、協(xié)調(diào)節(jié)點(diǎn)、Kibana節(jié)點(diǎn)、彈性節(jié)點(diǎn)）的配置。
• 出于您的集群健康和穩(wěn)定性的考慮，自2021年5月起，阿里云Elasticsearch已不支持購買1核2 GB規(guī)格、專有主節(jié)點(diǎn)的2核2 GB規(guī)格和7.4版本實(shí)例，如果您已確認(rèn)已購規(guī)格不再支持售賣，那么您需要先完成以下操作：
  • 對于1核2 GB和2核2 GB規(guī)格，建議提前升配至購買頁開放的穩(wěn)定的售賣規(guī)格。購買頁開放的售賣規(guī)格請參見購買頁面參數(shù)（商業(yè)版）或者購買頁面參數(shù)（增強(qiáng)版）。
  • 對于7.4版本，建議您重新選購7.10版本實(shí)例，然后再進(jìn)行數(shù)據(jù)遷移。數(shù)據(jù)遷移請參見遷移方案選取指南。

更多注意事項，請參見升配集群和降配集群。

請求頭

該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數(shù)文檔。

請求語法

PUT /openapi/instances/{InstanceId} HTTP/1.1

請求參數(shù)

Elasticsearch支持的節(jié)點(diǎn)規(guī)格列表，請參見阿里云Elasticsearch定價信息、產(chǎn)品規(guī)格。

請求體參數(shù)示例如下：

• 升配存儲空間

  目前僅支持?jǐn)?shù)據(jù)節(jié)點(diǎn)、冷數(shù)據(jù)節(jié)點(diǎn)和彈性數(shù)據(jù)節(jié)點(diǎn)升配存儲空間。

  將冷數(shù)據(jù)節(jié)點(diǎn)的存儲空間升配至1000 GiB。

  
  {
    "warmNodeConfiguration": {
     "disk": 1000
    }
  }
  

• 升配存儲類型

  目前僅支持?jǐn)?shù)據(jù)節(jié)點(diǎn)、彈性數(shù)據(jù)節(jié)點(diǎn)和專有主節(jié)點(diǎn)升配存儲類型。

  • 將專有主節(jié)點(diǎn)的存儲類型升配為ESSD云盤類型。

    
    {
      "masterConfiguration": {
        "diskType": "cloud_essd"
      }
    }
    

  • 當(dāng)專有主節(jié)點(diǎn)的存儲類型為ESSD云盤類型時，將節(jié)點(diǎn)存儲性能級別升配為PL3。

    指定performanceLevel后，diskType會默認(rèn)填充為cloud_essd。

    指定cloud_essd后，performanceLevel默認(rèn)為PL1。

    
    	{
    	  "masterConfiguration": {
    		"performanceLevel": "PL3"
    	  }
    	}
    	

• 升配節(jié)點(diǎn)數(shù)量

  目前僅支持?jǐn)?shù)據(jù)節(jié)點(diǎn)、冷數(shù)據(jù)節(jié)點(diǎn)、彈性數(shù)據(jù)節(jié)點(diǎn)和協(xié)調(diào)節(jié)點(diǎn)升配節(jié)點(diǎn)數(shù)量。

  數(shù)據(jù)節(jié)點(diǎn)升配節(jié)點(diǎn)數(shù)量的方式與其他節(jié)點(diǎn)不同，具體參見下文示例。

  • 將數(shù)據(jù)節(jié)點(diǎn)的節(jié)點(diǎn)數(shù)量升至12個。

    
    {
      "nodeAmount": 12
    }
    

  • 將其他類型節(jié)點(diǎn)（以冷數(shù)據(jù)節(jié)點(diǎn)為例）的節(jié)點(diǎn)數(shù)量升至12個。

    
    {
      "warmNodeConfiguration": {
        "amount": 12
      }
    }
    

• 升配節(jié)點(diǎn)規(guī)格

  將數(shù)據(jù)節(jié)點(diǎn)的規(guī)格升至4核32 GB。

  
  {
    "nodeSpec": {
      "spec": "elasticsearch.r5.xlarge"
    }
  }
  

• 同時升配同一節(jié)點(diǎn)的幾種配置

  同時升配同一節(jié)點(diǎn)的幾種配置，需要您同時寫入升配資源RequestBody。

  • 將協(xié)調(diào)節(jié)點(diǎn)的節(jié)點(diǎn)數(shù)量升至8，規(guī)格升至4核8 GB。

    
    {
      "clientNodeConfiguration": {
        "amount": 8,
        "spec": "elasticsearch.sn1ne.xlarge"
      }
    }
    

  • 將數(shù)據(jù)節(jié)點(diǎn)的節(jié)點(diǎn)數(shù)量升至12，存儲類型升至ESSD云盤。

    
    {
      "nodeAmount": 12,
      "nodeSpec": {
        "diskType": "cloud_essd"
      }
    }
    

• 啟用節(jié)點(diǎn)

  您可以參見createInstance接口設(shè)置完整的節(jié)點(diǎn)資源配置。

  • 啟用協(xié)調(diào)節(jié)點(diǎn)，同時設(shè)置協(xié)調(diào)節(jié)點(diǎn)配置。

    
    {
      "clientNodeConfiguration": {
        "amount": 5,
        "disk": 20,
        "spec": "elasticsearch.sn1ne.xlarge"
      }
    }
    

  • 啟用彈性數(shù)據(jù)節(jié)點(diǎn)，同時設(shè)置彈性數(shù)據(jù)節(jié)點(diǎn)配置（此配置只適用于中國站）。

    
    {
      "elasticNodeConfiguration": {
        "disk": 200,
        "amount": 5,
        "diskType": "cloud_essd",
        "spec": "elasticsearch.sn1ne.xlarge"
      }
    }
    

  • 啟用冷數(shù)據(jù)節(jié)點(diǎn)，同時設(shè)置冷數(shù)據(jù)節(jié)點(diǎn)配置。

    
    {
      "warmNodeConfiguration": {
        "disk": 1000,
        "amount": 3,
        "spec": "elasticsearch.sn1ne.xlarge"
      }
    }
    

• 升配開啟OpenStore（此配置只適用于中國站）

  已啟用冷數(shù)據(jù)節(jié)點(diǎn)的實(shí)例以及數(shù)據(jù)節(jié)點(diǎn)存儲類型為ESSD云盤的實(shí)例，目前不支持升配開啟OpenStore。

  如果實(shí)例類型為普通商業(yè)版，升配開啟OpenStore后，實(shí)例類型同時由普通商業(yè)版升配至開啟Indexing Service的日志增強(qiáng)版。

  • 冷數(shù)據(jù)節(jié)點(diǎn)打開OpenStore。

    
    {
      "warmNodeConfiguration": {
        "amount": 5,
        "spec": "openstore.i2g.4xlarge"
      }
    }
    

  • 數(shù)據(jù)節(jié)點(diǎn)規(guī)格轉(zhuǎn)換為OpenStore。

    
    {
      "nodeAmount": 6,
      "nodeSpec": {
        "spec": "openstore.i2g.4xlarge",
        "diskType": "cloud_ssd",
        "disk": 100
      }
    }
    

• 指定變更方式
  • 變更方式默認(rèn)為智能變更，將其指定為藍(lán)綠變更（blue_green）或原地變更（normal）。

    
    {
      "nodeSpec": {
        "spec": "elasticsearch.r5.xlarge"
      },
      "updateType": "blue_green"  ## 原地變更為normal。
    }
    

  • 開啟強(qiáng)制變更。

    
    {
      "nodeSpec": {
        "spec": "elasticsearch.r5.xlarge"
      },
      "force": true
    }
    

• 使用dryRun接口進(jìn)行升配預(yù)校驗

  在RequestBody中添加dryRun字段。

  
  {
    "nodeSpec": {
      "spec": "elasticsearch.r5.xlarge"
    },
    "dryRun": true
  }
  

• 降配存儲類型

  降配時，不支持變更冷數(shù)據(jù)節(jié)點(diǎn)（不變更實(shí)例類型）、協(xié)調(diào)節(jié)點(diǎn)、Kibana節(jié)點(diǎn)的存儲類型。

  將專有主節(jié)點(diǎn)的存儲類型變更為SSD云盤。

  
  {
    "masterConfiguration": {
      "diskType": "cloud_ssd"
    }
  }
  

• 降配規(guī)格

  將數(shù)據(jù)節(jié)點(diǎn)的規(guī)格降配至4核32 GB。

  
  {
    "nodeSpec": {
      "spec": "elasticsearch.r5.xlarge"
    }
  }
  

返回數(shù)據(jù)

示例

請求示例

PUT /openapi/instances/es-cn-n6w1ptcb30009****?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF****&orderActionType=upgrade HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "nodeSpec": {
    "spec": "elasticsearch.r5.xlarge"
  }
}

正常返回示例

JSON格式

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

{
  "Result" : {
    "instanceId" : "es-cn-n6w1ptcb30009****",
    "version" : "5.5.3_with_X-Pack",
    "nodeAmount" : 3,
    "paymentType" : "postpaid",
    "status" : "active",
    "nodeSpec" : {
      "spec" : "elasticsearch.n4.small",
      "disk" : 40,
      "diskType" : "cloud_ssd",
      "diskEncryption" : false
    },
    "createdAt" : "2020-06-28T08:25:52.895Z",
    "zoneCount" : 1,
    "instanceCategory" : "x-pack",
    "kibanaConfiguration" : {
      "spec" : "elasticsearch.n4.small",
      "amount" : 1,
      "disk" : 0
    }
  },
  "RequestId" : "B5246080-9C30-4B6A-8F8A-8C705405****"
}

返回示例補(bǔ)充說明

> 返回示例中，本文只保證包含返回數(shù)據(jù)列表中的參數(shù)，而未提到的參數(shù)僅供參考，程序中不能強(qiáng)制依賴獲取這些參數(shù)。

錯誤碼

訪問錯誤中心查看更多錯誤碼。