全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::ElasticSearch::Instance

更新时间:Jan 08, 2026

Resource ALIYUN::ElasticSearch::Instance digunakan untuk membuat instans Elasticsearch.

Sintaksis

{
  "Type": "ALIYUN::ElasticSearch::Instance",
  "Properties": {
    "KibanaWhitelist": List,
    "PublicWhitelist": List,
    "VSwitchId": String,
    "InstanceChargeType": String,
    "Period": Integer,
    "Version": String,
    "DataNode": Map,
    "PrivateWhitelist": List,
    "ResourceGroupId": String,
    "EnablePublic": Boolean,
    "Password": String,
    "MasterNode": Map,
    "Tags": List,
    "Description": String,
    "EnableKibanaPublic": Boolean,
    "YMLConfig": Map,
    "EnableKibanaPrivate": Boolean,
    "ZoneCount": Integer,
    "KibanaNode": Map,
    "ZoneId": String,
    "PeriodUnit": String,
    "InstanceCategory": String,
    "DeleteType": String
  }
}

Properti

Nama Properti

Type

Diperlukan

Pembaruan diizinkan

Deskripsi

Batasan

DataNode

Map

Ya

Ya

Pengaturan node data kluster Elasticsearch.

Untuk informasi selengkapnya, lihat properti DataNode.

Password

String

Ya

Ya

Password instans.

Password harus terdiri dari 8 hingga 32 karakter dan mengandung minimal tiga dari jenis karakter berikut: huruf kapital, huruf kecil, angka, dan karakter khusus. Karakter khusus yang didukung adalah: !@#$%&*()_+-=.

VSwitchId

String

Ya

Tidak

ID vSwitch.

Tidak ada

Version

String

Ya

Tidak

Versi Elasticsearch.

Nilai valid:

  • 7.10_with_X-Pack

  • 6.7_with_X-Pack

  • 6.7_with_X-Pack

  • 7.7_with_X-Pack

  • 6.8_with_X-Pack

  • 6.3_with_X-Pack

  • 5.6_with_X-Pack

  • 5.5.3_with_X-Pack

Description

String

Tidak

Ya

Deskripsi instans.

Deskripsi harus terdiri dari 0 hingga 30 karakter. Deskripsi harus dimulai dengan huruf, angka, atau karakter Tionghoa. Deskripsi dapat berisi huruf, angka, karakter Tionghoa, garis bawah (_), dan tanda hubung (-).

DeleteType

String

Tidak

Tidak

Jenis rilis.

Nilai yang valid:

  • immediate: Kluster langsung dihapus setelah dirilis. Setelah kluster dihapus, data yang tersimpan dalam kluster tersebut juga dihapus dan sistem menghapus kluster dari daftar kluster Logstash.

  • protective (default): Data hanya akan dihapus sepenuhnya setelah instans dibekukan selama 24 jam. Selama periode ini, instans tetap ditampilkan dalam daftar instans. Anda dapat melanjutkan instans atau segera merilisnya.

EnableKibanaPublic

Boolean

Tidak

Tidak

Menentukan apakah akses jaringan publik untuk Kibana diaktifkan.

Nilai valid:

  • true: Diaktifkan.

  • false (default): Fitur dinonaktifkan.

KibanaWhitelist

List

Tidak

Ya

Daftar putih alamat IP Kibana.

Tidak ada

PublicWhitelist

List

Tidak

Ya

Daftar putih alamat IP publik instans.

Tidak ada

InstanceChargeType

String

Tidak

Tidak

Metode penagihan instans.

Nilai valid:

  • PrePaid: subscription.

  • PostPaid (pay-as-you-go)

Period

Integer

Tidak

Tidak

Durasi langganan instans Elasticsearch.

Nilai valid:

  • 1 (default)

  • 2

  • 3

  • 4

  • 5

  • 6

  • 7

  • 8

  • 9

  • 12

  • 24

  • 36

Unit: bulan.

ResourceGroupId

String

Tidak

Ya

ID grup sumber daya.

Tidak ada

EnablePublic

Boolean

Tidak

Ya

Menentukan apakah titik akhir publik instans diaktifkan.

Nilai valid:

  • true: Diaktifkan.

  • false (default): Fitur dinonaktifkan.

PrivateWhitelist

List

Tidak

Ya

Daftar putih alamat IP untuk mengakses instans dalam virtual private cloud (VPC).

Tidak ada

MasterNode

Map

Tidak

Ya

Pengaturan node master.

Jika Anda menentukan parameter ini, node master khusus akan dibuat.

Untuk informasi lebih lanjut, lihat Properti MasterNode.

Tags

List

Tidak

Ya

Tag.

Anda dapat menambahkan hingga 20 tag.

Untuk informasi lebih lanjut, lihat Properti Tags.

YMLConfig

Map

Tidak

Tidak

Konfigurasi file YAML.

Untuk informasi lebih lanjut, lihat Properti YMLConfig.

EnableKibanaPrivate

Boolean

Tidak

Tidak

Menentukan apakah akses jaringan pribadi untuk Kibana diaktifkan.

Nilai valid:

  • true: Fungsionalitas diaktifkan.

  • false (default): Fitur dinonaktifkan.

ZoneCount

Integer

Tidak

Tidak

Jumlah zona tempat instans ditempatkan.

Nilai valid:

  • 1 (default)

  • 2

  • 3

KibanaNode

Map

Tidak

Tidak

Pengaturan node Kibana khusus.

Tidak ada

ZoneId

String

Tidak

Tidak

ID zona.

Tidak ada

PeriodUnit

String

Tidak

Tidak

Unit durasi langganan.

Nilai valid:

  • Month: Bulan kalender.

  • Year:

InstanceCategory

String

Tidak

Tidak

Jenis versi instans.

Nilai valid:

  • x-pack: Membuat instans Edisi Komersial atau instans Edisi Kernel-enhanced yang memiliki Indexing Service dan OpenStore dinonaktifkan.

  • IS: Membuat instans Edisi Kernel-enhanced yang memiliki Indexing Service atau OpenStore diaktifkan.

Sintaksis DataNode

"DataNode": {
  "Amount": Integer,
  "DiskSize": Integer,
  "Spec": String,
  "DiskType": String,
  "DiskEncryption": Boolean,
  "PerformanceLevel": String
}

Properti DataNode

Nama Properti

Tipe

Diperlukan

Pembaruan diizinkan

Deskripsi

Batasan

Amount

Integer

Ya

Ya

Jumlah node data dalam kluster Elasticsearch.

Nilai valid: 2 hingga 50.

DiskSize

Integer

Ya

Ya

Storage space dari satu node data.

Nilai yang valid:

  • Jika Anda mengatur DiskType ke cloud_ssd: 20 hingga 6144.

  • Jika Anda mengatur DiskType ke cloud_efficiency: 20 hingga 20480. Jika Anda ingin menyimpan lebih dari 2.048 GB data, hanya nilai-nilai berikut yang didukung untuk parameter ini:

    • 2560

    • 3072

    • 3584

    • 4096

    • 4608

    • 5120

    • 5632

    • 6144

    • 8192

    • 10240

    • 12288

    • 14336

    • 16384

    • 18432

    • 20480

    Catatan

    Jika Anda ingin menyimpan lebih dari 5.120 GB data, versi Elasticsearch harus 6.7 atau 7.X, atau instans harus merupakan Edisi Lanjutan.

  • Jika Anda mengatur DiskType ke cloud_essd: 20 hingga 6144.

Satuan: GB.

Spec

String

Ya

Ya

Spesifikasi node data instans Elasticsearch.

Spesifikasi node elastis. Untuk informasi selengkapnya tentang spesifikasi, lihat Spesifikasi node.

DiskType

String

Ya

Ya

Tipe disk node data.

Nilai valid:

  • cloud_ssd: SSD standar. Tipe disk ini cocok untuk skenario analisis dan pencarian online yang memerlukan IOPS tinggi dan responsivitas data tinggi.

  • cloud_efficiency: disk ultra. Tipe disk ini menyediakan penyimpanan hemat biaya dan cocok untuk skenario log dan analisis yang melibatkan volume data besar.

  • cloud_essd: SSD Perusahaan (ESSD). Tipe disk ini memiliki latensi rendah, respons cepat, dan throughput tinggi. Cocok untuk aplikasi yang sensitif terhadap latensi atau skenario bisnis yang intensif I/O.

DiskEncryption

Boolean

Tidak

Tidak

Menentukan apakah akan mengaktifkan enkripsi disk.

Nilai valid:

  • true: Menunjukkan status diaktifkan.

  • false (default): Menonaktifkan pengaturan.

PerformanceLevel

String

Tidak

Tidak

Tingkat kinerja (PL) SSD Perusahaan.

Parameter ini wajib jika Anda mengatur DiskType ke cloud_essd. Nilai yang valid:

  • PL1

  • PL2

  • PL3

Sintaksis MasterNode

"MasterNode": {
  "Amount": Integer,
  "DiskSize": Integer,
  "Spec": String,
  "DiskType": String
}

Properti MasterNode

Nama Properti

Tipe

Diperlukan

Pembaruan diizinkan

Deskripsi

Batasan

Spec

String

Ya

Tidak

Spesifikasi node master.

Spesifikasi node master khusus. Untuk informasi selengkapnya tentang spesifikasi, lihat Spesifikasi node.

Amount

Integer

Tidak

Ya

Jumlah node master.

Nilai default: 3.

DiskSize

Integer

Tidak

Tidak

Disk space node master.

Nilai default: 20.

DiskType

String

Tidak

Tidak

Tipe disk node master.

Nilai yang valid:

  • cloud_ssd: SSD standar

  • cloud_essd (default): SSD Perusahaan

Sintaksis Tags

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

Properti Tags

Nama Properti

Type

Diperlukan

Pembaruan diizinkan

Deskripsi

Batasan

Key

String

Ya

Tidak

Kunci tag.

Kunci dapat terdiri dari 1 hingga 128 karakter. Kunci tidak boleh dimulai dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.

Value

String

Tidak

Tidak

Nilai tag.

Nilai dapat terdiri dari 0 hingga 128 karakter. Nilai tidak boleh dimulai dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.

Sintaksis YMLConfig

"YMLConfig": {
    "CreateIndex": String,
    "Watcher": String,
    "DestructiveRequiresName": Boolean,
    "AuditLog": Boolean,
    "OtherConfigs": Map
  }

Properti YMLConfig

Nama Properti

Type

Diperlukan

Pembaruan diizinkan

Deskripsi

Batasan

AuditLog

Boolean

Tidak

Tidak

Menentukan apakah indeks log audit diaktifkan.

Nilai valid:

  • true: mengaktifkan indeks log audit. Jika Anda mengaktifkan indeks log audit, sistem mencatat log audit yang dihasilkan dari operasi seperti pembuatan, penghapusan, modifikasi, dan kueri instans Elasticsearch. Informasi log ini mengonsumsi disk space dan memengaruhi kinerja. Kami menyarankan agar Anda tidak mengaktifkan fitur ini. Gunakan konfigurasi ini dengan hati-hati.

    Untuk informasi selengkapnya, lihat Konfigurasi log audit.

  • false (default): Dinonaktifkan.

Catatan

Parameter ini tidak didukung untuk Elasticsearch versi 7.0 dan yang lebih baru.

CreateIndex

String

Tidak

Tidak

Menentukan apakah sistem diizinkan membuat indeks secara otomatis jika indeks yang sesuai tidak ada setelah instans Elasticsearch menerima file baru.

Item konfigurasi yang sesuai dalam file YAML adalah action.auto_create_index.

Nilai valid:

  • true: mengizinkan sistem membuat indeks secara otomatis.

  • false (default): tidak mengizinkan sistem membuat indeks secara otomatis.

DestructiveRequiresName

Boolean

Tidak

Tidak

Apakah saya harus menentukan nama indeks untuk menghapus indeks?

Item konfigurasi yang sesuai dalam file YAML adalah action.destructive_requires_name.

Nilai valid:

  • true (default): Anda harus secara eksplisit menentukan nama indeks saat menghapus indeks.

  • false: Anda tidak perlu secara eksplisit menentukan nama indeks saat menghapus indeks.

Catatan

Jika Anda mengizinkan penggunaan karakter wildcard untuk nama indeks saat menghapus atau menutup indeks, Anda dapat menggunakan karakter wildcard untuk menghapus indeks secara batch. Indeks yang dihapus tidak dapat dipulihkan. Gunakan konfigurasi ini dengan hati-hati.

OtherConfigs

Map

Tidak

Tidak

Konfigurasi lainnya.

Item konfigurasi berikut didukung. Kecuali dinyatakan lain, item konfigurasi ini kompatibel dengan Elasticsearch 5.x, 6.x, dan 7.x.

  • Konfigurasi akses CORS

    • http.cors.enabled

    • http.cors.allow-origin

    • http.cors.max-age

    • http.cors.allow-methods

    • http.cors.allow-headers

    • http.cors.allow-credentials

  • Konfigurasi daftar putih reindex

    • reindex.remote.whitelist

  • Konfigurasi log audit

    • xpack.security.audit.enabled

    • xpack.security.audit.index.bulk_size

    • xpack.security.audit.index.flush_interval

    • xpack.security.audit.index.rollover

    • xpack.security.audit.index.events.include

    • xpack.security.audit.index.events.exclude

    • xpack.security.audit.index.events.emit_request_body

  • Konfigurasikan ukuran antrian

    • thread_pool.bulk.queue_size (untuk Elasticsearch 5.x)

    • thread_pool.write.queue_size (untuk Elasticsearch 6.x dan 7.x)

    • thread_pool.search.queue_size

  • Konfigurasi plugin SQL kustom

    xpack.sql.enabled: Secara default, instans Elasticsearch menggunakan plugin SQL yang disertakan dalam X-Pack. Jika Anda ingin mengunggah plugin SQL kustom, atur xpack.sql.enabled ke false.

Watcher

Boolean

Tidak

Tidak

Menentukan apakah akan mengaktifkan Watcher.

Item konfigurasi yang sesuai dalam file YAML adalah xpack.watcher.enabled.

Nilai valid:

  • true: mengaktifkan Watcher. Setelah Anda mengaktifkan Watcher, Anda dapat menggunakan fitur Watcher dari X-Pack. Hapus secara berkala indeks .watcher-history* untuk mencegah indeks tersebut menghabiskan banyak disk space.

  • false (default): Dinonaktifkan.

Sintaksis KibanaNode

"KibanaNode": {
  "Spec": String
}

Properti KibanaNode

Nama Properti

Tipe

Diperlukan

Pembaruan diizinkan

Deskripsi

Batasan

Spec

String

Ya

Tidak

Spesifikasi node Kibana khusus.

Tidak ada

Nilai Pengembalian

Fn::GetAtt

  • Status: Status instans Elasticsearch.

  • KibanaDomain: Titik akhir Kibana.

  • PublicDomain: Titik akhir publik instans.

  • Domain: Titik akhir internal instans.

  • InstanceId: ID instans Elasticsearch.

  • KibanaPort: Port akses Kibana.

  • Port: Port koneksi instans.

  • VSwitchId: ID vSwitch.

  • Version: Versi instans.

  • InstanceChargeType: Metode penagihan instans.

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

Contoh

YAML format

ROSTemplateFormatVersion: '2015-09-01'
Description: Test ElasticSearch Instance
Parameters:
  VSwitchId:
    Type: String
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
Resources:
  Instance:
    Type: ALIYUN::ElasticSearch::Instance
    Properties:
      DataNode:
        Spec: elasticsearch.sn1ne.large
        Amount: 2
        DiskSize: 20
        DiskType: cloud_essd
      InstanceChargeType: PostPaid
      Version: 7.10_with_X-Pack
      VSwitchId:
        Ref: VSwitchId
      Password: Admin@123!
Outputs: {}                  

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test ElasticSearch Instance",
  "Parameters": {
    "VSwitchId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId"
    }
  },
  "Resources": {
    "Instance": {
      "Type": "ALIYUN::ElasticSearch::Instance",
      "Properties": {
        "DataNode": {
          "Spec": "elasticsearch.sn1ne.large",
          "Amount": 2,
          "DiskSize": 20,
          "DiskType": "cloud_essd"
        },
        "InstanceChargeType": "PostPaid",
        "Version": "7.10_with_X-Pack",
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "Password": "Admin@123!"
      }
    }
  },
  "Outputs": {
  }
}