All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::ROS::StackInstances

Last Updated:Jul 02, 2025

ALIYUN::ROS::StackInstances digunakan untuk membuat instans tumpukan di akun yang ditentukan dan wilayah yang dipilih.

Sintaksis

{
  "Type": "ALIYUN::ROS::StackInstances",
  "Properties": {
    "OperationPreferences": Map,
    "RetainStacks": Boolean,
    "RegionIds": List,
    "AccountIds": List,
    "ParameterOverrides": Map,
    "StackGroupName": String,
    "DeploymentTargets": Map,
    "OperationDescription": String,
    "DisableRollback": Boolean,
    "TimeoutInMinutes": Integer
  }
}

Properti

PropertiTipeDiperlukanDapat DieditDeskripsiKendala
OperationPreferencesMapTidakTidakPreferensi operasi untuk membuat instans tumpukan. Untuk informasi lebih lanjut, lihat Properti OperationPreferences.
Catatan
  • Anda dapat menentukan salah satu parameter MaxConcurrentCount dan MaxConcurrentPercentage, tetapi tidak keduanya.
  • Anda dapat menentukan salah satu parameter FailureToleranceCount dan FailureTolerancePercentage, tetapi tidak keduanya.
RetainStacksBooleanTidakTidakMenentukan apakah akan mempertahankan tumpukan saat instans tumpukan dihapus. Anda dapat menentukan apakah akan menghapus atau mempertahankan tumpukan yang terkait dengan instans tumpukan saat instans tumpukan dihapus. Nilai valid:
  • true: mempertahankan tumpukan yang relevan saat instans tumpukan dihapus.
  • false: menghapus tumpukan yang relevan saat instans tumpukan dihapus.
RegionIdsListYaTidakID wilayah tempat Anda ingin membuat instans tumpukan. Anda dapat menentukan maksimal 20 ID wilayah.
AccountIdsListTidakTidakID akun tempat Anda ingin menggunakan izin yang dikelola sendiri untuk menerapkan tumpukan. Anda dapat menentukan maksimal 20 ID akun.
ParameterOverridesMapTidakTidakParameter yang ingin Anda timpa. Tidak ada
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.

DeploymentTargetsMapTidakTidakFolder tempat Anda ingin menggunakan izin yang dikelola layanan untuk menerapkan tumpukan. Untuk informasi lebih lanjut, lihat Properti DeploymentTargets.
OperationDescriptionStringTidakTidakDeskripsi operasi untuk membuat instans tumpukan. Deskripsi harus memiliki panjang 1 hingga 256 karakter.
DisableRollbackBooleanTidakTidakMenentukan apakah akan mengaktifkan rollback yang dipicu ketika instans tumpukan gagal dibuat. Nilai valid:
  • true: menonaktifkan rollback.
  • false: mengaktifkan rollback. Ini adalah nilai default.
TimeoutInMinutesIntegerTidakTidakPeriode waktu habis untuk membuat instans tumpukan. Nilai default: 60.

Satuan: menit.

Sintaksis OperationPreferences

"OperationPreferences": {
  "MaxConcurrentPercentage": Integer,
  "MaxConcurrentCount": Integer,
  "FailureTolerancePercentage": Integer,
  "FailureToleranceCount": Integer
}

Properti OperationPreferences

PropertiTipeDiperlukanDapat DieditDeskripsiKendala
MaxConcurrentPercentageIntegerTidakTidakPersentase maksimum dari jumlah akun tempat operasi dapat dilakukan secara bersamaan pada tumpukan terhadap total jumlah akun di setiap wilayah.

Jika nilai numerik dalam persentase bukan bilangan bulat, Resource Orchestration Service (ROS) membulatkan angka ke bawah ke bilangan bulat terdekat.

Jika Anda tidak menyetel parameter MaxConcurrentPercentage, nilai default 1 digunakan.

Nilai valid: 1 hingga 100.
MaxConcurrentCountIntegerTidakTidakJumlah maksimum akun tempat operasi dapat dilakukan secara bersamaan pada tumpukan di setiap wilayah.

Jika Anda tidak menyetel parameter MaxConcurrentCount, nilai default 1 digunakan.

Nilai valid: 1 hingga 20.
FailureTolerancePercentageIntegerTidakTidakPersentase jumlah akun tempat kegagalan operasi tumpukan diperbolehkan terhadap total jumlah akun di setiap wilayah. Jika nilai tersebut dilampaui di suatu wilayah, ROS menghentikan operasi di wilayah tersebut.

Jika nilai numerik dalam persentase bukan bilangan bulat, ROS membulatkan angka ke bawah ke bilangan bulat terdekat.

Jika Anda tidak menyetel parameter FailureTolerancePercentage, nilai default 0 digunakan.

Nilai valid: 0 hingga 100.
FailureToleranceCountIntegerTidakTidakJumlah akun tempat kegagalan operasi tumpukan diperbolehkan di setiap wilayah. Jika nilai tersebut dilampaui di suatu wilayah, ROS menghentikan operasi di wilayah tersebut.

Jika ROS menghentikan operasi di satu wilayah, ROS juga menghentikan operasi di wilayah lainnya.

Jika Anda tidak menyetel parameter FailureToleranceCount, nilai default 0 digunakan.

Nilai valid: 0 hingga 100.

Sintaksis DeploymentTargets

"DeploymentTargets": {
  "RdFolderIds": List
}

Properti DeploymentTargets

PropertiTipeDiperlukanDapat DieditDeskripsiKendala
RdFolderIdsListTidakTidakID folder direktori sumber daya. Anda dapat menentukan maksimal lima ID folder.

Anda dapat membuat instans tumpukan di semua anggota yang terkandung dalam folder yang ditentukan.

Jika Anda menentukan folder Root, instans tumpukan dibuat di semua anggota dalam direktori sumber daya.

Catatan Untuk melihat ID folder, buka halaman Ikhtisar di konsol Manajemen Sumber Daya. Untuk informasi lebih lanjut, lihat Lihat informasi tentang folder.

Parameter respons

Fn::GetAtt

  • LastOperationId: ID operasi.
  • Stacks: detail tumpukan.

Contoh

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "RegionIds": {
      "Type": "Json"
    },
    "ParameterOverrides": {
      "Type": "Json"
    },
    "StackGroupName": {
      "Type": "String"
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ROS::StackInstances",
      "Properties": {
        "RegionIds": {
          "Ref": "RegionIds"
        },
        "ParameterOverrides": {
          "Ref": "ParameterOverrides"
        },
        "StackGroupName": {
          "Ref": "StackGroupName"
        }
      }
    }
  },
  "Outputs": {
    "LastOperationId": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "LastOperationId"
        ]
      }
    },
    "Stacks": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "Stacks"
        ]
      }
    }
  }
}