全部产品
Search

搜索本产品

    ：AddInstance

    文档中心

    ：AddInstance

    更新时间：Jan 23, 2026

    Operasi ini menambahkan instans database ke Data Management (DMS) dan memungkinkan Anda mengaktifkan hosting keamanan untuk instans tersebut.

    Deskripsi operasi

    Anda harus memiliki peran Database Administrator (DBA) atau administrator. Untuk informasi selengkapnya tentang cara melihat peran sistem Anda, lihat View my system role.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dms:AddInstance

    create

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Tid

    integer

    No

    ID penyewa.

    Catatan

    Untuk mendapatkan ID penyewa, arahkan pointer ke gambar profil Anda di pojok kanan atas konsol DMS.

    23****
    InstanceType

    string

    Yes

    Jenis database. Untuk informasi selengkapnya, lihat DbType parameter.

    MySQL
    InstanceSource

    string

    Yes

    Sumber instans. Nilai yang valid:

    • PUBLIC_OWN: instans yang dikelola sendiri dan terhubung melalui Internet.

    • RDS: instans ApsaraDB RDS.

    • ECS_OWN: database yang dikelola sendiri yang di-hosting pada instans Elastic Compute Service (ECS).

    • VPC_IDC: database yang dikelola sendiri di pusat data yang terhubung ke Alibaba Cloud melalui Virtual Private Cloud (VPC).

    • GATEWAY: instans database yang terhubung melalui gateway database.

    RDS
    NetworkType

    string

    Yes

    Jenis jaringan. Nilai yang valid:

    • CLASSIC: jaringan klasik

    • VPC: VPC

    VPC
    EnvType

    string

    Yes

    Jenis lingkungan. Nilai yang valid:

    • product: lingkungan produksi

    • dev: lingkungan pengembangan

    • pre: lingkungan staging

    • test: lingkungan pengujian

    • sit: lingkungan SIT

    • uat: lingkungan UAT

    • pet: lingkungan uji stres

    • stag: lingkungan STAG

    product
    EcsInstanceId

    string

    No

    ID instans. Misalnya, jika instans Anda adalah instans gateway database, masukkan ID gateway tersebut.

    Catatan

    Parameter ini wajib diisi jika Anda mengatur InstanceSource ke ECS_OWN atau GATEWAY.

    i-2zei9gs1t7h8l7ac****
    VpcId

    string

    No

    ID VPC.

    Catatan

    Parameter ini wajib diisi jika Anda mengatur InstanceSource ke VPC_IDC.

    vpc-2zef4o1hu7ljd****
    EcsRegion

    string

    No

    Wilayah tempat instans berada.

    Catatan

    Parameter ini wajib diisi jika Anda mengatur InstanceSource ke RDS, ECS_OWN, GATEWAY, atau VPC_IDC.

    cn-hangzhou
    Host

    string

    Yes

    Titik akhir database.

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

    integer

    Yes

    Port yang digunakan untuk menghubungkan ke database.

    3306
    Sid

    string

    No

    System ID (SID) instans.

    Catatan

    Parameter ini wajib diisi jika Anda mengatur InstanceType ke ORACLE.

    testSid
    DatabaseUser

    string

    Yes

    akun database.

    testsdb
    DatabasePassword

    string

    Yes

    Password untuk akun database.

    test***
    InstanceAlias

    string

    Yes

    Alias instans. Alias ini membantu Anda mengidentifikasi instans tersebut.

    测试实例
    DbaId

    integer

    Yes

    ID pengguna yang memiliki role DBA untuk instans tersebut. Untuk mendapatkan ID pengguna, panggil operasi ListUsers atau GetInstance.

    27****
    QueryTimeout

    integer

    Yes

    Periode timeout untuk kueri. Satuan: detik.

    7200
    ExportTimeout

    integer

    Yes

    Periode timeout untuk ekspor. Satuan: detik.

    86400
    EnableSellTrust

    string

    Yes

    Menentukan apakah akan mengaktifkan hosting keamanan untuk instans tersebut.

    • Y: Aktifkan hosting keamanan.

    • N: Jangan aktifkan hosting keamanan.

    Y
    EnableSellStable

    string

    No

    Menentukan apakah akan mengaktifkan fitur Stable Change untuk instans tersebut.

    • Y: Aktifkan fitur tersebut.

    • N: Jangan aktifkan fitur tersebut.

    N
    EnableSellCommon

    string

    No

    Menentukan apakah akan mengaktifkan fitur Security Collaboration untuk instans tersebut.

    • Y: Aktifkan fitur tersebut.

    • N: Jangan aktifkan fitur tersebut.

    Y
    SafeRule

    string

    No

    Kumpulan aturan keamanan (GroupName) untuk instans tersebut. Parameter ini wajib diisi jika Anda mengaktifkan fitur Security Collaboration. Untuk mendapatkan nilai parameter ini, panggil operasi ListStandardGroups atau GetInstance.

    金融线-生产
    EnableSellSitd

    string

    No

    Menentukan apakah akan mengaktifkan fitur perlindungan data sensitif untuk instans tersebut.

    • Y: Aktifkan fitur tersebut.

    • N: Jangan aktifkan fitur tersebut.

    Y
    DataLinkName

    string

    No

    Nama TautanDB (DBLink) untuk kueri lintas database.

    Catatan

    • Parameter ini wajib diisi jika Anda mengatur UseDsql ke 1.

    • Nama DBLink hanya boleh berisi huruf kecil dan garis bawah (_).

    • Nama DBLink harus unik dalam satu penyewa.

    dblink_test
    DdlOnline

    integer

    No

    Menentukan apakah akan memprioritaskan DMS untuk evolusi skema. Nilai yang valid:

    • 0: Jangan prioritaskan DMS.

    • 1: Prioritaskan DDL online native.

    • 2: Prioritaskan evolusi skema bebas lock dari DMS.

    Catatan

    Jenis database yang didukung: ApsaraDB RDS for MySQL, PolarDB for MySQL, MyBase for MySQL, dan database MySQL lainnya.

    2
    UseDsql

    integer

    No

    Menentukan apakah akan mengaktifkan kueri lintas instans. Nilai yang valid:

    • 0: Jangan aktifkan.

    • 1: Aktifkan.

    Catatan

    Jenis database yang didukung: MySQL, SQL Server, PostgreSQL, PolarDB for Oracle, dan Redis.

    1
    SkipTest

    boolean

    No

    Menentukan apakah akan melewati uji konektivitas. Nilai yang valid:

    • true: Lewati uji tersebut.

    • false: Jangan lewati uji tersebut.

    false
    TemplateId

    integer

    No

    ID templat klasifikasi data. Untuk mendapatkan ID templat, panggil operasi ListClassificationTemplates.

    31***
    TemplateType

    string

    No

    Jenis templat klasifikasi data. Untuk mendapatkan jenis templat, panggil operasi ListClassificationTemplates.

    INNER
    UseSsl

    integer

    No

    Menentukan apakah akan mengaktifkan enkripsi SSL. Jika Anda mengaktifkan fitur ini, DMS akan terhubung ke database melalui koneksi terenkripsi SSL. Parameter ini hanya berlaku jika database mendukung enkripsi SSL. Nilai yang valid:

    • 0: Nilai default. DMS secara otomatis bernegosiasi dengan database untuk menentukan apakah akan menggunakan koneksi SSL. Jika database mendukung SSL, DMS akan terhubung melalui koneksi terenkripsi SSL. Jika database tidak mendukung SSL, DMS akan terhubung melalui koneksi biasa.

    • 1: Aktifkan enkripsi SSL. Nilai ini tidak valid jika database tidak mendukung SSL.

    • -1: Nonaktifkan enkripsi SSL.

    Catatan

    • Parameter ini hanya tersedia untuk database MySQL dan Redis.

    • Secure Sockets Layer (SSL) mengenkripsi koneksi jaringan pada lapisan transport untuk meningkatkan keamanan dan integritas data yang sedang ditransmisikan. Namun, hal ini dapat meningkatkan waktu respons koneksi jaringan.

    0

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan. Anda dapat menggunakan ID ini untuk mengkueri log dan memecahkan masalah.

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

    string

    kode kesalahan.

    UnknownError
    ErrorMessage

    string

    Pesan kesalahan.

    UnknownError
    Success

    boolean

    Menunjukkan apakah permintaan berhasil. Nilai yang valid:

    • true: Permintaan berhasil.

    • false: Permintaan gagal.

    true

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.