Tüm Ürünler
Search

Bu Ürün

    :SwitchInstanceHA

    Belge Merkezi

    :SwitchInstanceHA

    Son Güncelleme:Oct 14, 2026

    Bir örnek için yük devretme (düğüm rollerini değiştirme) işlemi gerçekleştirir. Bu işlem, afet kurtarma tatbikatları ve çok bölgeli dağıtımlarda uygulamaları en yakın düğüme bağlama gibi senaryolar için uygundur.

    Operation description

    Not

    Çok bölgeli dağıtımlarda uygulamaları en yakın düğüme bağlama hakkında ayrıntılı bilgi için Senaryo örnekleri bölümüne bakın.

    Bu işlemi çağırdığınızda, örneğin Yüksek kullanılabilirlik veya Replika türünde olması gerekir.

    Bu işlemi çağırmanın aşağıdaki etkileri vardır:

    • Bir düğüm rolü değişimi tetiklendikten sonra, değişime dahil olan veri düğümleri birkaç saniye süren geçici bir salt okunur duruma ve bağlantı kesintilerine maruz kalır. Uygulamalarınızın bir yeniden bağlanma mekanizmasına sahip olduğundan emin olun.

    • Örnek geçiş durumundayken, örnek düzeyinde işlemler (yapılandırmaları değiştirme veya bölge taşıma gibi) gerçekleştiremezsiniz.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    kvstore:SwitchInstanceHA

    update

    *All resources.

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    Örneğin kimliği. Örnek kimliğini sorgulamak için DescribeInstances işlemini çağırabilirsiniz.

    r-bp1zxszhcgatnx****
    NodeId

    string

    No

    Veri parçası düğümlerinin kimlikleri. CustinsId parametresini almak için DescribeRoleZoneInfo işlemini çağırabilirsiniz. Birden fazla veri parçası düğümü kimliğini virgülle (,) ayırın. Tüm düğümleri belirtmek için all değerini girin.

    Not

    Bu parametre yalnızca örnek bir küme veya okuma/yazma bölme mimarisi kullandığında kullanılabilir ve gereklidir.

    56****19,56****20
    SwitchMode

    integer

    No

    Çalıştırma zamanı. Geçerli değerler:

    • 0: Hemen çalıştırılır. Bu, varsayılan değerdir.

    • 1: Bakım penceresi sırasında çalıştırılır.

    Not

    Örneğin bakım penceresini değiştirmek için ModifyInstanceMaintainTime işlemini çağırabilirsiniz.

    0
    SwitchType

    string

    No

    Geçiş modu. Geçerli değerler:

    • ReliabilityPriority (varsayılan): Güvenilirliği önceliklendirir. Yük devretme işlemi yalnızca birincil ve ikincil düğümler tam olarak eşitlendiğinde gerçekleştirilir ve veri kaybı olmaması sağlanır. Yoğun yazma trafiğinin ve kalıcı eşitleme gecikmelerinin olduğu senaryolarda bu mod, yük devretme işleminin başarısız olmasına neden olabilir.

    • AvailablePriority: Kullanılabilirliği önceliklendirir. Eşitleme gecikmesinden bağımsız olarak hemen yük devretme işlemi gerçekleştirilir, bu da küçük çaplı veri kaybına yol açabilir.

    Not

    Veri ve hizmet sürekliliğine ilişkin iş gereksinimlerinize göre geçiş modunu seçmelisiniz.

    Valid values:

    • AvailablePriority :

      AvailablePriority.

    • ReliabilityPriority :

      ReliabilityPriority.

    ReliabilityPriority
    SourceNodeId

    string

    No

    Parçadaki orijinal birincil düğümün kimliği.

    52717408
    TargetNodeId

    string

    No

    Geçişten sonraki hedef birincil düğümün kimliği.

    52717403
    TargetShardName

    string

    No

    Örnekteki parçanın adı.

    r-2zegk3jyxxxwixfo6c-db-1

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İsteğin kimliği.

    5D622714-AEDD-4609-9167-F5DDD3D1****
    TaskId

    string

    Görevin kimliği.

    674546459

    Examples

    Success response

    JSON format

    {
  "RequestId": "5D622714-AEDD-4609-9167-F5DDD3D1****",
  "TaskId": "674546459"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.