All Products
Search

This Product

    Auto Scaling:AttachDBInstances

    Document Center

    Auto Scaling:AttachDBInstances

    Last Updated:May 25, 2026

    Menyambungkan instans ApsaraDB RDS ke grup penskalaan. Anda dapat menyesuaikan jumlah instans ApsaraDB RDS yang disambungkan ke grup penskalaan sesuai kebutuhan bisnis guna meningkatkan fleksibilitas penggunaan.

    Catatan penggunaan

    Sebelum menyambungkan instans ApsaraDB RDS ke grup penskalaan, pastikan persyaratan berikut terpenuhi:

    • Instans ApsaraDB RDS dan grup penskalaan berada dalam Akun Alibaba Cloud yang sama.

    • Instans ApsaraDB RDS tidak dalam status terkunci. Untuk informasi lebih lanjut mengenai kebijakan penguncian, lihat Catatan penggunaan ApsaraDB RDS.

    • Instans ApsaraDB RDS berada dalam status Running.

    • Jika grup penskalaan Anda telah memiliki instans ApsaraDB RDS yang disambungkan dan Anda mencoba menyambungkan kembali instans yang sama, jumlah instans ApsaraDB RDS yang terhubung ke grup penskalaan tidak akan berubah. Sebagai gantinya, Auto Scaling secara otomatis menambahkan alamat IP pribadi semua instans Elastic Compute Service (ECS) dalam grup penskalaan ke daftar putih alamat IP instans ApsaraDB RDS tersebut.

    Catatan

    Setelah instans ApsaraDB RDS disambungkan ke grup penskalaan, daftar putih alamat IP default instans tersebut hanya dapat memuat maksimal 1.000 alamat IP. Untuk informasi lebih lanjut, lihat Konfigurasi daftar putih alamat IP untuk instans RDS.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

    Parameter permintaan

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    AttachDBInstances

    Aksi yang ingin Anda lakukan. Tetapkan nilainya ke AttachDBInstances.

    ScalingGroupId

    String

    Yes

    asg-bp1avr6ensitts3w****

    ID grup penskalaan.

    ForceAttach

    Boolean

    No

    false

    Menentukan apakah alamat IP pribadi instans dalam grup penskalaan akan ditambahkan ke daftar putih alamat IP instans ApsaraDB RDS selama proses penyambungan. Nilai yang valid:

    • true

    • false

    Nilai default: false.

    ClientToken

    String

    No

    123e4567-e89b-12d3-a456-42665544****

    Token client yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat membuat token ini di sisi client, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Memastikan idempotensi.

    DBInstance.N

    String

    No

    rm-bp12cy3****

    ID instans ApsaraDB RDS ke-N yang ingin Anda sambungkan ke grup penskalaan. Nilai N yang valid: 1 hingga 5.

    RegionId

    String

    No

    cn-qingdao

    ID wilayah grup penskalaan.

    AttachMode

    String

    No

    SecurityIp

    Metode yang ingin Anda gunakan untuk mengaitkan database dengan grup penskalaan. Nilai yang valid:

    • SecurityIp: Auto Scaling menambahkan alamat IP pribadi instans yang diskalakan ke daftar putih alamat IP database. Anda hanya dapat menetapkan nilai SecurityIp jika database yang ingin Anda sambungkan adalah instans ApsaraDB RDS.

    • SecurityGroup: Auto Scaling menambahkan security group dari konfigurasi penskalaan yang efektif ke daftar putih security group database untuk mengaktifkan akses aman dari instans dalam grup penskalaan ke database.

    Nilai default: SecurityIp.

    Type

    String

    No

    RDS

    Tipe database. Nilai yang valid:

    • RDS: instans ApsaraDB RDS.

    • Redis: instans ApsaraDB for Redis.

    • MongoDB: instans ApsaraDB for MongoDB.

    Nilai default: RDS.

    Parameter respons

    Parameter

    Type

    Example

    Description

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    ID permintaan.

    Contoh

    Contoh permintaan

    http(s)://ess.aliyuncs.com/?Action=AttachDBInstances
&ScalingGroupId=asg-bp1avr6ensitts3w****
&ForceAttach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&DBInstance=["rm-bp12cy3****"]
&RegionId=cn-qingdao
&AttachMode=SecurityIp
&Type=RDS
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<AttachDBInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachDBInstancesResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Kode kesalahan

    Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.

    HTTP status code

    Error code

    Description

    Description

    404

    InvalidScalingGroupId.NotFound

    The specified scaling group does not exist.

    Grup penskalaan yang ditentukan tidak ada dalam Akun Alibaba Cloud Anda.

    400

    QuotaExceeded.RDS

    "RDS" quota exceeded.

    Jumlah maksimum instans ApsaraDB RDS yang dapat disambungkan ke grup penskalaan telah tercapai.

    400

    InvalidDBInstanceId.NotFound

    The specified value of parameter "%s" is not valid.

    Instans ApsaraDB RDS yang ditentukan tidak ada.

    400

    IncorrectDBInstanceStatus

    The current status of DB instance "%s" does not support this action.

    Operasi ini tidak didukung saat instans ApsaraDB RDS berada dalam status saat ini.

    400

    QuotaExceeded.DBInstanceSecurityIP

    Security IP quota exceeded in DB instance "%s".

    Jumlah maksimum alamat IP dalam daftar putih alamat IP instans ApsaraDB RDS telah tercapai.

    400

    InvalidInstanceIds.PrivateIpNotFound

    Can not find all private ips of instances in specific scaling group.

    Alamat IP pribadi salah satu instans dalam grup penskalaan tidak dapat diperoleh.