全部產品
Search

搜尋本產品

    Tair (Redis® OSS-Compatible)：MigrateToOtherZone - 遷移執行個體至其他可用性區域

    文件中心

    Tair (Redis® OSS-Compatible)：MigrateToOtherZone - 遷移執行個體至其他可用性區域

    更新時間：Mar 30, 2026

    將雲資料庫 Tair（相容 Redis）執行個體遷移到同地區內的其它可用性區域。

    介面說明

    執行本介面前需要先釋放公網串連地址等，更多資訊請參見遷移可用性區域。

    說明

    • 如果執行個體是從傳統網路切換到專用網路的，並且保留了傳統網路的串連地址，則需等到傳統網路串連地址到期釋放後才能執行可用性區域遷移。

    • 遷移之後執行個體的串連地址不會改變，但 VIP 會發生變化，請在業務中使用串連地址串連執行個體而非其 VIP 位址。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    kvstore:MigrateToOtherZone

    update

    *DBInstance

    acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DBInstanceId

    string

    是

    執行個體 ID。

    r-bp1zxszhcgatnx****
    ZoneId

    string

    是

    要遷移到的目標主可用性區域 ID，可調用 DescribeZones 介面查詢。

    cn-hangzhou-g
    VSwitchId

    string

    否

    虛擬交換器的 ID 。

    說明

    • vSwitch 所在可用性區域須與 ZoneId（目的可用性區域）一致；

    • 如果執行個體的網路類型為 VPC，則該參數為必選。

    vsw-bp1e7clcw529l773d****
    EffectiveTime

    string

    否

    資料移轉後執行資料庫切換的時間，取值：

    • Immediately：遷移完立即切換。

    • MaintainTime：在可維護時間段內切換。

    說明

    預設值：Immediately。

    Immediately
    SecondaryZoneId

    string

    否

    要遷移到的目標備可用性區域 ID，可調用 DescribeZones 介面查詢。

    說明

    傳入本參數可以實現主備資料節點分布在不同的可用性區域，實現跨可用性區域容災，可承受機房層級的故障。

    cn-hangzhou-h
    ReplicaCount

    integer

    否

    主可用性區域的備節點數（個）。

    說明

    • ReplicaCount 與 SlaveReplicaCount 參數僅適用於雲原生版執行個體。在遷移至多可用性區域時，您可以通過本組參數調整執行個體主、備可用性區域的備節點分布。本介面不支援增、減節點數量，因此ReplicaCount + SlaveReplicaCount的總數需與遷移前保持一致。

    • 在單可用性區域遷移至多可用性區域時，如果不填本組參數，則預設遷移 1 個備節點到備可用性區域，其餘都在主可用性區域。

    • 如果執行個體為叢集架構，則上述參數分別表示單分區的（主、備可用性區域）備節點數。

    1
    SlaveReplicaCount

    integer

    否

    備可用性區域的備節點數（個）。

    1
    ReadOnlyCount

    integer

    否

    主可用性區域的唯讀節點數（個）。

    說明

    • ReadOnlyCount 與 SlaveReadOnlyCount 參數僅適用於雲原生版、開啟讀寫分離的執行個體。在遷移多可用性區域時，您可以通過本組參數調整執行個體主、備可用性區域的唯讀節點分布。本介面不支援增、減節點數量，因此ReadOnlyCount + SlaveReadOnlyCount的總數需與遷移前保持一致。

    • 在單可用性區域遷移至多可用性區域時，如果不填本組參數，則預設遷移 1 個唯讀節點到備可用性區域，其餘都在主可用性區域。

    • 如果執行個體為叢集架構，則上述參數分別表示單分區的（主、備可用性區域）唯讀節點數。

    1
    SlaveReadOnlyCount

    integer

    否

    備可用性區域的唯讀節點數（個）。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    29B0BF34-D069-4495-92C7-FA6D9452****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "29B0BF34-D069-4495-92C7-FA6D9452****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 NetworkType.NotSupport Specified network type does not support this operation. 當前執行個體已開啟公網訪問/直連訪問,暫不支援此操作.請關閉公網訪問/直連訪問後執行此操作
    400 InstanceStatus.NotSupport Instance status does not support this operation. 當前執行個體狀態不支援此操作
    400 MissingSwitchId VSwitchId is mandatory for this action.
    400 IzNotSupportVpcError Specify zone not support VPC.
    400 InvalidReginAvzNotFound Specified user does not find the region and zone.
    400 ClusterNotSupport The Specified cluster does not support.
    400 InvalidVSwitchId.Mismatch The Specified vSwitchId does not matched VPC.
    400 InvalidIzNo.NotSupported The Specified Zone does not supported.
    500 VpcServiceError Invoke VPC service failed.
    500 ZoneMigrationError.StillingRunning Zone migration task is still running.
    404 DBInstanceNotFound Specified instance does not exist.

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

    變更歷史

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