Tüm Ürünler
Search

Bu Ürün

    :AddInstance

    Belge Merkezi

    :AddInstance

    Son Güncelleme:Oct 01, 2026

    Data Management Service (DMS) üzerinde bir veritabanı örneği kaydeder ve örnek için güvenlik barındırmayı etkinleştirir.

    Operation description

    Sistem rolünüz DBA veya yönetici olmalıdır. Sistem rolünüzü görüntülemek için Sistem rolümü görüntüle bölümüne bakı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:AddInstance

    create

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Tid

    integer

    No

    Kiracı kimliği.

    Not

    Kiracı kimliğini, DMS konsolunun sağ üst köşesindeki profil simgesinin üzerine gelerek bulabilirsiniz.

    23****
    InstanceType

    string

    Yes

    Veritabanı türü. Geçerli değerler için DbType parametre açıklaması bölümüne bakın.

    MySQL
    InstanceSource

    string

    Yes

    Örneğin kaynağı. Geçerli değerler:

    • PUBLIC_OWN: İnternet üzerinden bağlanan kendi yönettiğiniz bir örnek.

    • RDS: Bir ApsaraDB RDS örneği.

    • ECS_OWN: Bir ECS örneği üzerindeki kendi yönettiğiniz bir örnek.

    • VPC_IDC: VPC'ye bağlı bir IDC'deki kendi yönettiğiniz bir örnek.

    • GATEWAY: Bir Database Gateway örneği.

    RDS
    NetworkType

    string

    Yes

    Ağ türü. Geçerli değerler:

    • CLASSIC: Klasik ağ.

    • VPC: VPC ağı.

    VPC
    EnvType

    string

    Yes

    Ortam türü. Geçerli değerler:

    • product: Üretim ortamı.

    • dev: Geliştirme ortamı.

    • pre: Yayın öncesi ortamı.

    • test: Test ortamı.

    • sit: SIT ortamı.

    • uat: UAT ortamı.

    • pet: Stres testi ortamı.

    • stag: STAG ortamı.

    product
    EcsInstanceId

    string

    No

    Örnek kimliği. Örneğin, örneğiniz bir Database Gateway örneği ise ağ geçidi kimliğini girin.

    Not

    InstanceSource değeri ECS_OWN veya GATEWAY olarak ayarlanmışsa bu parametre gereklidir.

    i-2zei9gs1t7h8l7ac****
    VpcId

    string

    No

    VPC örnek kimliği.

    Not

    InstanceSource değeri VPC_IDC olarak ayarlanmışsa bu parametre gereklidir.

    vpc-2zef4o1hu7ljd****
    EcsRegion

    string

    No

    Örneğin bulunduğu bölge.

    Not

    InstanceSource değeri RDS, ECS_OWN, GATEWAY veya VPC_IDC olarak ayarlanmışsa bu parametre gereklidir.

    cn-hangzhou
    Host

    string

    Yes

    Veritabanı bağlantı adresi.

    rm-bp1g3tf90******.sqlserver.rds.aliyuncs.com
    Port

    integer

    Yes

    Veritabanı bağlantı noktası.

    3306
    Sid

    string

    No

    Örneğin SID'si.

    Not

    InstanceType değeri ORACLE olarak ayarlanmışsa bu parametre gereklidir.

    testSid
    DatabaseUser

    string

    No

    Veritabanı hesabı.

    testsdb
    DatabasePassword

    string

    No

    Veritabanı parolası.

    test***
    InstanceAlias

    string

    Yes

    Örneği hızlı bir şekilde tanımlamanıza yardımcı olan örnek diğer adı.

    Test instance.
    DbaId

    integer

    Yes

    Örneğin DBA'sının kullanıcı kimliği. Bu değeri almak için ListUsers veya GetInstance işlemini çağırabilirsiniz.

    27****
    QueryTimeout

    integer

    Yes

    Sorgu zaman aşımı süresi. Birim: saniye.

    7200
    ExportTimeout

    integer

    Yes

    Dışa aktarma zaman aşımı süresi. Birim: saniye.

    86400
    EnableSellTrust

    string

    Yes

    Örnek için güvenlik barındırmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • Y: Güvenlik barındırma modunu etkinleştir.

    • N: Güvenlik barındırma modunu etkinleştirme.

    Y
    EnableSellStable

    string

    No

    Örnek için kararlı değişiklik özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • Y: Etkinleştir.

    • N: Etkinleştirme.

    N
    EnableSellCommon

    string

    No

    Örnek için güvenlik işbirliği özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • Y: Etkinleştir.

    • N: Etkinleştirme.

    Y
    SafeRule

    string

    No

    Güvenlik işbirliği özelliğini etkinleştirmek istiyorsanız, örnek için güvenlik kuralı kümesini (GroupName) belirtmeniz gerekir. Bu değeri almak için ListStandardGroups veya GetInstance işlemini çağırabilirsiniz.

    Finance-Production.
    EnableSellSitd

    string

    No

    Örnek için hassas veri koruma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • Y: Etkinleştir.

    • N: Etkinleştirme.

    Y
    DataLinkName

    string

    No

    Örnekler arası veritabanı sorgusu veri bağlantısının adı.

    Not

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

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

    • DBLink adı kiracı içinde global olarak benzersiz olmalıdır.

    dblink_test
    DdlOnline

    integer

    No

    DMS yapı değişikliğine öncelik verilip verilmeyeceğini belirtir. Geçerli değerler:

    • 0: Kullanma.

    • 1: Yerel Online DDL önceliklidir.

    • 2: DMS kilitsiz yapı değişikliği önceliklidir.

    Not

    Desteklenen veritabanı türleri: ApsaraDB RDS for MySQL, PolarDB for MySQL, MyBase for MySQL ve diğer MySQL kaynakları.

    2
    UseDsql

    integer

    No

    Örnekler arası sorgunun etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • 0: Devre dışı bırak.

    • 1: Etkinleştir.

    Not

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

    1
    SkipTest

    boolean

    No

    Örnek için bağlantı testinin atlanıp atlanmayacağını belirtir. Geçerli değerler:

    • true: Atla.

    • false: Atlama.

    false
    TemplateId

    integer

    No

    Veri sınıflandırma şablonunun kimliği. Bu değeri almak için ListClassificationTemplates işlemini çağırabilirsiniz.

    31***
    TemplateType

    string

    No

    Kategorilendirme şablonu türü. Bu değeri almak için ListClassificationTemplates işlemini çağırabilirsiniz.

    INNER
    UseSsl

    integer

    No

    SSL bağlantısının etkinleştirilip etkinleştirilmeyeceğini belirtir. SSL etkinleştirildikten sonra DMS, veritabanına SSL üzerinden bağlanır. Bu parametreyi kullanmadan önce veritabanında SSL etkinleştirilmiş olmalıdır. Geçerli değerler:

    • 0: Varsayılan değer (DMS ve veritabanı hizmeti, SSL'nin etkinleştirilip etkinleştirilmeyeceğini otomatik olarak müzakere eder). Sistem, hedef veritabanında SSL'nin etkin olup olmadığını otomatik olarak belirler. SSL etkinse, DMS veritabanına SSL üzerinden bağlanır. Aksi takdirde, DMS normal bir yöntemle bağlanır.

    • 1: SSL bağlantısını etkinleştir. Veritabanında SSL etkinleştirilmemişse bu parametre etkili olmaz.

    • -1: SSL bağlantısını devre dışı bırak.

    Not

    • Bu yapılandırma öğesi yalnızca veritabanı türü MySQL veya Redis olduğunda kullanılabilir.

    • SSL (Secure Sockets Layer), ağ bağlantılarını aktarım katmanında şifreleyerek iletişim verilerinin güvenliğini ve bütünlüğünü artırır, ancak ağ bağlantısı yanıt süresini uzatır.

    0
    RoleArn

    string

    No

    Kiracılar arası kayıt için kullanılan, hedef hesaptaki yetkilendirilmiş rolün ARN'si.

    acs:ram::1760865*********:role/dms-role-arn
    LoginType

    integer

    No

    • 0: Kullanıcı adı ve parola ile oturum açma.

    • 1: Yalnızca parola (Redis).

    • 2: Parolasız oturum açma (Redis).

    0

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İstek kimliği. Günlükleri bulmak ve sorunları gidermek için bu kimliği kullanabilirsiniz.

    0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931
    ErrorCode

    string

    Hata kodu.

    UnknownError
    ErrorMessage

    string

    Hata mesajı.

    UnknownError
    Success

    boolean

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

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

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

    true

    Examples

    Success response

    JSON format

    {
  "RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": true
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.