Elasticsearch：UpdateInstance

調用該介面時，請注意：

• 當執行個體狀態為生效中（activating）、失效（invalid）和凍結（inactive）時，無法變更配置。
• 如果叢集負載過高且索引沒有副本，同時在升配或者降配過程中存在大量的寫入或查詢等情況，業務可能會出現偶發的訪問逾時現象。建議在叢集變更前，在用戶端訪問機制中配置重試機制，以減小對業務的影響。
• 每次只能變更一種類型的節點（資料節點、專有主節點、冷資料節點、協調節點、Kibana節點、彈性節點）的配置。
• 出於您的叢集健康和穩定性的考慮，自2021年5月起，Elasticsearch已不支援購買1核2 GB規格、專有主節點的2核2 GB規格和7.4版本執行個體，如果您已確認已購規格不再支援售賣，那麼您需要先完成以下操作：
  • 對於1核2 GB和2核2 GB規格，建議提前升配至購買頁開放的穩定的售賣規格。購買頁開放的售賣規格請參見購買頁面參數。
  • 對於7.4版本，建議您重新選購7.10版本執行個體，然後再進行資料移轉。

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

要求標頭

該介面使用公用要求標頭，無特殊要求標頭。請參見公用請求參數文檔。

請求文法

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

請求參數

Elasticsearch支援的節點規格列表，請參見Elasticsearch定價資訊、產品規格。

請求體參數樣本如下：

• 升配儲存空間

  目前僅支援資料節點、冷資料節點和彈性資料節點升配儲存空間。

  將冷資料節點的儲存空間升配至1000 GiB。

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

• 升配儲存類型

  目前僅支援資料節點、彈性資料節點和專有主節點升配儲存類型。

  • 將專有主節點的儲存類型升配為ESSD雲端硬碟類型。

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

  • 當專有主節點的儲存類型為ESSD雲端硬碟類型時，將節點儲存效能層級升配為PL3。

    指定performanceLevel後，diskType會預設填充為cloud_essd。

    指定cloud_essd後，performanceLevel預設為PL1。

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

• 升配節點數量

  目前僅支援資料節點、冷資料節點、彈性資料節點和協調節點升配節點數量。

  資料節點升配節點數量的方式與其他節點不同，具體參見下文樣本。

  • 將資料節點的節點數量升至12個。

    
    {
      "nodeAmount": 12
    }
    

  • 將其他類型節點（以冷資料節點為例）的節點數量升至12個。

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

• 升配節點規格

  將資料節點的規格升至4核32 GB。

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

• 同時升配同一節點的幾種配置

  同時升配同一節點的幾種配置，需要您同時寫入升配資源RequestBody。

  • 將協調節點的節點數量升至8，規格升至4核8 GB。

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

  • 將資料節點的節點數量升至12，儲存類型升至ESSD雲端硬碟。

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

• 啟用節點

  您可以參見createInstance介面設定完整的節點資源配置。

  • 啟用協調節點，同時設定協調節點配置。

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

  • 啟用彈性資料節點，同時設定彈性資料節點配置（此配置只適用於中國站）。

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

  • 啟用冷資料節點，同時設定冷資料節點配置。

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

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

  已啟用冷資料節點的執行個體以及資料節點儲存類型為ESSD雲端硬碟的執行個體，目前不支援升配開啟OpenStore。

  如果執行個體類型為普通商業版，升配開啟OpenStore後，執行個體類型同時由普通商業版升配至開啟Indexing Service的日誌增強版。

  • 冷資料節點開啟OpenStore。

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

  • 資料節點規格轉換為OpenStore。

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

• 指定變更方式
  • 變更方式預設為智能變更，將其指定為藍綠變更（blue_green）或原地變更（normal）。

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

  • 開啟強制變更。

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

• 使用dryRun介面進行升配預校正

  在RequestBody中添加dryRun欄位。

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

• 降配儲存類型

  降配時，不支援變更冷資料節點（不變更執行個體類型）、協調節點、Kibana節點的儲存類型。

  將專有主節點的儲存類型變更為SSD雲端硬碟。

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

• 降配規格

  將資料節點的規格降配至4核32 GB。

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

返回資料

樣本

請求樣本

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****"
}

返回樣本補充說明

> 返回樣本中，本文只保證包含返回資料列表中的參數，而未提到的參數僅供參考，程式中不能強制依賴擷取這些參數。

錯誤碼

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