All Products
Search

This Product

    Data Management:ModifyInstance

    Document Center

    Data Management:ModifyInstance

    Last Updated:Jun 11, 2026

    Panggil API ini saat Anda perlu memodifikasi informasi dasar dari sebuah instance (seperti mode pengelolaannya, akun dan kata sandi database, serta paket fitur) dan informasi lanjutan (seperti tipe lingkungan, nama instance di DMS, dan periode timeout untuk meng-query dan mengekspor data).

    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:ModifyInstance

    update

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID instance. Anda dapat memanggil operasi ListInstances atau GetInstance untuk mendapatkan nilai parameter ini.

    183****
    Tid

    integer

    No

    ID tenant.

    Catatan

    Arahkan pointer ke gambar profil di sudut kanan atas konsol DMS untuk melihat ID tenant.

    23****

    InstanceType

    string

    No

    Tipe database. Untuk informasi selengkapnya tentang nilai yang valid, lihat Deskripsi parameter DbType.

    MySQL
    InstanceSource

    string

    No

    Sumber instance. Nilai yang valid:

    • PUBLIC_OWN: instance yang dikelola sendiri yang di-deploy pada jaringan publik.

    • RDS: instance ApsaraDB RDS.

    • ECS_OWN: instance yang dikelola sendiri yang di-host pada instance Elastic Compute Service (ECS).

    • VPC_IDC: instance yang dikelola sendiri yang di-host di data center yang terhubung melalui virtual private cloud (VPC).

    RDS
    NetworkType

    string

    No

    Tipe jaringan. Nilai yang valid:

    • CLASSIC: jaringan klasik.

    • VPC: virtual private cloud (VPC).

    VPC
    EnvType

    string

    No

    Tipe lingkungan. Nilai yang valid:

    • product: lingkungan produksi.

    • dev: lingkungan pengembangan.

    • pre: lingkungan pra-rilis.

    • test: lingkungan pengujian.

    • sit: lingkungan system integration testing (SIT).

    • uat: lingkungan user acceptance testing (UAT).

    • pet: lingkungan stress testing.

    • stag: lingkungan staging (STAG).

    dev
    EcsInstanceId

    string

    No

    ID instance ECS.

    Catatan

    Parameter ini wajib diisi jika InstanceSource diatur ke ECS_OWN.

    i-2zei9gs1t7h8l7ac****
    VpcId

    string

    No

    ID VPC dari instance.

    Catatan

    Parameter ini wajib diisi jika InstanceSource diatur ke VPC_IDC.

    vpc-bp10wnlcmor****
    EcsRegion

    string

    No

    Region tempat instance berada.

    Catatan

    Parameter ini wajib diisi jika InstanceSource diatur ke RDS, ECS_OWN, atau VPC_IDC.

    cn-hangzhou
    Host

    string

    No

    Endpoint yang digunakan untuk terhubung ke instance.

    192.XXX.0.56
    Port

    integer

    No

    Port yang digunakan untuk mengakses instance.

    3306
    Sid

    string

    No

    SID dari instance.

    Catatan

    Parameter ini wajib diisi jika InstanceType diatur ke ORACLE.

    testSid
    DatabaseUser

    string

    No

    Akun database.

    testsdb

    DatabasePassword

    string

    No

    Kata sandi akun database.

    test***

    InstanceAlias

    string

    No

    Alias dari instance. Membantu pengguna mengidentifikasi dan menemukan instance dengan cepat.

    instance_test
    DbaId

    integer

    No

    ID pengguna database administrator (DBA) dari instance. Anda dapat memanggil operasi ListUsers atau GetInstance untuk mendapatkan nilai parameter ini.

    27****
    QueryTimeout

    integer

    No

    Periode timeout query. Satuan: detik (s).

    7200
    ExportTimeout

    integer

    No

    Periode timeout ekspor. Satuan: detik (s).

    86400
    EnableSellTrust

    string

    No

    Menentukan apakah akan mengaktifkan Security Hosting untuk instance.

    • Y: mengaktifkan mode Security Hosting.

    • N: tidak mengaktifkan mode Security Hosting.

    Y
    EnableSellStable

    string

    No

    Menentukan apakah akan mengaktifkan fitur Stable Change untuk instance.

    • Y: mengaktifkan fitur.

    • N: tidak mengaktifkan fitur.

    N
    EnableSellCommon

    string

    No

    Menentukan apakah akan mengaktifkan fitur Security Collaboration untuk instance.

    • Y: mengaktifkan fitur.

    • N: tidak mengaktifkan fitur.

    Y
    SafeRule

    string

    No

    Jika Anda ingin mengaktifkan paket fitur Security Collaboration, Anda harus menentukan set aturan keamanan (GroupName) untuk instance. Anda dapat memanggil operasi ListStandardGroups atau GetInstance untuk mendapatkan nilai parameter ini.

    金融线-生产
    EnableSellSitd

    string

    No

    Menentukan apakah akan mengaktifkan fitur perlindungan data sensitif untuk instance.

    • Y: mengaktifkan fitur perlindungan data sensitif.

    • N: tidak mengaktifkan fitur perlindungan data sensitif.

    Y
    DataLinkName

    string

    No

    Nama datalink yang digunakan untuk query lintas database.

    Catatan

    • Parameter ini wajib diisi jika UseDsql diatur ke 1.

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

    • Nama DBLink harus unik secara global dalam satu tenant.

    dblink_test
    DdlOnline

    integer

    No

    Menentukan apakah akan memprioritaskan fitur schema change. Nilai yang valid:

    • 0: tidak digunakan.

    • 1: memprioritaskan Online DDL native.

    • 2: memprioritaskan fitur lock-free schema change dari DMS.

    Catatan

    Tipe 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 query lintas instance. Nilai yang valid:

    • 0: menonaktifkan query lintas instance.

    • 1: mengaktifkan query lintas instance.

    Catatan

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

    1
    SkipTest

    boolean

    No

    Menentukan apakah akan melewati uji konektivitas untuk instance. Nilai yang valid:

    • true: melewati uji konektivitas.

    • false: tidak melewati uji konektivitas.

    false
    TemplateId

    integer

    No

    ID template klasifikasi dan grading data. Anda dapat memanggil operasi ListClassificationTemplates untuk mendapatkan nilai parameter ini.

    31***
    TemplateType

    string

    No

    Tipe template klasifikasi dan grading data. Anda dapat memanggil operasi ListClassificationTemplates untuk mendapatkan nilai parameter ini.

    INNER
    UseSsl

    integer

    No

    Menentukan apakah akan mengaktifkan koneksi SSL. Setelah koneksi SSL diaktifkan, DMS terhubung ke database melalui SSL. Prasyaratnya adalah koneksi SSL diaktifkan untuk database. Nilai yang valid:

    • 0: nilai default (DMS dan layanan database secara otomatis menegosiasikan apakah akan mengaktifkan SSL). Sistem secara otomatis mendeteksi apakah koneksi SSL diaktifkan untuk database tujuan. Jika koneksi SSL diaktifkan untuk database, DMS terhubung ke database melalui SSL. Jika koneksi SSL tidak diaktifkan untuk database, DMS terhubung ke database dalam mode standar.

    • 1: mengaktifkan koneksi SSL. Jika koneksi SSL tidak diaktifkan untuk database, parameter ini tidak valid.

    • -1: menonaktifkan koneksi SSL.

    Catatan

    • Parameter ini hanya tersedia ketika database adalah MySQL atau Redis.

    • Secure Sockets Layer (SSL) mengenkripsi koneksi jaringan pada lapisan transport untuk meningkatkan keamanan dan integritas data komunikasi, tetapi meningkatkan waktu respons koneksi jaringan.

    0

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan. Digunakan untuk menemukan 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.