DATASOURCE::RDS::DBInstances類型用于查詢RDS實例列表。
語法
{
"Type": "DATASOURCE::RDS::DBInstances",
"Properties": {
"DedicatedHostId": String,
"EngineVersion": String,
"DBInstanceStatus": String,
"ResourceGroupId": String,
"ZoneId": String,
"DBInstanceClass": String,
"DedicatedHostGroupId": String,
"VSwitchId": String,
"DBInstanceType": String,
"InstanceLevel": Number,
"Expired": String,
"PayType": String,
"InstanceNetworkType": String,
"VpcId": String,
"DBInstanceId": String,
"SearchKey": String,
"ConnectionMode": String,
"ConnectionString": String,
"Engine": String,
"proxyId": String,
"RefreshOptions": String
}
}
屬性
屬性名稱 | 類型 | 必須 | 允許更新 | 描述 | 約束 |
DedicatedHostId | String | 否 | 是 | 專屬集群內的主機ID。 | 無 |
EngineVersion | String | 否 | 是 | 數據庫版本。 | 無 |
DBInstanceStatus | String | 否 | 是 | 實例狀態。 | 更多信息,請參見實例狀態表。 |
ResourceGroupId | String | 否 | 是 | 資源組ID。 | 無 |
ZoneId | String | 否 | 是 | 可用區ID。 | 無 |
DBInstanceClass | String | 否 | 是 | 實例規格。 | 更多信息,請參見主實例規格列表。 |
DedicatedHostGroupId | String | 否 | 是 | 專屬集群ID。 | 無 |
VSwitchId | String | 否 | 是 | 交換機ID。 | 無 |
DBInstanceType | String | 否 | 是 | 實例類型。 | 取值:
|
InstanceLevel | Number | 否 | 是 | 是否返回實例系列(Category)信息。 | 取值:
|
Expired | String | 否 | 是 | 實例的過期狀態。 | 取值:
|
PayType | String | 否 | 是 | 付費類型。 | 取值:
|
InstanceNetworkType | String | 否 | 是 | 實例的網絡類型。 | 取值:
|
VpcId | String | 否 | 是 | 專有網絡ID。 | 無 |
DBInstanceId | String | 否 | 是 | 實例ID。 | 無 |
SearchKey | String | 否 | 是 | 可基于實例ID或者實例備注模糊搜索。 | 無 |
ConnectionMode | String | 否 | 是 | 實例的訪問模式。 | 取值:
|
ConnectionString | String | 否 | 是 | 實例的連接地址。 | 無 |
Engine | String | 否 | 是 | 數據庫類型。 | 取值:
|
proxyId | String | 否 | 是 | 代理模式ID。 | 無 |
RefreshOptions | String | 否 | 是 | 當資源棧更新時,數據源資源的刷新策略。 | 有效值:
|
返回數據(Fn::GetAtt)
DBInstanceIds:RDS實例ID列表。
DBInstances:RDS實例詳情列表。
屬性名稱 | 類型 | 描述 | 約束 |
DBInstanceIds | List | RDS實例ID列表。 | 無 |
DBInstances | List | RDS實例詳情列表。 | 無 |
VpcId | String | 專有網絡ID。 | 無 |
CreateTime | String | 創建時間。 | 按照ISO8601標準表示,并需要使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 |
PayType | String | 實例的付費類型。 | 取值:
|
EngineVersion | String | 數據庫版本。 | 無 |
VpcName | String | VPC名稱。 | 無 |
ConnectionString | String | 實例的連接地址。 | 無 |
InstanceNetworkType | String | 實例的網絡類型。 | 取值:
|
MasterInstanceId | String | 主實例的ID。 | 如果未返回此參數(即為null),則表示該實例是主實例。 |
ExpireTime | String | 到期時間。 | 按照ISO8601標準表示,并需要使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 說明 按量付費實例無到期時間。 |
GuardDBInstanceId | String | 災備實例的ID。 | 無 |
ZoneId | String | 可用區ID。 | 無 |
DBInstanceId | String | 實例ID。 | 無 |
TempDBInstanceId | String | 臨時實例的ID。 | 無 |
DBInstanceStorageType | String | 實例儲存類型。 | 無 |
ConnectionMode | String | 實例的訪問模式。 | 取值:
|
DBInstanceDescription | String | 實例描述。 | 無 |
DBInstanceNetType | String | 實例的網絡連接類型。 | 取值:
|
DBInstanceType | String | 實例類型。 | 取值:
|
DBInstanceStatus | String | 實例狀態。 | 更多信息,請參見實例狀態表。 |
VSwitchId | String | 交換機ID。 | 無 |
ResourceGroupId | String | 資源組ID。 | 無 |
Category | String | 實例系列。 | 取值:
說明 當InstanceLevel參數為1時,返回該參數。 |
Engine | String | 數據庫類型。 | 取值:
|
DBInstanceClass | String | 實例規格。 | 更多信息,請參見主實例規格列表。 |
ReadOnlyDBInstanceIds | List | 只讀實例的ID列表。 | 無 |
DeletionProtection | Boolean | 是否已開啟釋放保護功能。 | 取值:
|
示例
{
"ROSTemplateFormatVersion": "2015-09-01",
"Parameters": {
"DBInstanceId": {
"Type": "String",
"Description": "The ID of the instance."
}
},
"Resources": {
"ExtensionDataSource": {
"Type": "DATASOURCE::RDS::DBInstances",
"Properties": {
"DBInstanceId": {
"Ref": "DBInstanceId"
}
}
}
},
"Outputs": {
"DBInstances": {
"Description": "The list of The RDS Database instances.",
"Value": {
"Fn::GetAtt": [
"ExtensionDataSource",
"DBInstances"
]
}
},
"DBInstanceIds": {
"Description": "The list of The RDS Database instance Ids.",
"Value": {
"Fn::GetAtt": [
"ExtensionDataSource",
"DBInstanceIds"
]
}
}
}
}
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
DBInstanceId:
Type: String
Description: The ID of the instance.
Resources:
ExtensionDataSource:
Type: DATASOURCE::RDS::DBInstances
Properties:
DBInstanceId:
Ref: DBInstanceId
Outputs:
DBInstances:
Description: The list of The RDS Database instances.
Value:
Fn::GetAtt:
- ExtensionDataSource
- DBInstances
DBInstanceIds:
Description: The list of The RDS Database instance Ids.
Value:
Fn::GetAtt:
- ExtensionDataSource
- DBInstanceIds