Buat instans hanya baca - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi CreateReadOnlyDBInstance untuk membuat instans hanya baca pada instans utama.

Sebelum memanggil operasi ini, perhatikan batasan berikut:

Instans utama tidak boleh termasuk dalam dedicated cluster dan harus menjalankan salah satu versi mesin database dan edisi RDS berikut:
- MySQL 8.0 pada RDS High-availability Edition atau RDS Enterprise Edition.
- MySQL 5.7 pada RDS High-availability Edition atau RDS Enterprise Edition.
- MySQL 5.6.
- SQL Server 2017 pada RDS Cluster Edition.
- PostgreSQL 10, PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14, atau PostgreSQL 15 pada RDS High-availability Edition. Jika instans utama menjalankan PostgreSQL 10, instans tersebut harus menggunakan local SSD dan merupakan dedicated instance dengan minimal 8 core serta memori 32 GB.
Jika instans utama menjalankan MySQL, Anda dapat membuat hingga 10 instans hanya baca.
Jika instans utama menjalankan SQL Server, Anda dapat membuat hingga tujuh instans hanya baca.
Jika instans utama menjalankan PostgreSQL dengan local SSD, Anda dapat membuat hingga lima instans hanya baca. Jika instans utama menjalankan PostgreSQL dengan standard SSD atau enhanced SSD (ESSD), Anda dapat membuat hingga 32 instans hanya baca.

Debugging

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

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	CreateReadOnlyDBInstance	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateReadOnlyDBInstance.
ClientToken	String	Tidak	ETnLKlblzczshOTUbOC****	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilai ini dari sisi client, tetapi pastikan nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.
RegionId	String	Ya	cn-hangzhou	ID wilayah instans hanya baca. Instans hanya baca dan instans utama harus berada di wilayah yang sama. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
ZoneId	String	Ya	cn-hangzhou-b	ID zona instans hanya baca. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar zona terbaru.
DBInstanceId	String	Ya	rm-uf6wjk5****	ID instans utama.
DBInstanceClass	String	Ya	rds.mys2.small	Tipe instans instans hanya baca. Untuk informasi selengkapnya, lihat Tipe instans ApsaraDB RDS hanya baca. Kami menyarankan Anda menentukan tipe instans dengan spesifikasi yang lebih tinggi atau setara dengan spesifikasi tipe instans instans utama. Jika spesifikasi instans hanya baca lebih rendah daripada instans utama, instans hanya baca mungkin mengalami masalah seperti latensi tinggi dan beban berat.
DBInstanceStorage	Integer	Ya	20	Kapasitas penyimpanan instans hanya baca. Untuk informasi selengkapnya, lihat kolom Storage space di Tipe instans hanya baca. Nilai ini harus merupakan kelipatan 5 GB. Satuan: GB.
EngineVersion	String	Ya	5.6	Versi mesin utama instans hanya baca. Instans hanya baca dan instans utama harus menjalankan versi mesin utama yang sama. Jika instans hanya baca menjalankan MySQL, tetapkan parameter ini ke 5.6, 5.7, atau 8.0. Jika instans hanya baca menjalankan SQL Server, tetapkan parameter ini ke 2017_ent or 2019_ent. Jika instans hanya baca menjalankan PostgreSQL, tetapkan parameter ini ke 10.0, 11.0, 12.0, 13.0, 14.0, or 15.0.
PayType	String	Ya	Postpaid	Metode penagihan instans hanya baca. Nilai yang valid: Postpaid: pay-as-you-go Prepaid: subscription
DBInstanceDescription	String	Tidak	Test read-only instance	Deskripsi instans hanya baca. Deskripsi harus terdiri dari 2 hingga 256 karakter dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Nilai harus dimulai dengan huruf Catatan tetapi tidak boleh dimulai dengan http:// atau https://.
InstanceNetworkType	String	Tidak	Classic	Jenis jaringan instans hanya baca. Nilai yang valid: VPC Classic Nilai default: VPC. Jika Anda menetapkan parameter ini ke VPC, Anda juga harus menentukan parameter VPCId dan VSwitchId. Catatan Jenis jaringan instans hanya baca dapat berbeda dari jenis jaringan instans utama.
VPCId	String	Tidak	vpc-uf6f7l4fg90****	ID virtual private cloud (VPC) tempat instans hanya baca berada. Jika Anda tidak mengisi parameter InstanceNetworkType atau menetapkannya ke VPC, Anda juga harus menentukan parameter ini. Catatan Jika instans utama menggunakan local SSD, instans hanya baca dan instans utama dapat berada di VPC yang sama atau berbeda. Jika instans utama menggunakan standard SSD atau ESSD, instans hanya baca dan instans utama harus berada di VPC yang sama.
VSwitchId	String	Tidak	vsw-uf6adz52c2p****	ID vSwitch tempat instans hanya baca berada. Jika Anda tidak mengisi parameter InstanceNetworkType atau menetapkannya ke VPC, Anda juga harus menentukan parameter ini.
PrivateIpAddress	String	Tidak	172.16.XX.XX	Alamat IP pribadi instans hanya baca. Alamat IP pribadi harus berada dalam Blok CIDR yang didukung oleh vSwitch yang ditentukan. Sistem secara otomatis menetapkan alamat IP pribadi ke instans hanya baca berdasarkan nilai parameter VPCId dan VSwitchId.
ResourceGroupId	String	Tidak	rg-acfmy****	ID kelompok sumber daya tempat instans hanya baca berada.
Category	String	Tidak	HighAvailability	Edisi RDS instans baru. Nilai yang valid: Basic: RDS Basic Edition. HighAvailability: RDS High-availability Edition. Ini adalah nilai default. AlwaysOn: RDS Cluster Edition. Catatan Jika instans hanya baca menjalankan PostgreSQL dengan standard SSD atau ESSD, Anda harus menetapkan parameter ini ke Basic.
DBInstanceStorageType	String	Tidak	local_ssd	Jenis penyimpanan instans hanya baca. Nilai yang valid: local_ssd: local SSD cloud_ssd: standard SSD cloud_essd: ESSD tingkat kinerja 1 (PL1) cloud_essd2: ESSD PL2 cloud_essd3: ESSD PL3 Catatan Jika instans utama menjalankan MySQL dengan local SSD, Anda harus menetapkan parameter ini ke local_ssd. Jika instans utama menjalankan MySQL dengan standard SSD atau ESSD, Anda harus menetapkan parameter ini ke cloud_ssd, cloud_essd, cloud_essd2, atau cloud_essd3. Jika instans utama menjalankan SQL Server, Anda harus menetapkan parameter ini ke cloud_ssd, cloud_essd, cloud_essd2, atau cloud_essd3.
DedicatedHostGroupId	String	Tidak	dhg-4n****	ID dedicated cluster tempat instans hanya baca berada. Parameter ini berlaku saat Anda membuat instans hanya baca di dalam dedicated cluster.
TargetDedicatedHostIdForMaster	String	Tidak	i-bp****	ID host instans utama tempat instans hanya baca disambungkan. Parameter ini berlaku saat Anda membuat instans hanya baca di dalam dedicated cluster.
GdnInstanceName	String	Tidak	None	Parameter yang dicadangkan.
TddlBizType	String	Tidak	None	Parameter cadangan.
TddlRegionConfig	String	Tidak	None	Parameter cadangan.
InstructionSetArch	String	Tidak	None	Parameter cadangan.
UsedTime	String	Tidak	1	Periode langganan instans hanya baca. Nilai yang valid: Jika Anda menetapkan parameter Period ke Year, nilai parameter UsedTime berkisar antara 1 hingga 5. Jika Anda menetapkan parameter Period ke Month, nilai parameter UsedTime berkisar antara 1 hingga 9. Catatan Jika Anda menetapkan parameter PayType ke Prepaid, Anda juga harus menentukan parameter ini.
Period	String	Tidak	Month	Siklus perpanjangan instans hanya baca. Nilai yang valid: Year Month
AutoRenew	String	Tidak	true	Menentukan apakah akan mengaktifkan perpanjangan otomatis untuk instans hanya baca. Jika Anda menetapkan parameter PayType ke Prepaid, Anda juga harus menentukan parameter ini. Nilai yang valid: true: mengaktifkan perpanjangan otomatis. false: menonaktifkan perpanjangan otomatis. Catatan Jika Anda menetapkan parameter Period ke Month, siklus perpanjangan otomatis adalah satu bulan. Jika Anda menetapkan parameter Period ke Year, siklus perpanjangan otomatis adalah satu tahun.
DeletionProtection	Boolean	Tidak	true	Menentukan apakah akan mengaktifkan fitur perlindungan rilis untuk instans hanya baca. Nilai yang valid: true: mengaktifkan fitur perlindungan rilis. false: menonaktifkan fitur perlindungan rilis. Ini adalah nilai default. Catatan Fitur ini hanya dapat diaktifkan ketika Anda menetapkan parameter PayType ke Postpaid.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
DBInstanceId	String	rr-uf6wjk5****	ID instans hanya baca.
RequestId	String	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC	ID permintaan.
Port	String	3306	Nomor port internal yang digunakan untuk menghubungkan ke instans hanya baca.
ConnectionString	String	rr-****.mysql.rds.aliyuncs.com	Titik akhir internal yang digunakan untuk menghubungkan ke instans hanya baca.
OrderId	String	10078937****	ID pesanan.

Contoh

Permintaan contoh

http(s)://rds.aliyuncs.com/?Action=CreateReadOnlyDBInstance
&ClientToken=ETnLKlblzczshOTUbOC****
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-b
&DBInstanceId=rm-uf6wjk5****
&DBInstanceClass=rds.mys2.small
&DBInstanceStorage=20
&EngineVersion=5.6
&PayType=Postpaid
&DBInstanceDescription=Test read-only instance
&InstanceNetworkType=Classic
&VPCId=vpc-uf6f7l4fg90****
&VSwitchId=vsw-uf6adz52c2p****
&PrivateIpAddress=172.16.XX.XX
&ResourceGroupId=rg-acfmy****
&Category=HighAvailability
&DBInstanceStorageType=local_ssd
&DedicatedHostGroupId=dhg-4n****
&TargetDedicatedHostIdForMaster=i-bp****
&GdnInstanceName=None
&TddlBizType=None
&TddlRegionConfig=None
&InstructionSetArch=None
&UsedTime=1
&Period=Month
&AutoRenew=true
&DeletionProtection=true
&<Common request parameters>

Respons sukses contoh

XML format

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

<CreateReadOnlyDBInstanceResponse>
    <DBInstanceId>rr-uf6wjk5****</DBInstanceId>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
    <Port>3306</Port>
    <ConnectionString>rr-****.mysql.rds.aliyuncs.com</ConnectionString>
    <OrderId>10078937****</OrderId>
</CreateReadOnlyDBInstanceResponse>

JSON format

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

{
  "DBInstanceId" : "rr-uf6wjk5****",
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
  "Port" : 3306,
  "ConnectionString" : "rr-****.mysql.rds.aliyuncs.com",
  "OrderId" : "10078937****"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidSecurityIPList.Duplicate	The Security IP address is not in the available range or occupied.	Pesan kesalahan dikembalikan karena alamat IP yang ditentukan sedang digunakan atau berada di luar rentang yang valid. Tentukan alamat IP yang valid dan coba lagi.
400	OperationDenied	VPC IP is in use, please check.	Pesan kesalahan dikembalikan karena alamat IP VPC yang ditentukan sedang digunakan.
400	InvalidZoneId.NotSupported	The Specified vpc Zone not supported.	Pesan kesalahan dikembalikan karena zona yang ditentukan tidak mendukung pembuatan instans dengan jenis jaringan VPC. Tentukan zona lain dan coba lagi.
400	CDDC.AvailableHostsNotEnoughInZone	Not enough available hosts are in the target zone.	Pesan kesalahan dikembalikan karena tidak ada host yang tersedia di zona yang ditentukan. Buat host di zona tersebut dan coba lagi.
403	OperationDenied.PrimaryDBInstanceStatus	The operation is not permitted due to status of primary instance.	Pesan kesalahan dikembalikan karena instans termasuk dalam dedicated cluster dan tidak berada dalam status Running.
404	IncorrectDBInstanceConnType	Current DB instance conn type does not support this operation.	Pesan kesalahan dikembalikan karena jenis koneksi jaringan instans tidak mendukung operasi ini.
500	CannotDecreaseEssdPerfLevel	cannot decrease cloud essd performance level.	Pesan kesalahan dikembalikan karena perubahan jenis penyimpanan gagal diverifikasi. Jenis penyimpanan instans yang menjalankan SQL Server dengan disk cloud hanya dapat dikonversi ke jenis disk cloud lainnya. Instans yang menjalankan SQL Server dengan standard SSD dapat ditingkatkan untuk menggunakan standard SSD atau ESSD dengan spesifikasi baru.
500	InvalidEssdStorageSize	invalid cloud essd storage size.	Pesan kesalahan dikembalikan karena tipe instans yang ditentukan tidak valid. Pilih tipe instans yang valid dan coba lagi.

Untuk daftar kode kesalahan, lihat Service error codes.