All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::ROCKETMQ5::Instance

Last Updated:Feb 27, 2026

Tipe resource ALIYUN::ROCKETMQ5::Instance digunakan untuk membuat instans ApsaraMQ for RocketMQ 5.0.

Sintaks

{
  "Type": "ALIYUN::ROCKETMQ5::Instance",
  "Properties": {
    "AutoRenewPeriod": Integer,
    "ProductInfo": Map,
    "ResourceGroupId": String,
    "AutoRenew": Boolean,
    "Period": Integer,
    "InternetInfo": Map,
    "SubSeriesCode": String,
    "Remark": String,
    "InstanceName": String,
    "SeriesCode": String,
    "PaymentType": String,
    "VpcInfo": Map,
    "PeriodUnit": String
  }
}

Properti

Property Name

Type

Required

Update allowed

Description

Constraints

InternetInfo

Map

Yes

Yes

Konfigurasi jaringan publik.

Untuk informasi selengkapnya, lihat properti InternetInfo.

ProductInfo

Map

Yes

Yes

Spesifikasi instans.

Untuk informasi selengkapnya, lihat properti ProductInfo.

SeriesCode

String

Yes

No

Kode seri utama instans.

Nilai yang valid:

  • standard: Standard Edition

  • ultimate: Platinum Edition

  • professional: Professional Edition

Catatan

Setelah instans dibuat, Anda hanya dapat melakukan upgrade seri utamanya. Anda tidak dapat menurunkan spesifikasinya. Jalur upgrade-nya adalah: Standard Edition > Professional Edition > Platinum Edition. Misalnya, Anda dapat meng-upgrade instans dari Standard Edition ke Professional Edition, tetapi tidak dapat menurunkan instans dari Professional Edition ke Standard Edition.

SubSeriesCode

String

Yes

No

Kode sub-seri instans.

Nilai yang valid:

  • cluster_ha: High-availability Cluster Edition. Jika Anda mengatur seri utama ke `ultimate` (Platinum Edition), Anda harus mengatur sub-seri ke `cluster_ha` (High-availability Cluster Edition).

  • single_node: Single-node Edition untuk pengujian.

  • serverless: Instans serverless

Catatan

Setelah instans dibuat, Anda tidak dapat mengubah sub-serinya.

VpcInfo

Map

Yes

No

Konfigurasi VPC.

Untuk informasi selengkapnya, lihat properti VpcInfo.

AutoRenew

Boolean

No

No

Menentukan apakah akan mengaktifkan perpanjangan otomatis.

Parameter ini hanya berlaku jika metode penagihan instans adalah `Subscription`.

Nilai yang valid:

  • true: Mengaktifkan perpanjangan otomatis.

  • false: Menonaktifkan perpanjangan otomatis.

AutoRenewPeriod

Integer

No

No

Periode perpanjangan otomatis.

Parameter ini hanya berlaku jika perpanjangan otomatis diaktifkan.

Unit: bulan.

Nilai yang valid:

Untuk perpanjangan bulanan: 1, 2, 3, 6, dan 12.

InstanceName

String

No

Yes

Nama instans yang akan dibuat.

Jika Anda tidak menentukan parameter ini, ID instans akan digunakan sebagai nama instans.

PaymentType

String

No

No

Metode penagihan instans.

Nilai yang valid:

  • PayAsYouGo: Metode penagihan bayar sesuai pemakaian di mana Anda ditagih berdasarkan sumber daya yang digunakan.

  • Subscription: Metode penagihan langganan di mana Anda membayar di muka.

Period

Integer

No

No

Durasi langganan.

Parameter ini hanya berlaku jika metode penagihan instans adalah `Subscription`.

Nilai yang valid:

  • Jika Anda membeli per bulan: 1, 2, 3, 4, 5, dan 6.

  • Jika Anda membeli per tahun: 1, 2, dan 3.

PeriodUnit

String

No

No

Unit durasi langganan terkecil.

Nilai yang valid:

  • Month: Durasi langganan diukur dalam bulan.

  • Year: Durasi langganan diukur dalam tahun.

Remark

String

No

Yes

Keterangan pada instance.

None

ResourceGroupId

String

No

No

ID kelompok sumber daya.

None

Sintaks ProductInfo

"ProductInfo": {
  "SendReceiveRatio": Number,
  "MessageRetentionTime": Integer,
  "AutoScaling": Boolean,
  "MsgProcessSpec": String,
  "ProvisionedCapacity": Integer,
  "CapacityType": String
}

Properti ProductInfo

Property Name

Type

Required

Update allowed

Description

Constraints

MsgProcessSpec

String

Yes

No

Spesifikasi komputasi untuk pengiriman dan penerimaan pesan.

None

AutoScaling

Boolean

No

No

Menentukan apakah akan mengaktifkan burst scaling di luar spesifikasi dasar.

Nilai yang valid:

  • true: Mengaktifkan burst scaling.

  • false: Menonaktifkan burst scaling.

Setelah Anda mengaktifkan burst scaling, ApsaraMQ for RocketMQ memungkinkan instans melebihi batas TPS dari spesifikasi dasarnya dalam rentang tertentu. Anda akan dikenai biaya atas traffic yang melebihi spesifikasi dasar tersebut.

Catatan

Hanya beberapa tipe instans yang mendukung burst scaling.

CapacityType

String

No

No

Mode kapasitas.

Nilai yang valid:

  • provisioned: provisioned + flexible

  • ondemand: pay-as-you-go

MessageRetentionTime

Integer

No

Yes

Periode retensi pesan.

Unit: jam.

ApsaraMQ for RocketMQ 5.0 menyediakan penyimpanan serverless dan elastis. Anda dikenai biaya berdasarkan penyimpanan aktual yang digunakan. Anda dapat menyesuaikan periode retensi pesan untuk mengontrol kapasitas penyimpanan Anda.

ProvisionedCapacity

Integer

No

No

Kapasitas yang diprovisikan.

None

SendReceiveRatio

Number

No

Yes

Rasio pengiriman pesan terhadap penerimaan.

Nilainya harus berada di antara 0,2 dan 0,5.

Sintaks InternetInfo

"InternetInfo": {
  "IpWhitelist": List,
  "InternetSpec": String,
  "FlowOutBandwidth": Integer,
  "FlowOutType": String
}

Properti InternetInfo

Property Name

Type

Required

Update allowed

Description

Constraints

InternetSpec

String

Yes

Yes

Menentukan apakah akan mengaktifkan akses jaringan publik.

Nilai yang valid:

  • enable: Mengaktifkan akses jaringan publik.

  • disable: Menonaktifkan akses jaringan publik.

Secara default, instans diakses melalui VPC. Jika Anda mengaktifkan akses jaringan publik, Anda akan dikenai biaya atas bandwidth publik keluar.

FlowOutBandwidth

Integer

No

Yes

Spesifikasi bandwidth publik

Unit: Mbps.

Parameter ini wajib hanya ketika tipe penagihan jaringan publik adalah pay-by-bandwidth.

Nilai yang valid: 1 hingga 1000.

FlowOutType

String

No

No

Tipe penagihan jaringan publik.

Nilai yang valid:

  • payByBandwidth: pay-by-bandwidth. Atur parameter ke nilai ini ketika akses jaringan publik diaktifkan.

  • uninvolved: tidak berlaku. Atur parameter ke nilai ini ketika akses jaringan publik dinonaktifkan.

IpWhitelist

List

No

Yes

Daftar putih alamat IP untuk akses jaringan publik.

Anda hanya dapat mengonfigurasi daftar putih alamat IP untuk titik akhir publik. Titik akhir VPC tidak didukung.

  • Jika Anda tidak mengonfigurasi daftar putih, semua alamat IP dapat mengakses server ApsaraMQ for RocketMQ 5.0 melalui jaringan publik secara default.

  • Jika Anda mengonfigurasi daftar putih, hanya alamat IP dalam daftar putih yang dapat mengakses server ApsaraMQ for RocketMQ 5.0 melalui jaringan publik.

Sintaks VpcInfo

"VpcInfo": {
  "VpcId": String,
  "VSwitchId": String,
  "SecurityGroupId": String,
  "VSwitchIds": List
}

Properti VpcInfo

Property Name

Type

Required

Update allowed

Description

Constraints

VpcId

String

Yes

No

ID VPC tempat instans berada.

Catatan

Setelah instans ApsaraMQ for RocketMQ 5.0 dibuat, Anda tidak dapat mengubah VPC-nya. Untuk mengganti VPC, Anda harus merilis instans tersebut dan membeli yang baru.

SecurityGroupId

String

No

No

ID grup keamanan tempat instans berada.

None

VSwitchId

String

No

No

ID vSwitch tempat instans terhubung.

Catatan

Setelah instans ApsaraMQ for RocketMQ 5.0 dibuat, Anda tidak dapat mengubah vSwitch-nya. Untuk mengganti vSwitch, Anda harus merilis instans tersebut dan membeli yang baru.

VSwitchIds

List

No

No

Daftar ID vSwitch tempat instans terhubung.

None

Nilai kembalian

Fn::GetAtt

  • InstanceName: Nama instans.

  • VpcEndpoint: Nama domain VPC.

  • InstanceId: ID instans.

  • InternetEndpoint: Titik akhir publik instans.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  VpcId:
    Type: String
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
  VSwitchId:
    Type: String
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    AssociationPropertyMetadata:
      VpcId: ${VpcId}
Resources:
  Instance:
    Type: ALIYUN::ROCKETMQ5::Instance
    Properties:
      ProductInfo:
        MsgProcessSpec: rmq.s2.2xlarge
        SendReceiveRatio: 0.2
        MessageRetentionTime: 72
      InternetInfo:
        InternetSpec: disable
        FlowOutBandwidth: uninvolved
      SubSeriesCode: cluster_ha
      SeriesCode: standard
      PaymentType: PayAsYouGo
      VpcInfo:
        VpcId:
          Ref: VpcId
        VSwitchId:
          Ref: VSwitchId
Outputs:
  InstanceName:
    Description: Instance name.
    Value:
      Fn::GetAtt:
        - Instance
        - InstanceName
  VpcEndpoint:
    Description: VPC endpoint.
    Value:
      Fn::GetAtt:
        - Instance
        - VpcEndpoint
  InstanceId:
    Description: Instance ID created.
    Value:
      Fn::GetAtt:
        - Instance
        - InstanceId
  InternetEndpoint:
    Description: Internet endpoint.
    Value:
      Fn::GetAtt:
        - Instance
        - InternetEndpoint
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "VpcId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
    },
    "VSwitchId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "VpcId": "${VpcId}"
      }
    }
  },
  "Resources": {
    "Instance": {
      "Type": "ALIYUN::ROCKETMQ5::Instance",
      "Properties": {
        "ProductInfo": {
          "MsgProcessSpec": "rmq.s2.2xlarge",
          "SendReceiveRatio": 0.2,
          "MessageRetentionTime": 72
        },
        "InternetInfo": {
          "InternetSpec": "disable",
          "FlowOutBandwidth": "uninvolved"
        },
        "SubSeriesCode": "cluster_ha",
        "SeriesCode": "standard",
        "PaymentType": "PayAsYouGo",
        "VpcInfo": {
          "VpcId": {
            "Ref": "VpcId"
          },
          "VSwitchId": {
            "Ref": "VSwitchId"
          }
        }
      }
    }
  },
  "Outputs": {
    "InstanceName": {
      "Description": "Instance name.",
      "Value": {
        "Fn::GetAtt": [
          "Instance",
          "InstanceName"
        ]
      }
    },
    "VpcEndpoint": {
      "Description": "VPC endpoint.",
      "Value": {
        "Fn::GetAtt": [
          "Instance",
          "VpcEndpoint"
        ]
      }
    },
    "InstanceId": {
      "Description": "Instance ID created.",
      "Value": {
        "Fn::GetAtt": [
          "Instance",
          "InstanceId"
        ]
      }
    },
    "InternetEndpoint": {
      "Description": "Internet endpoint.",
      "Value": {
        "Fn::GetAtt": [
          "Instance",
          "InternetEndpoint"
        ]
      }
    }
  }
}