Tüm Ürünler
Search
Belge Merkezi

Resource Orchestration Service:DATASOURCE::RDS::DBInstances

Son Güncelleme:Oct 05, 2026

DATASOURCE::RDS::DBInstances kaynağı, ApsaraDB RDS örneklerini sorgulamak için kullanılır.

Söz dizimi

{
  "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
  }
}

Özellikler

Özellik

Tür

Gerekli

Düzenlenebilir

Açıklama

Kısıtlama

DedicatedHostId

String

Hayır

Evet

Adanmış kümedeki ana makinenin kimliği.

Yok.

EngineVersion

String

Hayır

Evet

Veritabanı altyapısının sürümü.

Yok.

DBInstanceStatus

String

Hayır

Evet

Örneğin durumu.

Daha fazla bilgi için bkz. Örnek durum tablosu.

ResourceGroupId

String

Hayır

Evet

Kaynak grubunun kimliği.

Yok.

ZoneId

String

Hayır

Evet

Alan kimliği.

Yok.

DBInstanceClass

String

Hayır

Evet

Örnek türü.

Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri.

DedicatedHostGroupId

String

Hayır

Evet

Adanmış kümenin kimliği.

Yok.

VSwitchId

String

Hayır

Evet

vSwitch kimliği.

Yok.

DBInstanceType

String

Hayır

Evet

Örneğin kategorisi.

Geçerli değerler:

  • Primary: birincil örnek

  • Readonly: salt okunur örnek

  • Guard: olağanüstü durum kurtarma örneği

  • Temp: geçici örnek

InstanceLevel

Number

Hayır

Evet

Örneğin sürümünün döndürülüp döndürülmeyeceğini belirtir.

Geçerli değerler:

  • 0: Örneğin sürümü döndürülmez.

  • 1: Örneğin sürümü döndürülür.

Expired

String

Hayır

Evet

Örneğin süresinin dolup dolmadığını belirtir.

Geçerli değerler:

  • true

  • false

PayType

String

Hayır

Evet

Faturalandırma yöntemi.

Geçerli değerler:

  • Postpaid: kullandıkça öde

  • Prepaid: abonelik

InstanceNetworkType

String

Hayır

Evet

Örneğin ağ türü.

Geçerli değerler:

  • VPC

  • Classic

VpcId

String

Hayır

Evet

Sanal özel cloud (VPC) kimliği.

Yok.

DBInstanceId

String

Hayır

Evet

Örnek kimliği.

Yok.

SearchKey

String

Hayır

Evet

Örnekler için bulanık arama yapmak üzere kullanılan örnek kimliklerinin veya açıklamalarının anahtar sözcüğü.

Yok.

ConnectionMode

String

Hayır

Evet

Örneğin bağlantı modu.

Geçerli değerler:

  • Standard: standart mod

  • Safe: veritabanı proxy modu

ConnectionString

String

Hayır

Evet

Örneğin uç noktası.

Yok.

Engine

String

Hayır

Evet

Veritabanı altyapısının türü.

Geçerli değerler:

  • MySQL

  • SQLServer

  • PostgreSQL

  • MariaDB

proxyId

String

Hayır

Evet

Proxy modunun kimliği.

Yok.

RefreshOptions

String

Hayır

Evet

Yığın güncellendiğinde veri kaynağı kaynakları için yenileme ilkesi.

Geçerli değerler:

  • Never (varsayılan): Yığın güncellendiğinde veri kaynağı kaynaklarını yenilemez.

  • Always: Yığın güncellendiğinde veri kaynağı kaynaklarını yeniler.

Dönüş değerleri (Fn::GetAtt)

  • DBInstanceIds: Örneklerin kimlikleri.

  • DBInstances: Örneklerin ayrıntıları.

Özellik

Tür

Açıklama

Kısıtlama

DBInstanceIds

List

Örneklerin kimlikleri.

Yok.

DBInstances

List

Örneklerin ayrıntıları.

Yok.

VpcId

String

VPC kimliği.

Yok.

CreateTime

String

Oluşturma zamanı.

Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak gösterilir.

PayType

String

Örneğin faturalandırma yöntemi.

Geçerli değerler:

  • Postpaid: kullandıkça öde

  • Prepaid: abonelik

EngineVersion

String

Veritabanı altyapısının sürümü.

Yok.

VpcName

String

VPC adı.

Yok.

ConnectionString

String

Örneğin uç noktası.

Yok.

InstanceNetworkType

String

Örneğin ağ türü.

Geçerli değerler:

  • Classic

  • VPC

MasterInstanceId

String

Birincil örneğin kimliği.

null değeri, örneğin bir birincil örnek olduğunu gösterir.

ExpireTime

String

Son kullanma zamanı.

Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardını izler. Zaman UTC olarak gösterilir.

Not

Bu özellik, kullandıkça öde örnekler için döndürülmez.

GuardDBInstanceId

String

Olağanüstü durum kurtarma örneğinin kimliği.

Yok.

ZoneId

String

Alan kimliği.

Yok.

DBInstanceId

String

Örnek kimliği.

Yok.

TempDBInstanceId

String

Geçici örneğin kimliği.

Yok.

DBInstanceStorageType

String

Örneğin depolama türü.

Yok.

ConnectionMode

String

Örneğin bağlantı modu.

Geçerli değerler:

  • Standard: standart mod

  • Safe: veritabanı proxy modu

DBInstanceDescription

String

Örneğin açıklaması.

Yok.

DBInstanceNetType

String

Örneğin ağ bağlantı türü.

Geçerli değerler:

  • Internet

  • Intranet

DBInstanceType

String

Örneğin kategorisi.

Geçerli değerler:

  • Primary: birincil örnek

  • Readonly: salt okunur örnek

  • Guard: olağanüstü durum kurtarma örneği

  • Temp: geçici örnek

DBInstanceStatus

String

Örneğin durumu.

Daha fazla bilgi için bkz. Örnek durum tablosu.

VSwitchId

String

vSwitch kimliği.

Yok.

ResourceGroupId

String

Kaynak grubunun kimliği.

Yok.

Category

String

Örneğin sürümü.

Geçerli değerler:

  • Basic: RDS Basic Edition

  • HighAvailability: RDS High-availability Edition

  • Finance: RDS Enterprise Edition

Not

Bu özellik, InstanceLevel 1 olarak ayarlandığında döndürülür.

Engine

String

Veritabanı altyapısının türü.

Geçerli değerler:

  • MySQL

  • SQLServer

  • PostgreSQL

  • MariaDB

DBInstanceClass

String

Örnek türü.

Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri.

ReadOnlyDBInstanceIds

List

Salt okunur örneklerin kimlikleri.

Yok.

DeletionProtection

Boolean

Silme koruma özelliğinin etkin olup olmadığını gösterir.

Geçerli değerler:

  • true

  • false

Örnekler

{
  "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