All Products
Search

This Product

    Data Management:UpdateInstance

    Document Center

    Data Management:UpdateInstance

    Last Updated:Jun 11, 2026

    Memperbarui informasi instance dan memeriksa konektivitas instance.

    Deskripsi operasi

    Sebelum Anda memanggil operasi UpdateInstance untuk memperbarui informasi instance, Anda harus memanggil operasi GetInstance atau ListInstances untuk mendapatkan informasi lengkap tentang instance.

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

    update

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Tid

    integer

    No

    ID penyewa. Anda dapat memanggil operasi GetUserActiveTenant untuk mendapatkan nilai parameter ini.

    3***
    InstanceType

    string

    Yes

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

    mysql
    InstanceSource

    string

    Yes

    Sumber instance database. Nilai yang valid:

    • PUBLIC_OWN: database yang dikelola sendiri yang dihosting di Internet.

    • RDS: instance ApsaraDB RDS.

    • ECS_OWN: database yang dikelola sendiri yang dihosting pada instance Elastic Compute Service (ECS).

    • VPC_IDC: database yang dikelola sendiri yang dihosting di pusat data yang terhubung melalui virtual private cloud (VPC).

    ECS_OWN
    EnvType

    string

    Yes

    Jenis 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 pengujian beban

    • stag: lingkungan staging

    Valid values:

    • product :

      product

    • pre :

      pre

    • dev :

      dev

    • test :

      test

    product
    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-xxx
    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

    Yes

    Alamat koneksi instance.

    192.XXX.0.56
    Port

    integer

    Yes

    Port akses instance.

    3306
    Sid

    string

    No

    SID dari instance.

    Catatan

    Parameter ini wajib diisi jika InstanceType diatur ke ORACLE.

    XXX
    DatabaseUser

    string

    Yes

    Akun database.

    dbuser
    DatabasePassword

    string

    Yes

    Kata sandi akun database.

    ******
    InstanceAlias

    string

    Yes

    Alias instance, yang membantu pengguna dengan cepat mengidentifikasi dan menemukan instance.

    instance_test
    DbaId

    string

    Yes

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

    27****
    SafeRuleId

    string

    Yes

    Kumpulan aturan keamanan (GroupName) dari instance. Anda dapat memanggil operasi ListStandardGroups atau GetInstance untuk mendapatkan nilai parameter ini.

    3****
    QueryTimeout

    integer

    Yes

    Periode batas waktu kueri instance.

    60
    ExportTimeout

    integer

    Yes

    Periode batas waktu ekspor instance.

    600
    DataLinkName

    string

    No

    Nama tautan data untuk kueri 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 penyewa.

    datalink_test
    DdlOnline

    integer

    No

    Menentukan apakah akan mengaktifkan perubahan skema bebas-kunci untuk instance. Nilai yang valid:

    • 0: tidak digunakan

    • 1: perubahan skema bebas-kunci native diutamakan. Jika perubahan skema bebas-kunci native gagal, perubahan skema bebas-kunci DMS digunakan.

    • 2: perubahan skema bebas-kunci DMS digunakan.

    0
    UseDsql

    integer

    No

    Menentukan apakah akan mengaktifkan kueri lintas-database. Nilai yang valid:

    • 0: dinonaktifkan

    • 1: diaktifkan

    Catatan

    Jenis database berikut didukung: MySQL, SQL Server, PostgreSQL, PolarDB for PostgreSQL (Kompatibel dengan Oracle), dan Redis.

    0
    InstanceId

    string

    Yes

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

    126****
    SkipTest

    boolean

    No

    Menentukan apakah akan melewati pengujian konektivitas instance. Nilai yang valid:

    • true: lewati

    • false: jangan lewati

    false
    EnableSellSitd

    string

    No

    • Y: mengaktifkan perlindungan data sensitif.

    • N: menonaktifkan perlindungan data sensitif.

    • NULL atau nilai lainnya: tidak memperbarui status perlindungan data sensitif. Status aktif atau nonaktif asli dipertahankan.

    Y
    TemplateId

    integer

    No

    ID dari template klasifikasi dan penilaian yang diperbarui. Anda dapat memanggil operasi ListClassificationTemplates untuk mendapatkan nilai parameter ini.

    3***
    TemplateType

    string

    No

    Jenis dari template klasifikasi dan penilaian yang diperbarui. Anda dapat memanggil operasi ListClassificationTemplates untuk mendapatkan nilai parameter ini.

    INNER

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    E9BEBF41-4F69-4605-A5D5-A67955173941
    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.

    false

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.