API ini digunakan untuk membuat instans read-only untuk instans RDS.
Deskripsi operasi
Engine yang Didukung
RDS MySQL
RDS PostgreSQL
RDS SQL Server
Dokumentasi Fungsi Terkait
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
rds:CreateReadOnlyDBInstance |
create |
*DBInstance
|
|
None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| ClientToken |
string |
No |
Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di sisi klien, 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. |
ETnLKlblzczshOTUbOC**** |
| RegionId |
string |
Yes |
ID wilayah. Instans read-only dan instans utama harus berada di wilayah yang sama. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru. |
cn-hangzhou |
| ZoneId |
string |
Yes |
ID zona. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona.
|
cn-hangzhou-b |
| DBInstanceId |
string |
Yes |
ID instans utama. Anda dapat memanggil operasi DescribeDBInstances untuk mengkueri ID instans. |
rm-uf6wjk5**** |
| DBInstanceClass |
string |
Yes |
Tipe instans untuk instans read-only. Untuk informasi selengkapnya, lihat Tipe instans read-only. Kami menyarankan agar Anda menentukan tipe instans dengan spesifikasi yang lebih tinggi atau sama dengan spesifikasi tipe instans instans utama. Jika spesifikasi instans read-only lebih rendah daripada spesifikasi instans utama, instans read-only mungkin mengalami masalah seperti latensi tinggi dan beban berat. |
mysqlro.n2.small.1c |
| DBInstanceStorage |
integer |
Yes |
Kapasitas penyimpanan instans read-only. Kapasitas penyimpanan instans read-only harus lebih besar dari atau sama dengan kapasitas instans utama. Untuk informasi selengkapnya, lihat kolom Storage capacity di Tipe instans read-only. Nilai ini harus merupakan kelipatan 5. Satuan: GB. |
20 |
| EngineVersion |
string |
Yes |
Versi engine database. Instans read-only dan instans utama harus menjalankan versi mesin utama yang sama.
|
5.6 |
| PayType |
string |
Yes |
Metode penagihan untuk instans read-only. Nilai yang valid:
|
Postpaid |
| DBInstanceDescription |
string |
No |
Deskripsi instans read-only. Panjang deskripsi harus antara 2 hingga 256 karakter dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Nilai harus dimulai dengan huruf. Catatan
Nilai tidak boleh dimulai dengan http:// atau https://. |
testReadOnly |
| InstanceNetworkType |
string |
No |
Jenis jaringan untuk instans read-only. Nilai yang valid:
Nilai default: VPC. Jika Anda mengatur parameter ini ke VPC, Anda juga harus menentukan parameter VPCId dan VSwitchId. Catatan
Jenis jaringan instans read-only dapat berbeda dari jenis jaringan instans utama. |
Classic |
| VPCId |
string |
No |
ID virtual private cloud (VPC) untuk instans read-only. Jika Anda membiarkan parameter InstanceNetworkType kosong atau mengaturnya ke VPC, Anda juga harus menentukan parameter ini. Catatan
|
vpc-uf6f7l4fg90**** |
| VSwitchId |
string |
No |
ID vSwitch untuk instans read-only. Jika Anda membiarkan parameter InstanceNetworkType kosong atau mengaturnya ke VPC, Anda harus menentukan parameter VSwitchId. |
vsw-uf6adz52c2p**** |
| PrivateIpAddress |
string |
No |
Alamat IP pribadi untuk instans read-only. Alamat IP pribadi harus berada dalam Blok CIDR yang didukung oleh vSwitch yang ditentukan. Sistem akan menetapkan alamat IP pribadi ke instans read-only berdasarkan nilai parameter VPCId dan VSwitchId. |
172.16.XX.XX |
| ResourceGroupId |
string |
No |
ID kelompok sumber daya. |
rg-acfmy**** |
| Category |
string |
No |
Edisi RDS untuk instans. Nilai yang valid:
Catatan
Instans read-only dari instans utama yang menjalankan PostgreSQL dan menggunakan cloud disk berjalan pada RDS Basic Edition. Oleh karena itu, atur parameter ini ke Basic. |
HighAvailability |
| DBInstanceStorageType |
string |
No |
Tipe penyimpanan instans. Nilai yang valid:
Catatan
|
local_ssd |
| DedicatedHostGroupId |
string |
No |
ID klaster khusus tempat instans read-only berada. Parameter ini berlaku saat Anda membuat instans read-only di klaster khusus. |
dhg-4n**** |
| TargetDedicatedHostIdForMaster |
string |
No |
ID host tempat instans utama berada. Parameter ini berlaku saat Anda membuat instans read-only di klaster khusus. |
i-bp**** |
| GdnInstanceName |
string |
No |
Parameter cadangan. |
test |
| TddlBizType |
string |
No |
Parameter cadangan. |
test |
| TddlRegionConfig |
string |
No |
Parameter cadangan. |
test |
| InstructionSetArch |
string |
No |
Parameter cadangan. |
test |
| UsedTime |
string |
No |
Durasi langganan untuk instans read-only. Nilai yang valid:
Catatan
Jika Anda mengatur parameter PayType ke Prepaid, Anda harus menentukan parameter UsedTime. |
1 |
| Period |
string |
No |
Siklus perpanjangan untuk instans read-only. Nilai yang valid:
|
Month |
| AutoRenew |
string |
No |
Menentukan apakah fitur perpanjangan otomatis untuk instans read-only diaktifkan. Jika Anda mengatur parameter PayType ke Prepaid, Anda juga harus menentukan parameter ini. Nilai yang valid:
Catatan
|
true |
| DeletionProtection |
boolean |
No |
Menentukan apakah fitur perlindungan rilis untuk instans read-only diaktifkan. Nilai yang valid:
Catatan
Anda hanya dapat mengaktifkan fitur perlindungan rilis untuk instans read-only ketika Anda mengatur parameter PayType ke Postpaid. |
true |
| Port |
string |
No |
Port yang dapat diinisialisasi saat Anda membuat instans ApsaraDB RDS for MySQL read-only. Nilai yang valid: 1000 hingga 65534. |
3306 |
| BurstingEnabled |
boolean |
No |
Parameter tidak valid. Anda tidak perlu menentukan parameter ini. |
false |
| IsAnalyticReadOnlyIns |
boolean |
No |
Menentukan apakah akan membuat instans analitik DuckDB. Nilai yang valid:
Catatan
Saat ini, hanya RDS MySQL dan RDS PostgreSQL yang mendukung pembuatan instans analitik DuckDB. |
|
| AutoPay |
boolean |
No |
Menentukan apakah pembayaran diselesaikan secara otomatis. Nilai yang valid:
Catatan
Nilai default: true. Jika saldo akun Anda tidak mencukupi, Anda dapat mengatur parameter AutoPay ke false untuk membuat pesanan yang belum dibayar. Kemudian, Anda dapat login ke Konsol ApsaraDB RDS untuk menyelesaikan pembayaran. |
false |
| AutoCreateProxy |
boolean |
No |
Menentukan apakah proxy database dibuat secara otomatis. Nilai yang valid:
|
false |
| IoAccelerationEnabled |
string |
No |
Parameter cadangan. |
0 |
| AutoUseCoupon |
boolean |
No |
Menentukan apakah akan menggunakan kupon. Nilai yang valid:
|
true |
| PromotionCode |
string |
No |
Kode kupon. |
71744626**** |
| CustomExtraInfo |
string |
No |
Parameter cadangan. Tidak diperlukan konfigurasi. |
None |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Parameter respons. |
||
| ConnectionString |
string |
Titik akhir internal yang digunakan untuk menghubungkan ke instans read-only. |
rr-****.mysql.rds.aliyuncs.com |
| DBInstanceId |
string |
ID instans read-only. |
rr-uf6wjk5**** |
| OrderId |
string |
ID pesanan. |
10078937**** |
| Port |
string |
Nomor port internal yang digunakan untuk menghubungkan ke instans read-only. |
3306 |
| RequestId |
string |
ID permintaan. |
1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC |
Contoh
Respons sukses
JSONformat
{
"ConnectionString": "rr-****.mysql.rds.aliyuncs.com",
"DBInstanceId": "rr-uf6wjk5****",
"OrderId": "10078937****",
"Port": "3306",
"RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidEngineVersion.Malformed | The specified parameter EngineVersion is not valid. | |
| 400 | InvalidNetworkTypeClassicWhenCloudStorage | The Specified InstanceNetworkType value Classic is not valid when choose cloud storage type. | Menetapkan InstanceNetworkType ke Classic tidak valid ketika tipe penyimpanan cloud dipilih. |
| 400 | InvalidSecurityIPList.Malformed | The specified parameter SecurityIPList is not valid. | |
| 400 | InvalidSecurityIPList.Duplicate | The Security IP address is not in the available range or occupied. | Daftar IP keamanan yang ditentukan tidak valid. Daftar tersebut berisi nilai duplikat. |
| 400 | InvalidParameter | The specified parameter dbInstanceId is not valid. | |
| 400 | OperationDenied | VPC IP is in use, please check. | Tipe instans tidak mendukung operasi ini. |
| 400 | InvalidZoneId.NotSupported | The Specified vpc Zone not supported. | Zona saat ini tidak mendukung pembuatan instans yang menggunakan jenis jaringan VPC. Buat VPC di zona lain atau pilih zona yang mendukung jenis jaringan ini. |
| 400 | InvalidAvZone.NotSupport | Specified availableArea multiZone does not support in RDS. | availableArea multiZone yang ditentukan tidak didukung di ApsaraDB RDS. |
| 400 | CDDC.AvailableHostsNotEnoughInZone | Not enough available hosts are in the target zone. | Zona target tidak memiliki Sumber daya host yang cukup. Buat host di zona tersebut. |
| 400 | InvalidReadEngineVersionPattern | The engine versions of the primary instance and the read-only instance do not match. | engineVersion dari instans utama dan instans baca-saja tidak cocok. |
| 400 | InvalidDBInstanceClass.Offline | The specified instance type is no longer provided. Please specify another instance type. | Tipe instans yang dipilih telah pensiun. Pilih tipe instans lain. |
| 400 | SYSTEM.CONCURRENT_OPERATE | Concurrent operation is detected. | Terdapat operasi konkuren dalam sistem. |
| 400 | Price.PricingPlanResultNotFound | Pricing plan price result not found. | Hasil harga rencana penetapan harga tidak ditemukan. |
| 400 | InvalidDBInstanceName.Duplicate | Specified DB instance name already exists in the Aliyun RDS. | Operasi gagal karena nama instans sudah ada. Ubah nama instans dan coba lagi. |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | Tipe instans saat ini tidak mendukung tipe penyimpanan yang ditentukan. |
| 400 | InvalidRequestId | The request is copy, check your token. | Permintaan duplikat. Periksa token. |
| 400 | InvalidParam.InstanceNetworkType | Creation of classic network instances is not supported. | Jaringan klasik telah didepresiasi. Pembuatan instans jaringan klasik tidak didukung. |
| 400 | Order.ComboInstanceNotAllowOperate | A package instance is not allowed to operate independently. | Operasi individual tidak diizinkan untuk instans paket. |
| 400 | Order.NoRealNameAuthentication | You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. | Anda belum menyelesaikan verifikasi nama asli dan tidak memenuhi syarat untuk melakukan pembelian. Masuk ke Biaya dan Pengeluaran untuk menyelesaikan verifikasi nama asli. |
| 400 | InsufficientAvailableQuota | Your account quota limit is less than 0, please recharge before trying to purchase. | Kredit tersedia akun Anda kurang dari 0. Isi ulang akun Anda sebelum mencoba membeli. |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | Pemanggilan ke layanan komoditas gagal. |
| 400 | RegionDissolvedEOM | Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. | Alibaba Cloud berencana mengoptimalkan dan menyesuaikan wilayah saat ini. Layanan cloud di wilayah ini akan dihentikan. Untuk memastikan kelangsungan bisnis Anda dan migrasi data yang lancar, Anda tidak dapat membuat pesanan pembelian baru pada waktu ini. Terima kasih atas pengertian dan dukungan Anda. |
| 400 | Commodity.InvalidComponent | The module you purchased is not legal, please buy it again. | Modul yang Anda beli tidak valid. Beli modul yang valid. |
| 400 | RegionEndTimeDissolvedAustralia | Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. | Wilayah telah dinonaktifkan. |
| 400 | Price.CommoditySys | Commodity system call exception. | Terjadi pengecualian saat memanggil sistem komoditas. |
| 400 | Pay.InsufficientBalance | Insufficient available balance. | |
| 400 | Order.PeriodInvalid | There is a problem with the period you selected, please choose again. | Periode langganan yang Anda pilih tidak valid. Pilih periode yang valid. |
| 400 | pay.noCreditCard | Account not bound to credit card. | Tidak ada kartu kredit yang tersedia. |
| 400 | Order.InstHasUnpaidOrder | There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. | Terdapat pesanan yang belum dibayar untuk layanan yang Anda pilih. Bayar atau batalkan pesanan yang ada sebelum membuat pesanan baru. |
| 400 | noAvailablePaymentMethod | No payment method is specified for your account. We recommend that you add a payment method. | Tidak ada metode pembayaran yang ditentukan untuk akun. Tambahkan metode pembayaran. |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | Informasi dasar Anda tidak lengkap. Lengkapi informasi dasar Anda sebelum melakukan operasi ini. |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | Pengecualian terjadi pada akun Anda. Hubungi layanan pelanggan untuk detailnya. |
| 400 | Api.NotSupport | Specified api is not supported. | Operasi API saat ini tidak didukung. |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | Tag pemblokiran pesanan ada. Hubungi distributor Anda untuk menyelesaikan masalah ini. |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | DBInstanceId yang ditentukan tidak ada. |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | Parameter input tidak valid. |
| 400 | KmsApiError | User secret key invalid. | Kunci pengguna tidak valid. |
| 400 | System.SaleValidateFailed | Sales expression validation system error. | |
| 400 | Abs.InvalidAccount.NotFound | account is not found. | Akun Alibaba Cloud Anda tidak ada, atau AccessKey Anda telah kedaluwarsa. |
| 400 | SqlExecuteFailedOrTimeout | sql command execution failed or timed out:%s. | Eksekusi perintah SQL gagal atau habis waktu. |
| 400 | ColdData.EngineVersionNotSupport | The current instance engine version not support coldDataEnabled. | Versi mesin DPI instans saat ini tidak mendukung pengarsipan data dingin. |
| 400 | ColdData.MinorVersionNotSupport | The current instance minor version not support coldDataEnabled. | Versi kernel saat ini tidak mendukung pengarsipan data dingin. |
| 400 | IncorrectTargetClasscode | The current instance type does not support this operation. | Spesifikasi instans saat ini tidak mendukung operasi ini. |
| 400 | InvalidConnectionString.Duplicate | Specified connection string already exists in the RDS. | Nama alamat koneksi duplikat. Atur ulang string koneksi. |
| 400 | RequiredParam.NotFound | Required input param is not found. | Parameter yang diperlukan hilang. |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | Parameter tidak benar. Periksa parameter. |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | Kebijakan cadangan saat ini tidak mendukung operasi ini. |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | Status instans tidak mendukung operasi ini. |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | Kebijakan retensi data cadangan arsip setelah rilis instans tidak valid. |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | Tipe engine database dari instans tidak mendukung operasi ini. |
| 400 | Pay.NoCreditCard | No credit cards. | |
| 400 | VpcNetworkTypeNotSupport | The vpc network type instance does not support this operation. | Operasi ini tidak didukung untuk instans dengan jenis jaringan VPC. |
| 400 | MirrorInsExists | Specified DB instance mirror ins already existed. | Image dari Instansiasi basis data saat ini sudah ada. |
| 400 | UnsupportedClassCode | The specified DB instance class stops selling. | Tipe instans tidak lagi tersedia untuk dibeli. |
| 400 | InvalidBackupSet | The specified database does not exist in the backup set. | Database yang ditentukan tidak ada dalam set cadangan. |
| 400 | OrdTCommodityQueryError | Failed to query for product. | Gagal mengkueri produk. |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | Instans telah dirilis. Verifikasi instans sebelum menempatkan pesanan. |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | Wilayah yang ditentukan tidak valid. |
| 400 | InvalidVSwitchId.Format | The specified vswitch Id format is incorrect. | ID vSwitch yang ditentukan memiliki format yang salah. |
| 400 | InvalidParameterValue.NotStandard | Invalid parameter format. | Format parameter yang ditentukan tidak valid. |
| 400 | AtLeastThreeVSwitchAvailableIp | The primary vswitch requires at least three available IP addresses. | vSwitch utama harus memiliki setidaknya 3 alamat IP yang tersedia. |
| 400 | AtLeastTwoVSwitchAvailableIp | The primary vswitch requires at least two available IP addresses. | vSwitch utama harus memiliki setidaknya 2 alamat IP yang tersedia. |
| 400 | DuckDBOperationConflictBetweenPrimaryAndReadOnlyInstance | Current instance is already attached to another duckdb instance, operation is conflict. | Instans saat ini sudah dikaitkan dengan instans DuckDB lain, yang berkonflik dengan operasi DuckDB saat ini. |
| 500 | CannotDecreaseEssdPerfLevel | cannot decrease cloud essd performance level. | |
| 500 | InvalidEssdStorageSize | invalid cloud essd storage size. | |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | Permintaan ke layanan gagal. Coba lagi nanti. |
| 500 | RequestMetaDataFailed | The service request failed. Please try again later or contact service personnel. | Permintaan layanan gagal. Coba lagi nanti atau hubungi dukungan. |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | Pemrosesan permintaan gagal karena kegagalan layanan API RDS. |
| 403 | OperationDenied.PrimaryDBInstanceStatus | The operation is not permitted due to status of primary instance. | Operasi gagal. Instans ApsaraDB RDS yang tidak dalam status Running di kluster khusus tidak dapat dimigrasikan. |
| 403 | InvalidReadStorageTypePattern | The storage type of the primary instance and the read-only instance do not match. | |
| 403 | IncorrectCharacterType | Current DB instance character type does not support this operation. | Jenis karakter instans saat ini tidak mendukung operasi ini. |
| 403 | InvalidMultiparamZoneInfoList | Zoneinfo list is invaild. | Zona utama saat ini tidak sejajar. Instans utama tidak dapat dimigrasikan. |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | Terdapat pesanan yang belum dibayar untuk instans saat ini. Bayar pesanan tersebut dan coba lagi. |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | Kapasitas target untuk penurunan skala tidak boleh kurang dari penggunaan penyimpanan saat ini. |
| 403 | CloudSSDNotSupport | Cloud ssd does not support this operation, please upgrade to essd. | Disk SSD tidak mendukung operasi ini. Tingkatkan ke ESSD. |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | Izin pengguna tidak mendukung operasi ini. |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | VSwitchId yang ditentukan memiliki format yang salah atau kosong. |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | Versi minor engine saat ini tidak mendukung operasi ini. |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | Tidak ada wilayah inventaris yang tersedia. |
| 403 | NotInFlowController | Sorry,no permission. | Fitur ini tidak tersedia. Anda tidak memiliki izin karena bukan pengguna cloud korporat. |
| 403 | InvalidKmsKey | Kms key is disabled. | Kunci KMS dinonaktifkan. |
| 403 | InvalidInstanceLevel.Malformed | Current DB instance level does not support this operation. | Level Instans database saat ini tidak mendukung operasi ini. |
| 403 | BasicCategoryNotSupport | The Basic category is not supported. | Edisi Dasar tidak didukung. |
| 403 | GuardDBInstanceNotSupport | Guard instance does not support this operation. | Operasi ini tidak didukung untuk instans pemulihan bencana. |
| 404 | IncorrectDBInstanceConnType | Current DB instance conn type does not support this operation. | |
| 404 | InvalidDBInstance.NotFound | The specified instance does not exist or is not supported. | Instans yang ditentukan tidak ditemukan. Periksa apakah instans valid. |
| 404 | InvalidClusterKms | The current instance does not authorized to access the Key Management Service. | Instans saat ini tidak diotorisasi untuk mengakses Key Management Service. |
| 404 | Request.NotFound | The requested resource is not available. | Sumber daya yang diminta tidak tersedia. |
| 404 | HostInfo.NotFound | The specified host info is not found. | Informasi host yang ditentukan tidak ada. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.