使用DescribeDBClusterAttribute查詢叢集的詳細屬性-雲原生資料倉儲AnalyticDB-阿里雲

調用DescribeDBClusterAttribute介面查看目標AnalyticDB MySQL版叢集的詳細資料。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

adb:DescribeDBClusterAttribute

get

DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

無

請求參數

名稱	類型	必填	描述	樣本值
DBClusterId	string	是	AnalyticDB MySQL 數倉版叢集 ID。說明您可以調用 DescribeDBClusters 介面查看目標地區下所有 AnalyticDB MySQL 數倉版叢集的叢集 ID。	am-bp111m2cfrdl1****
RegionId	string	否	叢集所在的地區 ID。	cn-hangzhou

返回參數

名稱	類型	描述	樣本值
	object	列表詳情。
RequestId	string	請求 ID。	2895BB82-B2C1-408E-AA73-DB8D59******
Items	object
DBCluster	array<object>	叢集資訊列表。
	array<object>	列表詳情。
CreationTime	string	叢集建立時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2021-04-01T09:50:18Z
EnableSpark	boolean	是否建立了 Spark 叢集。取值說明： true：已建立。 false：未建立。	false
DtsJobId	string	DTS 同步任務 ID。僅 MySQL 分析執行個體會返回該參數。	dtsb1hp3790****
DBNodeCount	integer	節點群組個數。	1
Expired	string	叢集是否到期。取值說明： true：已到期。 false：未到期。	false
MaintainTime	string	叢集的可維護時間段，格式為HH:mmZ- HH:mmZ，例如：04:00Z-05:00Z，表示可維護時間段為 4 點至 5 點。說明更多關於可維護時間段的資訊，請參見設定可維護時間段。	04:00Z-05:00Z
PayType	string	叢集付費類型，取值說明： Postpaid：隨用隨付（即後付費）。 Prepaid：訂用帳戶（即預付費）。	Postpaid
DiskType	string	叢集的磁碟類型，取值說明： local_ssd：本地磁碟。 cloud：普通雲端硬碟。 cloud_ssd：SSD 雲端硬碟。 cloud_efficiency：高效雲端硬碟。 cloud_essd0：PL0 等級的 ESSD 雲端硬碟。 cloud_essd：PL1 等級的 ESSD 雲端硬碟。 cloud_essd2：PL2 等級的 ESSD 雲端硬碟。 cloud_essd3：PL3 等級的 ESSD 雲端硬碟。說明更多關於 ESSD 雲端硬碟的詳情，請參見 ESSD 雲端硬碟規格。	cloud_essd
Tags	object
Tag	array<object>	標籤資訊列表。
	object	列表詳情。
Key	string	標籤鍵。說明您可以調用 TagResources 介面為目的地組群建立標籤。	tag1
Value	string	標籤值。	test1
Mode	string	叢集模式，取值說明： flexible：彈性模式。 reserver：預留模式。說明更多關於叢集模式的介紹，請參見產品系列。	flexible
Port	integer	叢集連接埠號碼。	3306
LockMode	string	叢集的鎖定模式，取值說明： Unlock：正常（即未鎖定）。 ManualLock：手動觸發鎖定。 LockByExpiration：叢集到期自動鎖定。 LockByRestoration：叢集復原前自動鎖定。 LockByDiskQuota：叢集中空間滿（即資料佔用的儲存空間已到達上限水位的 90%）自動鎖定。	Unlock
EngineVersion	string	叢集引擎版本。	3.1.1.9
EnableAirflow	boolean	是否建立了 Airflow 叢集。取值說明： true：已建立。 false：未建立。	true
ExecutorCount	string	彈性模式下叢集使用的計算節點數量。	1
StorageResource	string	彈性模式用的儲存資源規格，用於資料讀寫，增加該資源能提高叢集讀寫能力。	8Core32GB
DBClusterId	string	AnalyticDB MySQL 數倉版叢集 ID。	am-bp111m2cfrdl1****
ConnectionString	string	叢集的 VPC 串連地址。	am-bp111m2cfrdl1****.ads.aliyuncs.com
RdsInstanceId	string	同步源 RDS 執行個體 ID。僅 MySQL 分析執行個體會返回該參數。	rm-bp837jsdp2****
DBClusterType	string	叢集類型。取值說明： Common：常規叢集。 RDS_ANALYSIS：MySQL 分析執行個體。	Common
CommodityCode	string	商品付費類型，取值說明： ads：隨用隨付商品。 ads_pre：訂用帳戶商品。	ads
ExpireTime	string	叢集到期時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間），例如2999-09-08T16:00:00Z。說明若目的地組群付費模式為訂用帳戶，則返回實際到期時間。若目的地組群付費模式為隨用隨付，則返回固定值2999-09-08T16:00:00Z。	2999-09-08T16:00:00Z
DBNodeStorage	integer	叢集的儲存空間，單位：GB。	300
DBNodeClass	string	節點規格。	E8
LockReason	string	叢集鎖定原因。說明僅當叢集被鎖定時會返回該參數，固定為instance_expire。	instance_expired
VPCId	string	Virtual Private CloudID。	vpc-bp13h7uzhulpuxvnp****
ComputeResource	string	彈性模式下使用的計算資源規格，用於資料計算。增加計算資源能加快查詢速度，可以根據叢集實際效能按需彈性擴縮。	8Core32GB
RegionId	string	叢集所在的地區 ID。	cn-hangzhou
ElasticIOResource	integer	彈性 IO 資源的數量。	2
VSwitchId	string	交換器 ID。	vsw-bp1syh8vvw8yech7n****
DBVersion	string	資料庫版本，當前僅支援3.0版本。	3.0
VPCCloudInstanceId	string	VPC 執行個體 ID。	am-bp111m2cfrdl1****-controller
DBClusterStatus	string	叢集狀態。更多詳情，請參見叢集狀態表。	Running
ResourceGroupId	string	資源群組 ID。	rg-acfmyiu4ekp****
DBClusterNetworkType	string	叢集網路類型。僅支援 VPC（專用網路）類型。	vpc
DBClusterDescription	string	叢集的描述資訊。	adb_test
UserENIStatus	boolean	是否已啟用 ENI（Elastic Network Interface，彈性網卡）網路，取值說明： true：已啟用。 false：未啟用。	true
ZoneId	string	叢集所在的可用性區域 ID。	cn-hangzhou-h
Category	string	產品系列，取值說明： BASIC：預留模式基礎版 CLUSTER：預留模式叢集版 MIXED_STORAGE：彈性模式叢集版（新版）說明更多關於叢集系列的介紹，請參見產品系列。	MIXED_STORAGE
Engine	string	叢集引擎，固定為 AnalyticDB。	AnalyticDB
KmsId	string	用於加密雲端硬碟資料的金鑰識別碼。說明僅當 AnalyticDB MySQL 叢集開啟雲端硬碟加密時才會返回該參數。	e1935511-cf88-1123-a0f8-1be8d251****
InnerIp	string	公網 IP。	10.1.XX.XX
InnerPort	string	公網連接埠號碼。	3306
DiskPerformanceLevel	string	雲端硬碟等級。	PL1
ElasticIOResourceSize	string	彈性資源單節點規格。取值說明： 8Core64GB：單節點規格為 8Core64GB 時，一組彈性 IO 資源的規格為 24Core192 GB。 12Core96GB：單節點規格為 12Core96GB 時，一組彈性 IO 資源的規格為 36Core288 GB。	8Core64GB
DiskEncryption	boolean	是否開啟雲端硬碟加密。取值： true：是。 false：否。	false
TaskInfo	object	任務資訊。
Name	string	任務名稱。	analyticDBFlexibleScaleOut
Status	string	任務狀態，取值為： NOT_RUN：等待運行。 RUNNING：運行中。 SUCCEED：已結束。	RUNNING
Progress	string	任務進度，單位：%。	10
StepList	object
StepList	array<object>	任務步驟。
	object	任務步驟。
StepName	string	步驟名稱。	ApplyResource
StepDesc	string	步驟描述。	Apply resource
StepStatus	string	步驟狀態，取值為： NOT_RUN：等待運行。 RUNNING：運行中。 SUCCEED：已結束。	SUCCEED
StepProgress	string	步驟進度，單位：%。	50
StartTime	string	步驟開始時間，格式為 YYYY-MM-DDThh:mm:ssZ。	2024-03-10T09:28:34Z
EndTime	string	步驟結束時間，格式為 YYYY-MM-DDThh:mm:ssZ。	2024-03-10T10:28:34Z
ProductVersion	string	產品版本。取值為： BasicVersion：基礎版。 EnterpriseVersion：企業版。	BasicVersion
SecondaryZoneId	string	備可用性區域 ID。說明本參數和 ZoneId 參數傳入的值不能相同。	cn-hangzhou-i
SecondaryVSwitchId	string	備虛擬交換器 ID。說明本參數和 VSwitchId 參數傳入的值不能相同。	vsw-0jlxwqt4531fsb3jdzx6h
ReservedNodeSize	string	預留節點規格，單位為 ACU。	8ACU
ReservedNodeCount	integer	預留資源節點數。	3
ProductForm	string	產品形態枚舉： LegacyForm: 傳統形態。 IntegrationForm：融合形態。	IntegrationForm

樣本

正常返回樣本

JSON格式

{
  "RequestId": "2895BB82-B2C1-408E-AA73-DB8D59******",
  "Items": {
    "DBCluster": [
      {
        "CreationTime": "2021-04-01T09:50:18Z",
        "EnableSpark": false,
        "DtsJobId": "dtsb1hp3790****",
        "DBNodeCount": 1,
        "Expired": "false",
        "MaintainTime": "04:00Z-05:00Z",
        "PayType": "Postpaid",
        "DiskType": "cloud_essd",
        "Tags": {
          "Tag": [
            {
              "Key": "tag1",
              "Value": "test1"
            }
          ]
        },
        "Mode": "flexible",
        "Port": 3306,
        "LockMode": "Unlock",
        "EngineVersion": "3.1.1.9",
        "EnableAirflow": true,
        "ExecutorCount": "1",
        "StorageResource": "8Core32GB",
        "DBClusterId": "am-bp111m2cfrdl1****",
        "ConnectionString": "am-bp111m2cfrdl1****.ads.aliyuncs.com",
        "RdsInstanceId": "rm-bp837jsdp2****",
        "DBClusterType": "Common",
        "CommodityCode": "ads",
        "ExpireTime": "2999-09-08T16:00:00Z",
        "DBNodeStorage": 300,
        "DBNodeClass": "E8",
        "LockReason": "instance_expired",
        "VPCId": "vpc-bp13h7uzhulpuxvnp****",
        "ComputeResource": "8Core32GB",
        "RegionId": "cn-hangzhou",
        "ElasticIOResource": 2,
        "VSwitchId": "vsw-bp1syh8vvw8yech7n****",
        "DBVersion": "3.0",
        "VPCCloudInstanceId": "am-bp111m2cfrdl1****-controller",
        "DBClusterStatus": "Running",
        "ResourceGroupId": "rg-acfmyiu4ekp****",
        "DBClusterNetworkType": "vpc",
        "DBClusterDescription": "adb_test",
        "UserENIStatus": true,
        "ZoneId": "cn-hangzhou-h",
        "Category": "MIXED_STORAGE",
        "Engine": "AnalyticDB",
        "KmsId": "e1935511-cf88-1123-a0f8-1be8d251****",
        "InnerIp": "10.1.XX.XX",
        "InnerPort": "3306",
        "DiskPerformanceLevel": "PL1",
        "ElasticIOResourceSize": "8Core64GB",
        "DiskEncryption": false,
        "TaskInfo": {
          "Name": "analyticDBFlexibleScaleOut",
          "Status": "RUNNING",
          "Progress": "10",
          "StepList": {
            "StepList": [
              {
                "StepName": "ApplyResource",
                "StepDesc": "Apply resource",
                "StepStatus": "SUCCEED",
                "StepProgress": "50",
                "StartTime": "2024-03-10T09:28:34Z",
                "EndTime": "2024-03-10T10:28:34Z"
              }
            ]
          }
        },
        "ProductVersion": "BasicVersion",
        "SecondaryZoneId": "cn-hangzhou-i",
        "SecondaryVSwitchId": "vsw-0jlxwqt4531fsb3jdzx6h",
        "ReservedNodeSize": "8ACU",
        "ReservedNodeCount": 3,
        "ProductForm": "IntegrationForm"
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	您指定的 DBClusterId 不存在，請確認 DBClusterId 值是否正確。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。