Tüm Ürünler
Search
Belge Merkezi

Resource Orchestration Service:ALIYUN::RDS::ReadOnlyDBInstance

Son Güncelleme:Oct 05, 2026

ALIYUN::RDS::ReadOnlyDBInstance, salt okuma amaçlı bir ApsaraDB RDS örneği oluşturmak için kullanılır.

Sözdizimi

{
  "Type": "ALIYUN::RDS::ReadOnlyDBInstance",
  "Properties": {
    "Category": String,
    "VPCId": String,
    "DBInstanceDescription": String,
    "Tags": Map,
    "EngineVersion": String,
    "DBInstanceId": String,
    "PayType": String,
    "ZoneId": String,
    "ResourceGroupId": String,
    "DBInstanceStorage": Integer,
    "VSwitchId": String,
    "DBInstanceStorageType": String,
    "DBInstanceClass": String,
    "PrivateIpAddress": String,
    "PeriodType": String,
    "Period": Integer,
    "AutoRenew": Boolean,
    "TargetDedicatedHostIdForMaster": String,
    "DeletionProtection": Boolean,
    "DedicatedHostGroupId": String
  }
}

Özellikler

Özellik

Tür

Gerekli

Düzenlenebilir

Açıklama

Kısıtlama

Category

String

Hayır

Hayır

Örnek sürümü.

Geçerli değerler:

  • Basic: Basic Edition

  • HighAvailability (varsayılan): High-availability Edition

  • AlwaysOn: Cluster Edition

VPCId

String

Hayır

Hayır

Salt okuma örneğinin sanal özel cloud (VPC) kimliği.

Yok.

DBInstanceDescription

String

Hayır

Hayır

Örnek açıklaması.

Açıklama 2 ila 256 karakter uzunluğunda olmalı; harf, rakam, alt çizgi (_) ve kısa çizgi (-) içerebilir. Açıklama bir harfle başlamalıdır ancak http:// veya https:// ile başlayamaz.

Tags

Map

Hayır

Evet

Salt okuma örneğinin etiketleri.

Etiketler anahtar-değer çifti biçimindedir. Örnek:

{"key1": "value1","key2": "value2", ... "key5": "value5"}

En fazla beş anahtar-değer çifti belirtebilirsiniz. Bir etiket anahtarı en fazla 64 karakter uzunluğunda olabilir ve http:// veya https:// ile başlayamaz. Bir etiket değeri en fazla 128 karakter uzunluğunda olabilir ve aliyun, http:// veya https:// ile başlayamaz.

EngineVersion

String

Evet

Hayır

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

Salt okuma örneğinin veritabanı altyapısı sürümü, birincil örneğin veritabanı altyapısı sürümüyle aynı olmalıdır.

  • Veritabanı altyapısı MySQL olduğunda geçerli değerler:

    • 5.6

    • 5.7

    • 8.0

  • Veritabanı altyapısı SQL Server olduğunda geçerli değer: 2017_ent

DBInstanceId

String

Evet

Hayır

Birincil örneğin kimliği.

Yok.

PayType

String

Hayır

Hayır

Salt okuma örneğinin faturalandırma yöntemi.

Yalnızca kullandıkça öde faturalandırma yöntemi desteklenir.

Değeri Postpaid olarak ayarlayın.

ZoneId

String

Evet

Hayır

Salt okuma örneğinin alan kimliği.

En güncel alan listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

ResourceGroupId

String

Hayır

Hayır

Kaynak grubunun kimliği.

Yok.

DBInstanceStorage

Integer

Evet

Evet

Salt okuma örneğinin depolama kapasitesi.

Birim: GB.

Geçerli değerler: 5 ila 3000. Değer 5'in katı olmalıdır.

Farklı sürümlerin örnekleri için farklı değer aralıkları bulunur. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri.

VSwitchId

String

Hayır

Hayır

Salt okuma örneğinin vSwitch kimliği.

Yok.

DBInstanceStorageType

String

Hayır

Hayır

Salt okuma örneğinin depolama türü.

Geçerli değerler:

  • local_ssd veya ephemeral_ssd: yerel SSD

  • cloud_ssd: standart SSD

  • cloud_essd: Geliştirilmiş SSD (ESSD)

Not

MySQL için ApsaraDB RDS salt okuma örneklerinde yalnızca yerel SSD'leri, SQL Server için ApsaraDB RDS salt okuma örneklerinde ise yalnızca standart SSD'leri veya ESSD'leri kullanabilirsiniz.

DBInstanceClass

String

Evet

Evet

Salt okuma örneğinin örnek türü.

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

Birincil örneğin örnek türüne eşit veya daha yüksek bir örnek türü belirtmenizi öneririz. Salt okuma örneğinin örnek türü birincil örneğinkinden düşük olursa yüksek gecikme süresi ve yoğun yük gibi sorunlar yaşanabilir.

PrivateIpAddress

String

Hayır

Hayır

Salt okuma örneğinin özel IP adresi.

Özel IP adresi, belirttiğiniz vSwitch'in IP adresi aralığında olmalıdır. Sistem, VPCId ve VSwitchId değerlerine göre örneğe otomatik olarak bir özel IP adresi atar.

PeriodType

String

Hayır

Hayır

Salt okuma örneğinin abonelik süresinin birimi.

Geçerli değerler:

  • Year

  • Month

Period

Integer

Hayır

Hayır

Salt okuma örneğinin abonelik süresi.

  • PeriodType Year olarak ayarlandığında geçerli değerler: 1 ila 3.

  • PeriodType Month olarak ayarlandığında geçerli değerler: 1 ila 9.

AutoRenew

Boolean

Hayır

Hayır

Salt okuma örneği için otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir.

Bu özellik yalnızca salt okuma örneği abonelik faturalandırma yöntemini kullandığında etkili olur.

Geçerli değerler:

  • true

  • false (varsayılan)

Not
  • PeriodType Month olarak ayarlanırsa otomatik yenileme döngüsü bir aydır.

  • PeriodType Year olarak ayarlanırsa otomatik yenileme döngüsü bir yıldır.

TargetDedicatedHostIdForMaster

String

Hayır

Hayır

Birincil örneğin üzerinde bulunduğu ana bilgisayarın kimliği. Bu özellik, salt okuma örneğini özel bir kümede oluşturduğunuzda etkili olur.

Yok.

DeletionProtection

Boolean

Hayır

Hayır

Salt okuma örneği için silme koruması özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

Geçerli değerler:

  • true:

  • false (varsayılan)

Not

Kullandıkça öde esasına göre faturalandırılan örnekler için silme koruması özelliğini etkinleştirebilirsiniz.

DedicatedHostGroupId

String

Hayır

Hayır

Salt okuma örneğinin ait olduğu özel kümenin kimliği. Bu özellik, salt okuma örneğini özel bir kümede oluşturduğunuzda geçerlidir.

Yok.

Dönüş değerleri

Fn::GetAtt

  • ConnectionString: Salt okuma örneğinin dahili uç noktası.

  • DBInstanceId: Salt okuma örneğinin kimliği.

  • Port: Salt okuma örneğinin dahili bağlantı noktası.

Örnekler

YAML formatı

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DBInstanceId:
    Type: String
    Description: The ID of the master instance.
  ZoneId:
    Type: String
    Description: Create an Availability Zone for an instance to ensure that the Availability Zone supports the creation of rds resource specifications.
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
    Label: Zone ID
  VPC:
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
    Type: String
    Description: Please search the ID starts with (vpc-xxx)from console-Virtual Private Cloud
    Label: Existing VPC Instance ID
  VSwitch:
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    Type: String
    Description: Please search the business VSwitch ID starts with(vsw-xxx)from console-Virtual Private Cloud-VSwitches
    Label: Existing VSwitch ID
    AssociationPropertyMetadata:
      VpcId: VPC
      ZoneId: ZoneId
  EngineVersion:
    Type: String
    Description: 'MySQL: 5.5, 5.6, 5.7, 5.8, SQLServer: 2008r2, PostgreSQL: 9.4'
    Default: '5.6'
  DBInstanceClass:
    Type: String
    Description: Instance Class
    Default: rds.mysql.s2.large
  DBInstanceStorage:
    Type: Number
    Description: MySQL: 5-1000, SQLServer: 10-1000, others: 5-2000
    Default: 40
Resources:
  ReadOnlyDBInstance:
    Type: ALIYUN::RDS::ReadOnlyDBInstance
    DependsOn: RDSInstance
    Properties:
      VPCId:
        Ref: VPC
      DBInstanceId:
        Ref: DBInstanceId
      ZoneId:
        Ref: ZoneId
      DBInstanceStorage:
        Ref: DBInstanceStorage
      VSwitchId:
        Ref: VSwitch
      EngineVersion:
        Ref: EngineVersion
      DBInstanceClass:
        Ref: DBInstanceClass
Outputs:
  DBInstanceId:
    Description: The instance id of created database instance.
    Value:
      Fn::GetAtt:
        - ReadOnlyDBInstance
        - DBInstanceId
  Port:
    Description: Intranet port of created DB instance.
    Value:
      Fn::GetAtt:
        - ReadOnlyDBInstance
        - Port
  ConnectionString:
    Description: DB instance connection url by Intranet.
    Value:
      Fn::GetAtt:
        - ReadOnlyDBInstance
        - ConnectionString

JSON formatı

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DBInstanceId": {
      "Type": "String",
      "Description": "The ID of the master instance."
    },
    "ZoneId": {
      "Type": "String",
      "Description": "Create an Availability Zone for an instance to ensure that the Availability Zone supports the creation of rds resource specifications.",
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId",
      "Label": "Zone ID"
    },
    "VPC": {
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId",
      "Type": "String",
      "Description": "Please search the ID starts with (vpc-xxx)from console-Virtual Private Cloud",
      "Label": "Existing VPC Instance ID"
    },
    "VSwitch": {
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "Type": "String",
      "Description": "Please search the business VSwitch ID starts with(vsw-xxx)from console-Virtual Private Cloud-VSwitches",
      "Label": "Existing VSwitch ID",
      "AssociationPropertyMetadata": {
        "VpcId": "VPC",
        "ZoneId": "ZoneId"
      }
    },
    "EngineVersion": {
      "Type": "String",
      "Description": "MySQL: 5.5, 5.6, 5.7, 5.8, SQLServer: 2008r2, PostgreSQL: 9.4",
      "Default": "5.6"
    },
    "DBInstanceClass": {
      "Type": "String",
      "Description": "Instance Class",
      "Default": "rds.mysql.s2.large"
    },
    "DBInstanceStorage": {
      "Type": "Number",
      "Description": "MySQL:5-1000, SQLServer: 10-1000, others: 5-2000",
      "Default": 40
    }
  },
  "Resources": {
    "ReadOnlyDBInstance": {
      "Type": "ALIYUN::RDS::ReadOnlyDBInstance",
      "DependsOn": "RDSInstance",
      "Properties": {
        "VPCId": {
          "Ref": "VPC"
        },
        "DBInstanceId": {
          "Ref": "DBInstanceId"
        },
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "DBInstanceStorage": {
          "Ref": "DBInstanceStorage"
        },
        "VSwitchId": {
          "Ref": "VSwitch"
        },
        "EngineVersion": {
          "Ref": "EngineVersion"
        },
        "DBInstanceClass": {
          "Ref": "DBInstanceClass"
        }
      }
    }
  },
  "Outputs": {
    "DBInstanceId": {
      "Description": "The instance id of created database instance.",
      "Value": {
        "Fn::GetAtt": [
          "ReadOnlyDBInstance",
          "DBInstanceId"
        ]
      }
    },
    "Port": {
      "Description": "Intranet port of created DB instance.",
      "Value": {
        "Fn::GetAtt": [
          "ReadOnlyDBInstance",
          "Port"
        ]
      }
    },
    "ConnectionString": {
      "Description": "DB instance connection url by Intranet.",
      "Value": {
        "Fn::GetAtt": [
          "ReadOnlyDBInstance",
          "ConnectionString"
        ]
      }
    }
  }
}