Resource Orchestration Service:ContinueCreateStack-Resource Orchestration Service-Alibaba Cloud - Resource Orchestration Service

Melanjutkan pembuatan stack setelah stack gagal dibuat.

Deskripsi operasi

This topic provides an example on how to continue to create a stack after the stack fails to be created. In this example, the stack whose ID is 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** is created in the China (Hangzhou) region.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ros:ContinueCreateStack

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
StackId	string	Yes	ID stack.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
RegionId	string	Yes	ID Wilayah stack. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
RamRoleName	string	No	Nama Peran RAM. Resource Orchestration Service (ROS) mengasumsikan Peran RAM untuk membuat stack dan menggunakan kredensial peran tersebut untuk memanggil API layanan Alibaba Cloud. ROS mengasumsikan Peran RAM untuk melakukan operasi pada stack. Jika Anda memiliki izin untuk melakukan operasi pada stack tetapi tidak memiliki izin untuk menggunakan Peran RAM, ROS tetap mengasumsikan Peran RAM. Anda harus memastikan bahwa Peran RAM diberikan hak istimewa minimum. Jika Anda tidak menentukan parameter ini, ROS mengasumsikan peran yang ada yang terkait dengan stack. Jika tidak ada peran yang tersedia, ROS menggunakan kredensial sementara yang dihasilkan dari kredensial akun Anda. Nama Peran RAM dapat memiliki panjang hingga 64 byte.	test-role
Mode	string	No	Mode ROS untuk melanjutkan pembuatan stack. Nilai valid: Recreate (default) Jika Anda menetapkan parameter ini ke Recreate, ROS hanya melanjutkan pembuatan tipe Sumber daya berikut: Sumber daya yang gagal dibuat Sumber daya yang Anda tentukan untuk RecreatingResources.N Dependensi dari Sumber daya yang Anda tentukan untuk RecreatingResources.N Sumber daya yang belum Anda buat Catatan RecreatingResources.N, TemplateBody, TemplateURL, dan Parameters berlaku hanya saat Mode disetel ke Recreate. Ignore ROS mengabaikan dan membuang Sumber daya yang gagal dibuat dan yang belum Anda buat, lalu menganggap stack berhasil dibuat. Badan templat yang Anda gunakan untuk membuat stack diubah. Catatan Mode ini hanya tersedia untuk stack ROS.	Recreate
TemplateBody	string	No	Struktur yang berisi badan templat. Badan templat harus memiliki panjang 1 hingga 524.288 byte. Jika panjang badan templat melebihi batas atas, kami sarankan Anda menambahkan parameter ke badan permintaan HTTP POST untuk mencegah kegagalan permintaan akibat URL yang terlalu panjang. Template ROS tunduk pada batasan berikut: Anda hanya dapat memodifikasi bagian berikut dalam templat: Description, Metadata, Resources, dan Outputs. Anda tidak dapat menambahkan atau menghapus bagian dalam templat. Bagian Resources tunduk pada batasan berikut: Anda tidak dapat menghapus Sumber daya atau mengubah badan templat untuk Sumber daya yang tidak ingin Anda lanjutkan pembuatannya. Anda dapat menghapus Sumber daya atau mengubah badan templat untuk Sumber daya yang ingin Anda lanjutkan pembuatannya. Anda dapat menambahkan Sumber daya ke bagian ini. Catatan Parameter ini berlaku hanya saat Mode disetel ke Recreate. Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId. Jika Anda tidak menentukan parameter, templat yang ada akan digunakan.	{"ROSTemplateFormatVersion": "2015-09-01"}
TemplateURL	string	No	URL file yang berisi badan templat. URL harus mengarah ke templat yang berada di server web HTTP atau HTTPS atau di Bucket OSS (Object Storage Service), seperti oss://ros/template/demo atau oss://ros/template/demo?RegionId=ap-southeast-1. Badan templat dapat memiliki panjang hingga 524.288 byte. Jika Anda tidak menentukan ID Wilayah dari Bucket OSS, nilai RegionId akan digunakan. Catatan Parameter ini berlaku hanya saat Mode disetel ke Recreate. Saat Anda menentukan TemplateURL templat, templat tersebut tunduk pada batasan yang dijelaskan untuk TemplateBody di topik ini. Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId. Jika Anda tidak menentukan parameter, templat yang ada akan digunakan.	oss://ros-template/demo
DryRun	boolean	No	Apakah hanya akan memvalidasi stack di permintaan. Nilai valid: true: hanya memvalidasi stack. false (default): memvalidasi dan melanjutkan pembuatan stack.	false
TemplateId	string	No	ID templat. Parameter ini berlaku untuk templat bersama dan privat. Catatan Parameter ini berlaku saat `Mode` disetel ke `Recreate`. Saat Anda menentukan TemplateId templat, templat tersebut tunduk pada batasan yang dijelaskan untuk `TemplateBody` di topik ini. Anda hanya dapat menentukan salah satu dari parameter berikut: `TemplateBody`, `TemplateURL`, dan `TemplateId`. Jika Anda tidak menentukan parameter, templat yang ada akan digunakan.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	No	Versi templat. Parameter ini berlaku hanya saat TemplateId ditentukan.	v1
RecreatingResources	array	No	Sumber daya yang dilanjutkan pembuatannya oleh ROS setelah Sumber daya tersebut gagal dibuat. Anda dapat menambahkan Sumber daya baru ke Sumber daya yang dilanjutkan pembuatannya oleh ROS. ROS melanjutkan pembuatan semua dependensi Sumber daya baru tersebut. Catatan Parameter ini hanya tersedia untuk stack ROS.	WebServer
	string	No	The resource that ROS continues to create after the resource failed to be created. You can add new resources to the resources that ROS continues to create. ROS continues to create all dependencies of the new resources. Catatan This parameter is available only for ROS stacks.	WebServer
Parameters	array<object>	No	Parameter templat yang ingin Anda gunakan untuk menggantikan parameter tertentu.
	object	No
ParameterKey	string	Yes	The name of template parameter N that you want to use to override a specific parameter. If you do not specify the name and value of a template parameter, ROS uses the name and value specified in the previous operation that was performed to create the stack. Maximum value of N: 200. Catatan This parameter takes effect only when Mode is set to Recreate.	Amount
ParameterValue	string	Yes	The value of template parameter N that you want to use to override a specific parameter. Maximum value of N: 200. For ROS stacks, the template parameters that you use to override specific parameters are subject to the following limits: You cannot change the condition values in the Conditions section of a template from true to false or from false to true. The template parameters can be referenced only by resources that ROS continues to create. Catatan This parameter takes effect only when Mode is set to Recreate.	12
Parallelism	integer	No	Jumlah maksimum operasi konkuren yang dapat dilakukan pada Sumber daya. Secara default, parameter ini kosong. Anda dapat menetapkan parameter ini ke bilangan bulat yang lebih besar dari atau sama dengan 0. Catatan Jika Anda menetapkan parameter ini ke bilangan bulat yang lebih besar dari 0, bilangan bulat tersebut akan digunakan. Jika Anda menetapkan parameter ini ke 0, tidak ada batas yang diberlakukan pada stack ROS. Namun, nilai default di Terraform digunakan untuk stack Terraform. Pada umumnya, nilai default di Terraform adalah 10. Jika Anda mengosongkan parameter ini, nilai yang Anda tentukan untuk parameter ini di permintaan sebelumnya akan digunakan. Jika Anda mengosongkan parameter ini di permintaan sebelumnya, tidak ada batas yang diberlakukan pada stack ROS. Namun, nilai default di Terraform digunakan untuk stack Terraform. Pada umumnya, nilai default di Terraform adalah 10. Jika Anda menetapkan parameter ini ke nilai tertentu, ROS mengasosiasikan nilai tersebut dengan stack. Nilai tersebut memengaruhi operasi berikutnya pada stack.	1
RecreatingOptions	array	No	Opsi yang diadopsi ROS saat ROS melanjutkan pembuatan stack.
	string	No	The option that ROS adopts when ROS continues to create the stack. This parameter takes effect when `Mode` is set to `Recreate`. Valid values: TryToFixSignalFailureByRerunEcsCommand: ROS tries to fix existing signals of the FAILURE type. When ALIYUN::ROS::WaitCondition resources fail to be created, ROS uses the associated and created ALIYUN::ECS::RunCommand and ALIYUN::ECS::Invocation resources and the relevant dependencies to recreate the ALIYUN::ROS::WaitCondition resources. Catatan This value is valid only for ROS stacks. IgnoreExistingSignalFailure: ROS ignores existing signals of the FAILURE type. If ALIYUN::ROS::WaitCondition resources fail to be created, the resources are successfully created when ROS continues to create the stack. Catatan This value is valid only for ROS stacks. AutoRecreatingResources: ROS automatically recreates the resources whose template content or referenced parameters are modified and the relevant dependencies. This option facilitates the configurations of RecreatingResources.N. However, unnecessary resources may also be recreated. Catatan This value is valid only for ROS stacks. CreateNewPrepaidInstance: ROS creates a new subscription instance if subscription resources fail to be created, or if you use ROS to recreate subscription resources that are successfully created. Catatan This value is valid only for ROS stacks. If a subscription instance is already created, ROS retains the subscription instance because subscription resources cannot be deleted. If you do not set RecreatingOptions.N to CreateNewPrepaidInstance, ROS tries to reuse an existing instance. If ROS reuses the instance, you cannot modify the resource properties, or you can modify only a small number of resource properties.	CreateNewPrepaidInstance

Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	The request ID.	B288A0BE-D927-4888-B0F7-B35EF84B6E6
StackId	string	The stack ID.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
DryRunResult	object	The validation result.
ParametersAllowedToBeModified	array	The parameters that can be modified.
	string	The parameter that can be modified. The operation that is performed to modify the parameters does not cause a validation error. Catatan This parameter is returned only if DryRun is set to `true`. The value of ParametersAllowedToBeModified varies based on the values of Mode, Template*, RecreatingResources.N, and RecreatingOptions.N.	description
ParametersConditionallyAllowedToBeModified	array	The parameters that can be modified under specific conditions.
	string	The parameter that can be modified under specific conditions. The new values of the parameters determine whether the operation that is performed to modify the parameters causes a validation error. Catatan This parameter is returned only if DryRun is set to `true`. The value of ParametersConditionallyAllowedToBeModified varies based on the values of Mode, Template*, RecreatingResources.N, and RecreatingOptions.N.	name
ParametersNotAllowedToBeModified	array	The parameters that cannot be modified.
	string	The parameter that cannot be modified. The operation that is performed to modify the parameters causes a validation error. Catatan This parameter is returned only if DryRun is set to `true`. The value of ParametersNotAllowedToBeModified varies based on the values of Mode, Template*, RecreatingResources.N, and RecreatingOptions.N.	cidr

Contoh

Respons sukses

JSONformat

{
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
  "DryRunResult": {
    "ParametersAllowedToBeModified": [
      "description"
    ],
    "ParametersConditionallyAllowedToBeModified": [
      "name"
    ],
    "ParametersNotAllowedToBeModified": [
      "cidr"
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.