全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::KAFKA::Topic

更新时间:Jun 26, 2025

ALIYUN::KAFKA::Topic digunakan untuk membuat topik.

Sintaks

{
  "Type": "ALIYUN::KAFKA::Topic",
  "Properties": {
    "InstanceId": String,
    "Topic": String,
    "Remark": String,
    "PartitionNum": Integer,
    "ReplicationFactor": Integer,
    "LocalTopic": Boolean,
    "CompactTopic": Boolean,
    "Config": Map,
    "MinInsyncReplicas": Integer,
    "Tags": List
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

InstanceId

String

Ya

Tidak

ID dari instance.

Tidak ada.

Topic

String

Ya

Tidak

Nama dari topik.

Nama harus memiliki panjang 3 hingga 64 karakter, dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-).

Catatan

Nama tidak dapat diubah setelah topik dibuat.

Remark

String

Ya

Tidak

Deskripsi dari topik.

Deskripsi harus memiliki panjang 3 hingga 64 karakter, dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-).

PartitionNum

Integer

Tidak

Tidak

Jumlah partisi dalam topik.

Nilai valid: 1 hingga 48.

Untuk mengurangi risiko skew data, kami menyarankan Anda mengatur jumlah partisi menjadi kelipatan 6.

ReplicationFactor

Integer

Tidak

Tidak

Jumlah replika dari topik.

Properti ini valid jika properti LocalTopic disetel ke true.

Nilai valid: 1 hingga 3.

Catatan

Jika Anda menyetel properti ini ke 1, risiko kehilangan data meningkat. Lanjutkan dengan hati-hati.

LocalTopic

Boolean

Tidak

Tidak

Menentukan apakah topik menggunakan penyimpanan lokal.

Nilai valid:

  • false: Topik menggunakan penyimpanan cloud.

  • true: Topik menggunakan penyimpanan lokal.

CompactTopic

Boolean

Tidak

Tidak

Menentukan apakah topik menggunakan kebijakan kompaksi log.

Properti ini valid jika properti LocalTopic disetel ke true.

Nilai valid:

  • false: Topik menggunakan kebijakan pembersihan pesan. Jika sistem memiliki ruang disk yang cukup, pesan akan disimpan selama periode retensi maksimum. Sistem menganggap ruang disk tidak mencukupi jika penggunaan disk melebihi 85%. Jika ruang disk tidak mencukupi, sistem menghapus pesan mulai dari pesan tersimpan paling awal untuk memastikan ketersediaan layanan.

  • true: Topik menggunakan kebijakan kompaksi log. Jika pesan berbeda memiliki kunci yang sama, pesan dengan nilai kunci terbaru akan dipertahankan.

Config

Map

Tidak

Tidak

Konfigurasi tambahan.

Properti ini valid jika properti LocalTopic disetel ke true.

Contoh nilai: {"replications": 3}. Contoh nilai tersebut menunjukkan bahwa jumlah replika topik adalah 3. Nilai bidang replications berkisar antara 1 hingga 3.

MinInsyncReplicas

Integer

Tidak

Tidak

Jumlah minimum replika sinkron (ISRs).

Properti ini valid jika properti LocalTopic disetel ke true.

Nilai valid: 1 hingga 3. Nilai harus lebih kecil dari jumlah replika topik.

Tags

List

Tidak

Ya

Tag dari topik.

Untuk informasi lebih lanjut, lihat Properti Tags.

Sintaks Tags

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

Properti Tags

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Key

String

Ya

Tidak

Kunci dari tag.

Kunci tag harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Kunci tag tidak boleh dimulai dengan aliyun atau acs:.

Value

String

Tidak

Tidak

Nilai dari tag.

Nilai tag harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Nilai tag tidak boleh dimulai dengan aliyun atau acs:.

Nilai Pengembalian

Fn::GetAtt

  • InstanceId: ID dari instance.

  • Topic: Nama dari topik.

  • Arn: Nama Sumber Daya Alibaba Cloud (ARN).

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Description: Test create Kafka Topic
Parameters:
  InstanceId:
    Type: String
    Description: Kafka Instance Id
    Default: alikafka_****
  Topic:
    Type: String
    Description: |-
      Nama dari topik. Nilai parameter ini harus memenuhi persyaratan berikut:
      Nama hanya dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).
      Nama harus memiliki panjang 3 hingga 64 karakter, dan akan secara otomatis dipotong
      jika mengandung lebih banyak karakter.
      Nama tidak dapat diubah setelah dibuat.
    Default: myTopic
  Remark:
    Type: String
    Description: |-
      Deskripsi dari topik. Nilai parameter ini harus memenuhi persyaratan berikut:
      Nilai hanya dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).
      Nilai harus memiliki panjang 3 hingga 64 karakter.
    Default: test
Resources:
  Topic:
    Type: ALIYUN::KAFKA::Topic
    Properties:
      InstanceId:
        Ref: InstanceId
      Topic:
        Ref: TopicName
      Remark:
        Ref: Remark
Outputs:
  TopicName:
    Value:
      Fn::GetAtt:
        - Topic
        - Topic
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test create Kafka Topic",
  "Parameters": {
    "InstanceId": {
      "Type": "String",
      "Description": "Kafka Instance Id",
      "Default": "alikafka_****"
    },
    "Topic": {
      "Type": "String",
      "Description": "Nama dari topik. Nilai parameter ini harus memenuhi persyaratan berikut:\nNama hanya dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).\nNama harus memiliki panjang 3 hingga 64 karakter, dan akan secara otomatis dipotong\njika mengandung lebih banyak karakter.\nNama tidak dapat diubah setelah dibuat.",
      "Default": "myTopic"
    },
    "Remark": {
      "Type": "String",
      "Description": "Deskripsi dari topik. Nilai parameter ini harus memenuhi persyaratan berikut:\nNilai hanya dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).\nNilai harus memiliki panjang 3 hingga 64 karakter.",
      "Default": "test"
    }
  },
  "Resources": {
    "Topic": {
      "Type": "ALIYUN::KAFKA::Topic",
      "Properties": {
        "InstanceId": {
          "Ref": "InstanceId"
        },
        "Topic": {
          "Ref": "TopicName"
        },
        "Remark": {
          "Ref": "Remark"
        }
      }
    }
  },
  "Outputs": {
    "TopicName": {
      "Value": {
        "Fn::GetAtt": [
          "Topic",
          "Topic"
        ]
      }
    }
  }
}