Bir kümenin öznitelik bilgilerini sorgular.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
polardb:DescribeDBClusterAttribute |
get |
*DBCluster
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| DBClusterId |
string |
Yes |
Küme kimliği. Not
Hesabınızdaki tüm kümelerin ayrıntılarını (küme kimliği dahil) sorgulamak için DescribeDBClusters işlemini çağırabilirsiniz. |
pc-***************** |
| DescribeType |
string |
No |
Yapay zeka ile ilgili düğüm bilgilerinin alınıp alınmayacağını belirtir. |
AI |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| DeletionLock |
integer |
Küme silme kilidi durumu. Geçerli değerler:
|
0 |
| Category |
string |
Ürün sürümü. Geçerli değerler:
Not
|
Normal |
| ResourceGroupId |
string |
Kaynak grubu kimliği. |
rg-*************** |
| DataLevel1BackupChainSize |
integer |
|
74448896 |
| DBClusterId |
string |
Küme kimliği. |
pc-***************** |
| DBType |
string |
Veritabanı motoru türü. |
MySQL |
| DBClusterNetworkType |
string |
Kümenin ağ türü. |
VPC |
| IsLatestVersion |
boolean |
Kümenin en son çekirdek sürümünü çalıştırıp çalıştırmadığını gösterir. Geçerli değerler: |
false |
| HasCompleteStandbyRes |
boolean |
Bölgeler arası yük devrinden sonra yeni birincil veritabanı için kaynakların yenilenip yenilenmediğini gösterir. Geçerli değerler:
|
false |
| HotStandbyCluster |
string |
Etkin yedek depolama kümesinin (ve yedek işlem düğümlerinin) etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler:
|
StandbyClusterON |
| DataSyncMode |
string |
Veri çoğaltma modu. Geçerli değerler:
|
AsyncSync |
| StandbyHAMode |
string |
Bölgeler arası afet kurtarma modu. Geçerli değerler:
|
OFF |
| CompressStorageMode |
string |
Depolama sıkıştırmasının etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: |
ON |
| StorageMax |
integer |
Geçerli küme teknik özellikleri için maksimum depolama kapasitesi. Birim: bayt. |
10995116277760 |
| DBVersion |
string |
Veritabanı motoru sürümü. |
8.0 |
| DBNodes |
array<object> |
Düğüm bilgileri. |
|
|
object |
|||
| CreationTime |
string |
Düğümün oluşturulduğu zaman. |
2020-03-23T21:35:43Z |
| FailoverPriority |
integer |
Yük devri önceliği. Her düğüm, bir yük devri sırasında düğümün birincil düğüm olarak seçilme olasılığını belirleyen bir yük devri önceliğine sahiptir. Daha büyük bir değer daha yüksek bir önceliği gösterir. Geçerli değerler: 1 ile 15 arası. |
1 |
| MaxIOPS |
integer |
Saniyedeki maksimum G/Ç isteği sayısı (IOPS). |
32000 |
| DBNodeClass |
string |
Düğüm teknik özellikleri. |
polar.mysql.x4.large |
| CpuCores |
string |
Düğümün CPU çekirdeği sayısı. |
2 |
| MemorySize |
string |
Düğümün bellek boyutu. Birim: MB. |
8192 |
| DBNodeRole |
string |
Düğümün rolü. Geçerli değerler: |
Reader |
| ZoneId |
string |
Bölge kimliği. |
cn-hangzhou-i |
| MaxConnections |
integer |
Kümeye eşzamanlı bağlantıların maksimum sayısı. |
8000 |
| DBNodeStatus |
string |
Düğümün durumu. Geçerli değerler: |
Running |
| DBNodeId |
string |
Düğüm kimliği. |
pi-**************** |
| ImciSwitch |
string |
Bellek İçi Sütun Dizininin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: |
ON |
| HotReplicaMode |
string |
Etkin yedeğin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: |
ON |
| AddedCpuCores |
string |
Yerel kaynakların otomatik olarak ölçeklendirilmesiyle eklenen CPU çekirdeği sayısı. |
6 |
| MasterId |
string |
Çoklu Ana Küme Sürümünün birincil düğüm kimliği. |
pi-bp18z52akld3***** |
| SccMode |
string |
Düğüm için global tutarlılık (yüksek performans modu) özelliğinin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: |
ON |
| ServerWeight |
string |
Yönlendirme ağırlığı. |
1 |
| ServerlessType |
string |
Düğümün sunucusuz türü. Geçerli değerler:
Not
|
SteadyServerless |
| SubCluster |
string |
Düğümün birincil bölgede mi yoksa ikincil bölgede mi olduğunu gösterir. Bu parametre esas olarak kaynağa göre simetrik dağıtımlar için kullanılır. Geçerli değerler:
|
Primary |
| RemoteMemorySize |
string |
Uzak bellek boyutu. Birim: MB. |
3072 |
| Orca |
string |
Orca özelliği. Geçerli değerler: |
off |
| MultiMasterLocalStandby |
string |
Çoklu ana yerel yedek düğüm. |
pi-**************** |
| MultiMasterPrimaryNode |
string |
Çoklu ana birincil düğüm. |
pi-**************** |
| DBNodeDescription |
string |
Düğüm açıklaması. |
test |
| SubGroupDescription |
string |
Küme alt grubu açıklaması. |
test Description |
| MirrorInsName |
string |
Etkin yedek depolama ve işlem mimarisinde düğüme karşılık gelen etkin kopyanın adı. |
pi-bp18z52mirror***** |
| DBNodeCXLRemoteMemory |
string |
CXL uzak bellek yapılandırması. |
3072 |
| RemoteMemoryMin |
integer |
||
| RemoteMemoryMax |
integer |
||
| RemoteMemoryRecommended |
integer |
||
| DedicatedHostModel |
boolean |
||
| ZoneIds |
string |
Bölge kimliği. |
cn-hangzhou-i,cn-hangzhou-g |
| MaintainTime |
string |
Kümenin bakım penceresi. Saat |
18:00Z-19:00Z |
| Engine |
string |
Küme motoru. |
POLARDB |
| Tags |
array<object> |
Etiket bilgileri. |
|
|
object |
|||
| Key |
string |
Etiket anahtarı. |
test |
| Value |
string |
Etiket değeri. |
MySQL |
| RequestId |
string |
İstek kimliği. |
074467EF-86B9-4C23-ACBF-E9B81A****** |
| VPCId |
string |
VPC kimliği. |
vpc-******************* |
| SearchClusterStatus |
string |
Arama düğümünün çalışma durumu. |
Running |
| VSwitchId |
string |
vSwitch kimliği. |
vsw-********************* |
| DBClusterDescription |
string |
Küme açıklaması. |
test |
| Expired |
string |
Kümenin süresinin dolup dolmadığını gösterir. |
false |
| PayType |
string |
Faturalandırma yöntemi. Geçerli değerler: |
Prepaid |
| StoragePayType |
string |
Depolama için faturalandırma yöntemi. Geçerli değerler:
|
Prepaid |
| LockMode |
string |
Kilit modu. Geçerli değerler: |
Unlock |
| SearchStorageUsed |
integer |
Arama düğümünün depolama kullanımı. |
3012558848 |
| SearchCompressStorageUsed |
integer |
Arama düğümünün sıkıştırılmış depolama veri boyutu. |
15529410560 |
| StorageSpace |
integer |
Alana göre faturalandırılan depolama alanı (abonelik). Birim: bayt. |
50 |
| DBVersionStatus |
string |
Geçerli alt sürümün durumu. Geçerli değerler:
Not
|
Stable |
| CreationTime |
string |
Kümenin oluşturulduğu zaman. |
2020-08-14T05:58:42Z |
| SQLSize |
integer |
SQL ifadelerinin depolama boyutu. Birim: bayt. -1 değeri, kullanılabilir veri olmadığını gösterir. |
0 |
| InodeTotal |
integer |
Dosya sistemindeki maksimum inode sayısı. |
6,291,456 |
| InodeUsed |
integer |
Geçerli inode kullanımı. |
4,194,304 |
| BlktagTotal |
integer |
Dosya sistemindeki maksimum blktag sayısı. |
7,864,320 |
| BlktagUsed |
integer |
Geçerli blktag kullanımı. |
5,242,880 |
| RegionId |
string |
Bölge kimliği. |
cn-hangzhou |
| ExpireTime |
string |
Kümenin sona erme zamanı. Not
Yalnızca faturalandırma yöntemi Prepaid (abonelik) olan kümeler bu parametre için belirli bir değer döndürür. Postpaid (kullandıkça öde) kümeler boş bir değer döndürür. |
2020-11-14T16:00:00Z |
| SubCategory |
string |
İşlem düğümünün teknik özellik türü. Geçerli değerler:
Not
Bu parametre yalnızca PolarDB for MySQL Küme Sürümü kümeleri için döndürülür. |
Exclusive |
| IsProxyLatestVersion |
boolean |
Veritabanı proxy'sinin en son sürümde olup olmadığını gösterir. Geçerli değerler: |
false |
| StorageType |
string |
Depolama türü. Değer HighPerformance olarak sabitlenmiştir. |
HighPerformance |
| ServerlessType |
string |
Kümenin sunucusuz türü. Geçerli değerler:
Not
Bu parametre yalnızca sunucusuz kümeler veya sunucusuz özelliği etkinleştirilmiş, tanımlı teknik özelliklere sahip kümeler için desteklenir. |
SteadyServerless |
| StrictConsistency |
string |
Küme için çok bölgeli güçlü veri tutarlılığının etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: |
ON |
| ProxyCpuCores |
string |
Veritabanı proxy'sinin CPU çekirdeği sayısı. |
4 |
| ProxyStandardCpuCores |
string |
Veritabanı proxy'sinin standart yapılandırmasındaki CPU çekirdeği sayısı. |
2 |
| ProxyType |
string |
Veritabanı proxy'sinin türü. Geçerli değerler: |
Exclusive |
| ProxyStatus |
string |
Veritabanı proxy'sinin durumu. Geçerli değerler: |
Running |
| ProxyServerlessType |
string |
Veritabanı proxy'sinin sunucusuz türü. Geçerli değerler:
|
SteadyServerless |
| Architecture |
string |
CPU mimarisi. Geçerli değerler: |
X86 |
| AiType |
string |
AI düğüm türü. Geçerli değerler: |
DLNode |
| ProvisionedIops |
string |
2500 |
|
| AiCreatingTime |
string |
AI özelliğinin oluşturulma zamanı. |
2024-03-13T01:20:28Z |
| SupportInstantSwitchWithImci |
string |
IMCI ile uyumlu olan sıcak yedekli yük devretme özelliğinin desteklenip desteklenmediğini gösterir. |
ON |
| Orca |
string |
Orca özelliği. Geçerli değerler: |
ON |
| SourceDBCluster |
string |
Kaynak kümenin kimliği. Not Bu parametre yalnızca 1 Haziran 2024 tarihinden sonra bir yedekleme kümesinden veya belirli bir zaman noktasından geri yüklenen kümeler için desteklenir. |
pc-pz51ziv48317b2880 |
| RestoreType |
string |
Küme geri yükleme yöntemi. Geçerli değerler:
Not Bu parametre yalnızca 1 Haziran 2024 tarihinden sonra bir yedekleme kümesinden veya belirli bir zaman noktasından geri yüklenen kümeler için desteklenir. |
RestoreByTime |
| RestoreDataPoint |
string |
Not Bu parametre yalnızca 1 Haziran 2024 tarihinden sonra bir yedekleme kümesinden veya belirli bir zaman noktasına geri yüklenen kümeler için desteklenir. |
2179639137 |
| SourceRegionId |
string |
Kaynak kümenin bölge kimliği. |
cn-beijing |
| ImciAutoIndex |
string |
IMCI tabanlı otomatik sorgu hızlandırma özelliği. Geçerli değerler: |
OFF |
| AutoUpgradeMinorVersion |
string |
Alt sürüm güncelleme politikası. |
Manual |
| BurstingEnabled |
string |
ESSD AutoPL bulut diski için G/Ç performansında ani artış özelliğinin etkinleştirilip etkinleştirilmediğini gösterir. Geçerli değerler: |
false |
| RowCompression |
string |
Satır sıkıştırma ayarı. |
OFF |
| ImperceptibleSwitch |
string |
Sıcak yedekli yük devretme özelliği. Geçerli değerler: |
true |
| StorageUsed |
integer |
Depolama kullanımı. Birim: bayt. |
3012558848 |
| CompressStorageUsed |
integer |
Sıkıştırma sonrası depolama verilerinin boyutu. |
15529410560 |
| DBClusterStatus |
string |
Küme durumu. Daha fazla bilgi için Küme durum tablosu bölümüne bakın. |
Running |
| Branch |
object |
||
| ParentInsName |
string |
||
| BranchTime |
string |
||
| BranchLsn |
string |
||
| ChildBranch |
array<object> |
||
|
object |
|||
| InsName |
string |
||
| DBClusterDescription |
string |
||
| BranchTime |
string |
||
| BranchLsn |
string |
||
| HasChild |
boolean |
||
| ColumnTable |
string |
Sütun deposu tablosunun etkinleştirilip etkinleştirilmediğini gösterir. |
OFF |
| ConnectionResourceQuota |
integer |
Bağlantı kaynak kotası (AgenticDB'ye özel). |
|
| ConnectionResourceUsed |
integer |
Kullanılan bağlantı kaynaklarının sayısı (AgenticDB'ye özel). |
|
| StorageUpperBound |
integer |
||
| StorageAutoScale |
string |
Examples
Success response
JSON format
{
"DeletionLock": 0,
"Category": "Normal",
"ResourceGroupId": "rg-***************",
"DataLevel1BackupChainSize": 74448896,
"DBClusterId": "pc-*****************",
"DBType": "MySQL",
"DBClusterNetworkType": "VPC",
"IsLatestVersion": false,
"HasCompleteStandbyRes": false,
"HotStandbyCluster": "StandbyClusterON",
"DataSyncMode": "AsyncSync",
"StandbyHAMode": "OFF",
"CompressStorageMode": "ON",
"StorageMax": 10995116277760,
"DBVersion": "8.0",
"DBNodes": [
{
"CreationTime": "2020-03-23T21:35:43Z",
"FailoverPriority": 1,
"MaxIOPS": 32000,
"DBNodeClass": "polar.mysql.x4.large",
"CpuCores": "2",
"MemorySize": "8192",
"DBNodeRole": "Reader",
"ZoneId": "cn-hangzhou-i",
"MaxConnections": 8000,
"DBNodeStatus": "Running",
"DBNodeId": "pi-****************",
"ImciSwitch": "ON",
"HotReplicaMode": "ON",
"AddedCpuCores": "6",
"MasterId": "pi-bp18z52akld3*****",
"SccMode": "ON",
"ServerWeight": "1",
"ServerlessType": "SteadyServerless",
"SubCluster": "Primary",
"RemoteMemorySize": "3072",
"Orca": "off",
"MultiMasterLocalStandby": "pi-****************",
"MultiMasterPrimaryNode": "pi-****************",
"DBNodeDescription": "test",
"SubGroupDescription": "test Description",
"MirrorInsName": "pi-bp18z52mirror*****",
"DBNodeCXLRemoteMemory": "3072",
"RemoteMemoryMin": 0,
"RemoteMemoryMax": 0,
"RemoteMemoryRecommended": 0,
"DedicatedHostModel": false
}
],
"ZoneIds": "cn-hangzhou-i,cn-hangzhou-g",
"MaintainTime": "18:00Z-19:00Z",
"Engine": "POLARDB",
"Tags": [
{
"Key": "test",
"Value": "MySQL"
}
],
"RequestId": "074467EF-86B9-4C23-ACBF-E9B81A******",
"VPCId": "vpc-*******************",
"SearchClusterStatus": "Running",
"VSwitchId": "vsw-*********************",
"DBClusterDescription": "test",
"Expired": "false",
"PayType": "Prepaid",
"StoragePayType": "Prepaid",
"LockMode": "Unlock",
"SearchStorageUsed": 3012558848,
"SearchCompressStorageUsed": 15529410560,
"StorageSpace": 50,
"DBVersionStatus": "Stable",
"CreationTime": "2020-08-14T05:58:42Z",
"SQLSize": 0,
"InodeTotal": 0,
"InodeUsed": 0,
"BlktagTotal": 0,
"BlktagUsed": 0,
"RegionId": "cn-hangzhou",
"ExpireTime": "2020-11-14T16:00:00Z",
"SubCategory": "Exclusive",
"IsProxyLatestVersion": false,
"StorageType": "HighPerformance",
"ServerlessType": "SteadyServerless",
"StrictConsistency": "ON",
"ProxyCpuCores": "4",
"ProxyStandardCpuCores": "2",
"ProxyType": "Exclusive",
"ProxyStatus": "Running",
"ProxyServerlessType": "SteadyServerless",
"Architecture": "X86",
"AiType": "DLNode",
"ProvisionedIops": "2500",
"AiCreatingTime": "2024-03-13T01:20:28Z",
"SupportInstantSwitchWithImci": "ON",
"Orca": "ON",
"SourceDBCluster": "pc-pz51ziv48317b2880",
"RestoreType": "RestoreByTime",
"RestoreDataPoint": "2179639137",
"SourceRegionId": "cn-beijing",
"ImciAutoIndex": "OFF",
"AutoUpgradeMinorVersion": "Manual",
"BurstingEnabled": "false",
"RowCompression": "OFF\n",
"ImperceptibleSwitch": "true",
"StorageUsed": 3012558848,
"CompressStorageUsed": 15529410560,
"DBClusterStatus": "Running",
"Branch": {
"ParentInsName": "",
"BranchTime": "",
"BranchLsn": "",
"ChildBranch": [
{
"InsName": "",
"DBClusterDescription": "",
"BranchTime": "",
"BranchLsn": "",
"HasChild": false
}
]
},
"ColumnTable": "OFF",
"ConnectionResourceQuota": 0,
"ConnectionResourceUsed": 0,
"StorageUpperBound": 0,
"StorageAutoScale": ""
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | |
| 403 | Forbidden.RAM | User not authorized to operate on the specified resource, or this API does not support RAM. | |
| 404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.