Tüm Ürünler
Search

Bu Ürün

    :UpdateInstance

    Belge Merkezi

    :UpdateInstance

    Son Güncelleme:Oct 01, 2026

    Bir veritabanı örneği hakkındaki bilgileri günceller ve veritabanı örneğinin bağlantısını kontrol eder.

    Operation description

    UpdateInstance işlemini çağırmadan önce, örnekle ilgili eksiksiz bilgileri almak için GetInstance veya ListInstances işlemini çağırın.

    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

    dms:UpdateInstance

    update

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Tid

    integer

    No

    Kiracının kimliği. Kiracı kimliğini sorgulamak için GetUserActiveTenant işlemini çağırabilirsiniz.

    3***
    InstanceType

    string

    Yes

    Veritabanının türü. Bu parametrenin geçerli değerleri hakkında daha fazla bilgi için DbType parametresi bölümüne bakın.

    mysql
    InstanceSource

    string

    Yes

    Veritabanı örneğinin kaynağı. Geçerli değerler:

    • PUBLIC_OWN: İnternet üzerinde kurulu, kendi kendine yönetilen bir veritabanı örneği

    • RDS: Bir ApsaraDB RDS örneği

    • ECS_OWN: Elastic Compute Service (ECS) örneği üzerinde kurulu, kendi kendine yönetilen bir veritabanı

    • VPC_IDC: Sanal özel bulut (VPC) üzerinden bağlanan bir veri merkezinde kurulu, kendi kendine yönetilen bir veritabanı örneği

    ECS_OWN
    EnvType

    string

    Yes

    Veritabanı örneğinin kurulduğu ortamın türü. Geçerli değerler:

    • product: üretim ortamı

    • dev: geliştirme ortamı

    • pre: yayın öncesi ortamı

    • test: test ortamı

    • sit: sistem entegrasyon testi (SIT) ortamı

    • uat: kullanıcı kabul testi (UAT) ortamı

    • pet: stres testi ortamı

    • stag: hazırlık ortamı

    Valid values:

    • product :

      product.

    • pre :

      pre.

    • dev :

      dev.

    • test :

      test.

    product
    EcsInstanceId

    string

    No

    Veritabanı örneğinin kurulu olduğu ECS örneğinin kimliği.

    Not

    InstanceSource parametresi ECS_OWN olarak ayarlanmışsa bu parametre gereklidir.

    i-2zei9gs1t7h8l7ac****
    VpcId

    string

    No

    Veritabanı örneğinin ait olduğu VPC'nin kimliği.

    Not

    InstanceSource parametresi VPC_IDC olarak ayarlanmışsa bu parametre gereklidir.

    vpc-xxx
    EcsRegion

    string

    No

    Veritabanı örneğinin bulunduğu bölgenin kimliği.

    Not

    InstanceSource parametresi RDS, ECS_OWN ve VPC_IDC olarak ayarlanmışsa bu parametre gereklidir.

    cn-hangzhou
    Host

    string

    Yes

    Veritabanı örneğine bağlanmak için kullanılan ana makine adresi.

    192.XXX.0.56
    Port

    integer

    Yes

    Veritabanı örneğine bağlanmak için kullanılan bağlantı noktası.

    3306
    Sid

    string

    No

    Veritabanı örneğinin sistem kimliği (SID).

    Not

    InstanceType parametresi ORACLE olarak ayarlanmışsa bu parametre gereklidir.

    XXX
    DatabaseUser

    string

    Yes

    Veritabanında oturum açmak için kullanılan hesap.

    dbuser
    DatabasePassword

    string

    Yes

    Veritabanında oturum açmak için kullanılan parola.

    ******
    InstanceAlias

    string

    Yes

    Veritabanı örneğinin diğer adı. DMS'de veritabanı örneğini tanımlamanıza yardımcı olabilecek bir diğer ad belirtin.

    instance_test
    DbaId

    string

    Yes

    Veritabanı örneğinin veritabanı yöneticisi (DBA) rolünü üstlenen kullanıcının kimliği. Kullanıcı kimliğini sorgulamak için ListUsers veya GetInstance işlemini çağırabilirsiniz.

    27****
    SafeRuleId

    string

    Yes

    Örnek için güvenlik kuralı kümesinin (GroupName) adı. Güvenlik kuralı kümesinin adını sorgulamak için ListStandardGroups veya GetInstance işlemini çağırabilirsiniz.

    3****
    QueryTimeout

    integer

    Yes

    Veritabanı örneğindeki verileri sorgulamak için zaman aşımı süresi.

    60
    ExportTimeout

    integer

    Yes

    Veritabanı örneğinden veri dışa aktarmak için zaman aşımı süresi.

    600
    DataLinkName

    string

    No

    Veritabanları arası sorgular için veritabanı bağlantısının adı.

    Not

    • UseDsql değeri 1 olarak ayarlanmışsa bu parametre gereklidir.

    • Ad yalnızca küçük harfler ve alt çizgiler (_) içerebilir.

    • Ad, bir kiracı içinde benzersiz olmalıdır.

    datalink_test
    DdlOnline

    integer

    No

    Veritabanı örneği için kilitsiz şema değişikliği özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • 0: Kilitsiz şema değişikliği özelliğini devre dışı bırakır.

    • 1: Önce MySQL'in çevrimiçi DDL'sini kullanır.

    • 2: Önce DMS'nin kilitsiz şema değişikliği özelliğini kullanır.

    0
    UseDsql

    integer

    No

    Veritabanı örneği için veritabanları arası sorgu özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • 0: Veritabanları arası sorgu özelliğini devre dışı bırakır.

    • 1: Veritabanları arası sorgu özelliğini etkinleştirir.

    Not

    Desteklenen veritabanı türleri: MySQL, SQL Server, PostgreSQL, PolarDB for PostgreSQL (Oracle uyumlu) ve ApsaraDB for Redis.

    0
    InstanceId

    string

    Yes

    Veritabanı örneğinin kimliği. Örnek kimliğini sorgulamak için GetInstance işlemini çağırabilirsiniz.

    126****
    SkipTest

    boolean

    No

    Bağlantı testinin atlanıp atlanmayacağını belirtir. Geçerli değerler:

    • true: Bağlantı testi atlanır.

    • false: Bağlantı testi atlanmaz.

    false
    EnableSellSitd

    string

    No

    • Y: Hassas veri koruma özelliğini etkinleştirir

    • N: Hassas veri koruma özelliğini devre dışı bırakır

    • NULL veya diğer: Hassas veri koruma özelliğinin durumunu güncellemez

    Y
    TemplateId

    integer

    No

    Sınıflandırma şablonunun kimliği. Şablon kimliğini sorgulamak için ListClassificationTemplates işlemini çağırabilirsiniz.

    3***
    TemplateType

    string

    No

    Sınıflandırma şablonunun türü. Şablon türünü sorgulamak için ListClassificationTemplates işlemini çağırabilirsiniz.

    INNER

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İsteğin kimliği.

    E9BEBF41-4F69-4605-A5D5-A67955173941
    ErrorCode

    string

    İsteğin başarısız olması durumunda döndürülen hata kodu.

    UnknownError
    ErrorMessage

    string

    İsteğin başarısız olması durumunda döndürülen hata mesajı.

    UnknownError
    Success

    boolean

    İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:

    • true: İstek başarılı oldu.

    • false: İstek başarısız oldu.

    false

    Examples

    Success response

    JSON format

    {
  "RequestId": "E9BEBF41-4F69-4605-A5D5-A67955173941",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": false
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.