全部產品

OpenSearch：ModifySearcherReplica - 修改資料節點副本分區數

更新時間：Sep 22, 2025

通過指定執行個體ID來修改資料節點的副本或分區數量。

介面說明

請求說明

本 API 允許使用者修改特定執行個體下的資料節點副本數或分區數。請求時，需提供執行個體 ID，並在請求體中指定要修改的replica（副本數）或partition（分區數）。請注意，這兩個參數都是可選的，但至少需要提供其中一個以執行更新操作。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

searchengine:ModifySearcherReplica

update

*Instance

acs:searchengine:{#regionId}:{#accountId}:instance/{#InstanceId}

無

無

請求文法

PUT /openapi/ha3/instances/{instanceId}/replica HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
instanceId	string	是	執行個體 ID	ha-cn-test
body	object	否	請求體
replica	integer	否	資料節點副本數	2
partition	integer	否	資料節點分區數	2

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
requestId	string	請求 ID	e1eef569-1ff7-4bf8-acf7-1cecca9894ce
result	object	操作的結果對象，目前的版本下該對象為空白。

樣本

正常返回樣本

JSON格式

{
  "requestId": "e1eef569-1ff7-4bf8-acf7-1cecca9894ce",
  "result": {
    "test": "test",
    "test2": 1
  }
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。