全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::REDIS::Instance

更新时间:Oct 01, 2025

Gunakan ALIYUN::REDIS::Instance untuk membuat instance Tair (Redis OSS-compatible).

Sintaksis

 {
  "Type": "ALIYUN::REDIS::Instance",
  "Properties": {
    "VpcId": String,
    "EvictionPolicy": String,
    "BackupPolicy": Map,
    "ZoneId": String,
    "InstanceClass": String,
    "InstanceMaintainTime": Map,
    "Tags": List,
    "VpcPasswordFree": Boolean,
    "VSwitchId": String,
    "SecurityGroupId": String,
    "EngineVersion": String,
    "SSLEnabled": String,
    "Password": String,
    "InstanceName": String,
    "DeletionForce": Boolean,
    "Connections": Map,
    "ChargeType": String,
    "Period": Integer,
    "AutoRenewDuration": Integer,
    "ProductType": String,
    "SubscriptionDeletionForce": Boolean,
    "SecondaryZoneId": String,
    "ResourceGroupId": String,
    "PeriodUnit": String,
    "TairConfig": Map,
    "ShardCount": Integer,
    "NodeType": String,
    "DeletionProtection": Boolean,
    "ReadOnlyCount": Integer
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

EngineVersion

String

Tidak

Ya

Versi mesin database.

Nilai yang valid:

  • 2.8

    Catatan

    Versi ini tidak tersedia. Pilih yang lain.

  • 4.0

  • 5.0

InstanceClass

String

Tidak

Ya

Spesifikasi instance.

Untuk informasi lebih lanjut, lihat Spesifikasi instance.

InstanceMaintainTime

Map

Tidak

Ya

Jendela pemeliharaan instance.

Tidak ada.

Tags

List

Tidak

Ya

Tag instance.

Anda dapat menambahkan hingga 20 tag ke sebuah instance.

Untuk informasi lebih lanjut, lihat Properti Tags.

VpcPasswordFree

Boolean

Tidak

Tidak

Menentukan apakah akan mengaktifkan fitur akses tanpa kata sandi untuk instance dalam virtual private cloud (VPC).

Nilai yang valid:

  • true

  • false (default)

VpcId

String

Tidak

Tidak

ID VPC.

Tidak ada.

EvictionPolicy

String

Tidak

Tidak

Kebijakan pengusiran data.

Nilai yang valid:

  • noeviction: Sistem tidak mengusir kunci, tetapi mengembalikan kesalahan untuk operasi penulisan.

  • allkeys-lru: Sistem mengusir kunci yang paling jarang digunakan (LRU).

  • volatile-lru: Sistem mengusir kunci LRU dari kunci yang memiliki waktu hidup (TTL) dikonfigurasi.

  • allkeys-random: Sistem mengusir kunci secara acak.

  • volatile-random: Sistem mengusir kunci secara acak dari kunci yang memiliki TTL dikonfigurasi.

  • volatile-ttl: Sistem mengusir kunci dengan TTL terpendek dari kunci yang memiliki TTL dikonfigurasi.

ZoneId

String

Tidak

Tidak

ID zona instance.

Anda harus menentukan properti ini saat instance dibuat di VPC.

Jika Anda ingin membuat instance di beberapa zona, panggil operasi DescribeZones untuk meminta ID zona yang didukung.

VSwitchId

String

Tidak

Tidak

ID vSwitch yang berada di VPC.

Tidak ada.

SecurityGroupId

String

Tidak

Ya

ID grup keamanan.

Anda dapat menentukan hingga 10 ID. Pisahkan beberapa ID dengan koma (,).

Password

String

Tidak

Ya

Kata sandi.

Kata sandi harus memiliki panjang 8 hingga 30 karakter dan harus mengandung huruf besar, huruf kecil, dan angka.

SSLEnabled

String

Tidak

Ya

Status enkripsi Secure Sockets Layer (SSL).

Nilai yang valid:

  • Disable: Enkripsi SSL dinonaktifkan.

  • Enable: Enkripsi SSL diaktifkan.

  • Update: Sertifikat SSL diperbarui.

InstanceName

String

Tidak

Ya

Nama instance.

Nama harus memiliki panjang 2 hingga 128 karakter dan dapat mengandung huruf, angka, garis bawah (_), tanda hubung (-), dan titik (.). Nama harus dimulai dengan huruf.

DeletionForce

Boolean

Tidak

Ya

Menentukan apakah akan menghapus instance ketika instance dipindahkan ke tempat sampah.

Nilai yang valid:

  • true

  • false (default)

SubscriptionDeletionForce

Boolean

Tidak

Tidak

Properti ini hanya berlaku untuk instance langganan. Jika Anda mengatur properti ini ke true untuk instance langganan, instance tersebut diubah menjadi pay-as-you-go sebelum instance tersebut dihapus secara paksa. Jika Anda mengatur properti ini ke false untuk instance langganan, instance tersebut tidak dihapus secara paksa. Properti ini melibatkan biaya tambahan. Berhati-hatilah saat menentukan properti ini.

Tidak ada.

Connections

Map

Tidak

Ya

Titik akhir instance.

Untuk informasi lebih lanjut, lihat Properti Connections.

BackupPolicy

Map

Tidak

Ya

Kebijakan cadangan.

Untuk informasi lebih lanjut, lihat Properti BackupPolicy.

ChargeType

String

Tidak

Ya

Metode penagihan instance.

Nilai yang valid:

  • PostPaid (default): pay-as-you-go

  • PrePaid: langganan

Period

Integer

Tidak

Ya

Siklus penagihan instance.

Nilai yang valid: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, dan 60.

Satuan: bulan.

AutoRenewDuration

Integer

Tidak

Ya

Durasi perpanjangan otomatis instance.

Nilai yang valid: 1 hingga 12.

Satuan: bulan.

Saat instance akan kedaluwarsa, sistem secara otomatis memperpanjang instance berdasarkan nilai properti ini.

Catatan

Properti ini berlaku saat ChargeType disetel ke PrePaid.

ProductType

String

Tidak

Tidak

Edition instance.

Nilai yang valid:

  • Local: instans Redis Open-Source Edition klasik atau instans DRAM-based klasik

  • Tair_rdb: instans DRAM-based asli cloud

  • Tair_scm: instans Tair persistent memory-optimized

  • Tair_essd: instans Tair ESSD/SSD-based

  • OnECS: instans Redis Open-Source Edition asli cloud

Catatan

Kami merekomendasikan Anda menentukan ProductType untuk mempercepat permintaan parameter.

SecondaryZoneId

String

Tidak

Ya

ID zona sekunder.

Anda dapat memanggil operasi DescribeZones untuk meminta ID zona sekunder.

Catatan

Jika Anda menentukan properti ini, node master dan node replika instance dapat ditempatkan di zona yang berbeda, dan pemulihan bencana dilakukan lintas zona. Instance dapat menahan kegagalan pusat data.

ResourceGroupId

String

Tidak

Ya

ID grup sumber daya.

Tidak ada.

PeriodUnit

String

Tidak

Ya

Satuan durasi langganan.

Nilai yang valid:

  • Tahun

  • Bulan

TairConfig

Map

Tidak

Tidak

Konfigurasi Tair.

Untuk informasi lebih lanjut, lihat Properti TairConfig.

ReadOnlyCount

Integer

Tidak

Tidak

Jumlah replika baca di zona utama.

ReadOnlyCount berlaku hanya untuk instance read/write splitting berbasis cloud-native. Jika instance adalah instance cluster, parameter sebelumnya menunjukkan jumlah replika baca per shard di zona utama dan sekunder.

ShardCount

Integer

Tidak

Tidak

Jumlah shard.

Properti ini tersedia hanya untuk instance cluster yang menggunakan cloud disk. Anda dapat menggunakan properti ini untuk menentukan jumlah shard data kustom.

NodeType

String

Tidak

Tidak

Tipe node.

Nilai yang valid:

  • MASTER_SLAVE: high availability (master-replica)

  • STAND_ALONE: standalone

  • double: master-replica

  • single: standalone

Catatan

Jika Anda ingin membuat instance cloud-native, atur properti ini ke MASTER_SLAVE atau STAND_ALONE. Jika Anda ingin membuat instance klasik, atur properti ini ke double atau single.

DeletionProtection

Boolean

Tidak

Ya

Menentukan apakah akan mengaktifkan fitur perlindungan penghapusan.

Nilai yang valid:

  • true

  • false

Sintaksis BackupPolicy

"BackupPolicy": {
  "PreferredBackupPeriod": "String",
  "PreferredBackupTime": "String",
  "EnableBackupLog": "Integer"
}

Properti BackupPolicy

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

PreferredBackupPeriod

String

Ya

Ya

Hari dalam seminggu saat sistem mencadangkan data.

Nilai yang valid:

  • Senin

  • Selasa

  • Rabu

  • Kamis

  • Jumat

  • Sabtu

  • Minggu

PreferredBackupTime

String

Ya

Ya

Waktu saat sistem mencadangkan data.

Tentukan waktu dalam standar ISO 8601 dalam format HH:mmZ-HH:mmZ.

EnableBackupLog

Integer

Tidak

Ya

Menentukan apakah akan mengaktifkan pencadangan tambahan.

Nilai yang valid:

  • 1: mengaktifkan pencadangan tambahan.

  • 0 (default): menonaktifkan pencadangan tambahan.

Sintaksis InstanceMaintainTime

"InstanceMaintainTime": {
  "MaintainStartTime": "String",
  "MaintainEndTime": "String"
}

Properti InstanceMaintainTime

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

MaintainStartTime

String

Tidak

Tidak

Waktu mulai jendela pemeliharaan.

Tentukan waktu dalam standar ISO 8601 dalam format HH:mmZ. Waktu harus dalam UTC. Misalnya, jika Anda ingin jendela pemeliharaan dimulai pada 01:00:00 (UTC+8), atur properti ini ke 17:00Z.

MaintainEndTime

String

Tidak

Tidak

Waktu akhir jendela pemeliharaan.

Tentukan waktu dalam standar ISO 8601 dalam format HH:mmZ. Waktu harus dalam UTC. Misalnya, jika Anda ingin jendela pemeliharaan berakhir pada 02:00:00 (UTC+8), atur properti ini ke 18:00Z.

Catatan

Waktu akhir harus satu jam setelah waktu mulai. Misalnya, jika Anda mengatur MaintainStartTime ke 17:00Z, atur MaintainEndTime ke 18:00Z.

Sintaksis Tags

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]  

Properti Tags

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Key

String

Ya

Tidak

Kunci tag.

Kunci tag harus unik di dalam akun Alibaba Cloud di suatu wilayah.

Value

String

Tidak

Tidak

Nilai tag.

Tidak ada.

Sintaksis Connections

"Connections": {
  "VpcPrivateConnection": "Map",
  "ClassicInnerConnection": "Map",
  "DirectConnection": "Map",
  "PublicConnection": "Map"
}

Properti Connections

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

VpcPrivateConnection

Map

Tidak

Ya

Titik akhir VPC.

Untuk informasi lebih lanjut, lihat Properti VpcPrivateConnection.

ClassicInnerConnection

Map

Tidak

Ya

Titik akhir jaringan klasik.

Untuk informasi lebih lanjut, lihat Properti ClassicInnerConnection.

DirectConnection

Map

Tidak

Ya

Titik akhir pribadi dalam mode koneksi langsung. Jika instance Anda adalah instance cluster, Anda dapat meminta titik akhir pribadi dalam mode koneksi langsung berdasarkan kebutuhan bisnis Anda.

Untuk informasi lebih lanjut, lihat Properti DirectConnection.

PublicConnection

Map

Tidak

Ya

Titik akhir publik.

Untuk informasi lebih lanjut, lihat Properti PublicConnection.

Sintaksis VpcPrivateConnection

"VpcPrivateConnection": {
  "ConnectionPort": Integer,
  "ConnectionString": String
}

Properti VpcPrivateConnection

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

ConnectionPort

Integer

Ya

Ya

Nomor port yang digunakan oleh instance untuk menyediakan layanan.

Nilai yang valid: 1024 hingga 65535.

ConnectionString

String

Ya

Ya

Awalan titik akhir VPC.

Awalan harus memiliki panjang 8 hingga 64 karakter dan dapat mengandung huruf kecil dan angka. Awalan harus dimulai dengan huruf kecil.

Sintaksis PublicConnection

"PublicConnection": {
  "ConnectionPort": Integer,
  "ConnectionString": String
}

Properti PublicConnection

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

ConnectionPort

Integer

Ya

Ya

Nomor port yang digunakan oleh instance untuk menyediakan layanan.

Nilai yang valid: 1024 hingga 65535.

ConnectionString

String

Ya

Ya

Awalan titik akhir publik.

Awalan harus memiliki panjang 8 hingga 64 karakter dan dapat mengandung huruf kecil dan angka. Awalan harus dimulai dengan huruf kecil.

Sintaksis DirectConnection

"DirectConnection": {
  "ConnectionPort": Integer,
  "ConnectionString": String
}

Properti DirectConnection

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

ConnectionPort

Integer

Ya

Ya

Nomor port yang digunakan oleh instance untuk menyediakan layanan.

Nilai yang valid: 1024 hingga 65535.

ConnectionString

String

Ya

Ya

Awalan titik akhir pribadi dalam mode koneksi langsung.

Awalan harus memiliki panjang 8 hingga 64 karakter dan dapat mengandung huruf kecil dan angka. Awalan harus dimulai dengan huruf kecil.

Sintaksis ClassicInnerConnection

"ClassicInnerConnection": {
  "ConnectionPort": Integer,
  "ConnectionString": String
}

Properti ClassicInnerConnection

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

ConnectionPort

Integer

Ya

Ya

Nomor port yang digunakan oleh instance untuk menyediakan layanan.

Nilai yang valid: 1024 hingga 65535.

ConnectionString

String

Ya

Ya

Awalan titik akhir jaringan klasik.

Awalan harus memiliki panjang 8 hingga 64 karakter dan dapat mengandung huruf kecil dan angka. Awalan harus dimulai dengan huruf kecil.

Sintaksis TairConfig

"TairConfig": {
  "Storage": "Integer",
  "StorageType": "String",
  "ShardCount": "Integer"
}

Properti TairConfig

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Storage

Integer

Tidak

Tidak

Kapasitas penyimpanan disk cloud.

Kapasitas penyimpanan bervariasi berdasarkan spesifikasi instance. Untuk informasi lebih lanjut, lihat Instance berbasis ESSD/SSD.

StorageType

String

Tidak

Tidak

Tipe penyimpanan instance.

Nilai yang valid:

  • essd_pl0

  • essd_pl1

  • essd_pl2

  • essd_pl3

ShardCount

Integer

Tidak

Tidak

Jumlah shard data pada instance.

Nilai yang valid:

  • 1 (default): Instance menggunakan arsitektur standar yang hanya berisi satu shard data.

  • 2 hingga 32: Instance menggunakan arsitektur cluster yang berisi jumlah shard data tertentu.

Nilai Kembali

Fn::GetAtt

  • InstanceId: ID instance.

  • OrderId: ID pesanan instance.

  • ConnectionDomain: Titik akhir pribadi yang digunakan untuk mengakses instance.

  • Port: Nomor port yang digunakan oleh instance untuk menyediakan layanan.

  • InstanceName: Nama instance.

  • InstanceClass: Spesifikasi instance.

  • VpcId: ID VPC instance.

  • Capacity: Kapasitas penyimpanan instance.

  • InstanceType: Tipe mesin database.

  • ChargeType: Metode penagihan instance.

  • PackageType: Tipe paket instance.

  • Connections: Jumlah maksimum koneksi yang didukung oleh instance.

  • ArchitectureType: Tipe arsitektur instance.

  • NodeType: Tipe node instance.

  • HasRenewChangeOrder: Menunjukkan apakah instance memiliki pesanan pembaruan atau peningkatan sumber daya tertunda dalam akun Alibaba Cloud saat ini.

  • ResourceGroupId: ID grup sumber daya.

  • QPS: Queries per second (QPS) dari instance. Nilainya adalah QPS maksimum yang diharapkan.

  • ZoneId: ID zona instance.

  • Bandwidth: Bandwidth instance. Satuan: Mbit/s.

  • EngineVersion: Versi mesin database.

  • NetworkType: Tipe jaringan instance.

  • VSwitchId: ID vSwitch instance.

  • PrivateIp: Alamat IP pribadi instance.

  • PublicConnectionString: Awalan titik akhir publik yang digunakan untuk mengakses instance.

  • VpcPrivateConnectionPort: Nomor port yang digunakan untuk mengakses instance menggunakan titik akhir VPC.

  • ClassicInnerConnectionString: Awalan titik akhir jaringan klasik yang digunakan untuk mengakses instance.

  • VpcPrivateConnectionString: Awalan titik akhir VPC yang digunakan untuk mengakses instance.

  • PublicConnectionPort: Nomor port yang digunakan untuk mengakses instance menggunakan titik akhir publik.

  • DirectConnectionString: Awalan titik akhir pribadi yang digunakan untuk mengakses instance dalam mode koneksi langsung.

  • DirectConnectionPort: Nomor port yang digunakan untuk mengakses instance menggunakan titik akhir pribadi dalam mode koneksi langsung.

  • ClassicInnerConnectionPort: Nomor port yang digunakan untuk mengakses instance menggunakan titik akhir jaringan klasik.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Description: {}
Parameters:
  VpcId:
    Type: String
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
  ZoneId:
    Type: String
    Description:
      en: Sebelum Anda membuat instance, konfirmasikan bahwa Availability Zone mendukung spesifikasi sumber daya Redis.
    AssociationProperty: ALIYUN::ECS::Instance:ZoneId
    Label:
      en: Zone ID
  VSwitchId:
    Type: String
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    AssociationPropertyMetadata:
      VpcId: ${VpcId}
      ZoneId: ${ZoneId}
Resources:
  RedisInstance:
    Type: ALIYUN::REDIS::Instance
    Properties:
      VpcId:
        Ref: VpcId
      VSwitchId:
        Ref: VSwitchId
      InstanceClass: redis.master.small.default
      EvictionPolicy: noeviction
      ZoneId:
        Ref: ZoneId
      InstanceName: DefaultRedis
      Password: Admin@123!
Outputs:
  InstanceId:
    Value:
      Fn::GetAtt:
        - RedisInstance
        - InstanceId                     
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": {
  },
  "Parameters": {
    "VpcId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
    },
    "ZoneId": {
      "Type": "String",
      "Description": {
        "en": "Sebelum Anda membuat instance, konfirmasikan bahwa Availability Zone mendukung spesifikasi sumber daya Redis."
      },
      "AssociationProperty": "ALIYUN::ECS::Instance:ZoneId",
      "Label": {
        "en": "Zone ID",
      }
    },
    "VSwitchId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "VpcId": "${VpcId}",
        "ZoneId": "${ZoneId}"
      }
    }
  },
  "Resources": {
    "RedisInstance": {
      "Type": "ALIYUN::REDIS::Instance",
      "Properties": {
        "VpcId": {
          "Ref": "VpcId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "InstanceClass": "redis.master.small.default",
        "EvictionPolicy": "noeviction",
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "InstanceName": "DefaultRedis",
        "Password": "Admin@123!"
      }
    }
  },
  "Outputs": {
    "InstanceId": {
      "Value": {
        "Fn::GetAtt": [
          "RedisInstance",
          "InstanceId"
        ]
      }
    }
  }
}

Untuk lebih banyak contoh, kunjungi instance.yml. Dalam contoh tersebut, jenis sumber daya berikut digunakan: ALIYUN::REDIS::Instance, ALIYUN::REDIS::Whitelist, dan ALIYUN::REDIS::Account.