全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::ROS::StackGroup

更新时间:Jun 26, 2025

ALIYUN::ROS::StackGroup digunakan untuk membuat grup tumpukan.

Sintaks

{
  "Type": "ALIYUN::ROS::StackGroup",
  "Properties": {
    "Description": String,
    "Parameters": Map,
    "ResourceGroupId": String,
    "DynamicTemplateBody": Map,
    "StackGroupName": String,
    "TemplateVersion": String,
    "AdministrationRoleName": String,
    "TemplateBody": Map,
    "TemplateURL": String,
    "AutoDeployment": Map,
    "PermissionModel": String,
    "ExecutionRoleName": String,
    "TemplateId": String
  }
}

Parameter

ParameterTipeDiperlukanDapat DieditDeskripsiKendala
DescriptionStringTidakTidakDeskripsi dari grup tumpukan. Deskripsi harus memiliki panjang antara 1 hingga 256 karakter.
ParametersMapTidakTidakDetail parameter. Tidak ada
ResourceGroupIdStringTidakTidakID grup sumber daya. Jika Anda tidak menentukan parameter ini, grup tumpukan akan ditambahkan ke grup sumber daya default.
DynamicTemplateBodyMapTidakTidakStruktur yang berisi badan template. Anda dapat menggunakan ekspresi fungsi yang disediakan oleh Resource Orchestration Service (ROS) untuk mendapatkan konten template.
StackGroupNameStringYaTidakNama grup tumpukan. Nama harus unik dalam suatu wilayah.

Nama dapat memiliki panjang hingga 255 karakter, dan dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dengan angka atau huruf.

TemplateVersionStringTidakTidakVersi template. Secara default, jika Anda tidak menentukan parameter ini, versi terbaru yang digunakan.
AdministrationRoleNameStringTidakTidakNama Peran RAM yang Anda tentukan untuk akun administrator di ROS saat Anda membuat grup tumpukan yang dikelola sendiri. Anda harus menentukan nama Peran RAM untuk akun administrator di ROS saat Anda membuat grup tumpukan yang dikelola sendiri.

Jika Anda tidak menentukan parameter ini, nilai default AliyunROSStackGroupAdministrationRole digunakan. Anda dapat menggunakan peran administrator di ROS untuk mengasumsikan peran eksekusi AliyunROSStackGroupExecutionRole untuk melakukan operasi pada tumpukan yang sesuai dengan instans tumpukan dalam grup tumpukan.

Nama harus memiliki panjang antara 1 hingga 64 karakter, dan dapat berisi huruf, angka, dan tanda hubung (-).

TemplateBodyMapTidakTidakStruktur yang berisi badan template. Badan template harus memiliki panjang antara 1 hingga 524.288 byte.

Jika panjang badan template melebihi batas atas, kami sarankan Anda menambahkan parameter ke badan permintaan HTTP POST untuk mencegah kegagalan permintaan yang disebabkan oleh URL yang terlalu panjang.

Catatan Anda hanya harus menentukan salah satu dari parameter TemplateBody, TemplateURL, dan TemplateId.
TemplateURLStringTidakTidakURL file yang berisi badan template.

URL harus menunjuk ke template pada server web atau di Bucket Object Storage Service (OSS). Badan template harus memiliki panjang antara 1 hingga 524.288 byte.

Contoh untuk URL OSS: oss://ros/template/demo dan oss://ros/template/demo?RegionId=cn-hangzhou.

Secara default, jika Anda tidak menentukan wilayah Bucket OSS, nilai parameter RegionId digunakan sebagai wilayah.
Catatan Anda hanya harus menentukan salah satu dari parameter TemplateBody, TemplateURL, dan TemplateId.
AutoDeploymentMapTidakTidakInformasi tentang pengaturan penyebaran otomatis. Untuk informasi lebih lanjut, lihat Parameter AutoDeployment
PermissionModelStringTidakTidakModel izin. Nilai valid:
  • SELF_MANAGED: model izin yang dikelola sendiri.

    Jika Anda membuat grup tumpukan yang dikelola sendiri, Anda harus membuat peran RAM untuk akun administrator dan akun eksekusi, serta membangun hubungan kepercayaan antar akun untuk menyebarkan tumpukan dalam akun eksekusi.

  • SERVICE_MANAGED: model izin yang dikelola layanan.

    Jika Anda membuat grup tumpukan yang dikelola layanan, ROS membuat peran terkait layanan untuk akun administrator dan akun eksekusi, dan akun administrator menggunakan perannya untuk menyebarkan tumpukan dalam akun eksekusi.

Catatan Jika Anda menggunakan model izin yang dikelola layanan untuk menyebarkan tumpukan, pastikan bahwa akun Anda adalah akun manajemen atau akun administrator yang didelegasikan dalam direktori sumber daya dan fitur akses tepercaya diaktifkan untuk akun tersebut. Untuk informasi lebih lanjut, lihat Langkah 1: (Opsional) Buat akun administrator yang didelegasikan dan Langkah 2: Aktifkan akses tepercaya.
ExecutionRoleNameStringTidakTidakNama Peran RAM yang Anda tentukan untuk akun eksekusi saat Anda membuat grup tumpukan yang dikelola sendiri. Anda harus menentukan nama Peran RAM untuk akun eksekusi saat Anda membuat grup tumpukan yang dikelola sendiri.

Jika Anda tidak menentukan parameter ini, nilai default AliyunROSStackGroupExecutionRole digunakan. Anda dapat menggunakan peran ini di ROS untuk melakukan operasi pada tumpukan yang sesuai dengan instans tumpukan dalam grup tumpukan.

Nama harus memiliki panjang antara 1 hingga 64 karakter, dan dapat berisi huruf, angka, dan tanda hubung (-).

TemplateIdStringTidakTidakID template. Parameter ini berlaku untuk template bersama dan pribadi.
Catatan Anda hanya harus menentukan salah satu dari parameter TemplateBody, TemplateURL, dan TemplateId.

Sintaks AutoDeployment

"AutoDeployment": {
  "Enabled": Boolean,
  "RetainStacksOnAccountRemoval": Boolean
}

Parameter AutoDeployment

ParameterTipeDiperlukanDapat DieditDeskripsiKendala
EnabledBooleanYaTidakMenentukan apakah akan mengaktifkan penyebaran otomatis. Nilai valid:
  • true: mengaktifkan penyebaran otomatis.

    Jika Anda menambahkan anggota ke folder tempat grup tumpukan milik setelah mengaktifkan penyebaran otomatis, ROS menyebarkan instans tumpukan dalam grup tumpukan di anggota ini.

    Jika Anda menghapus anggota dari folder, grup tumpukan menghapus instans tumpukan di anggota ini.

  • false: menonaktifkan penyebaran otomatis.

    Setelah Anda menonaktifkan penyebaran otomatis, instans tumpukan tetap tidak berubah jika Anda mengubah anggota dalam folder.

RetainStacksOnAccountRemovalBooleanTidakTidakMenentukan apakah akan mempertahankan tumpukan di anggota jika Anda menghapus anggota dari folder. Nilai valid:
  • true: mempertahankan tumpukan.
  • false: menghapus tumpukan.
Catatan Anda harus menentukan parameter ini jika parameter Enabled diatur ke true.

Parameter respons

Fn::GetAtt

StackGroupId: ID grup tumpukan.

Contoh

JSON Format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "StackGroupName": {
      "Type": "String"
    },
    "TemplateId": {
      "Type": "String"
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ROS::StackGroup",
      "Properties": {
        "StackGroupName": {
          "Ref": "StackGroupName"
        },
        "TemplateId": {
          "Ref": "TemplateId"
        }
      }
    }
  },
  "Outputs": {
    "StackGroupId": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "StackGroupId"
        ]
      }
    }
  }
}