Lanjutkan Pembuatan Stack - - Alibaba Cloud Documentation Center

Melanjutkan pembuatan stack yang gagal.

Topik ini memberikan contoh cara melanjutkan pembuatan stack yang gagal. Dalam contoh ini, stack dengan ID 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** gagal dibuat di wilayah Tiongkok (Hangzhou).

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	ContinueCreateStack	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ContinueCreateStack.
StackId	String	Ya	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	ID stack.
RegionId	String	Ya	cn-hangzhou	ID wilayah stack. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
RamRoleName	String	Tidak	test-role	Nama RAM role. Resource Orchestration Service (ROS) mengasumsikan RAM role untuk membuat stack dan menggunakan kredensial role tersebut untuk memanggil API Layanan Alibaba Cloud. ROS mengasumsikan RAM role untuk melakukan operasi pada stack. Jika Anda memiliki izin untuk melakukan operasi pada stack tetapi tidak memiliki izin untuk menggunakan RAM role tersebut, ROS tetap akan mengasumsikan RAM role tersebut. Pastikan hak istimewa minimal diberikan kepada RAM role tersebut. Jika Anda tidak menentukan parameter ini, ROS akan mengasumsikan RAM role yang sudah terkait dengan stack. Jika tidak ada RAM role yang tersedia, ROS akan menggunakan kredensial temporary yang dihasilkan dari kredensial akun Anda. Nama RAM role dapat memiliki panjang hingga 64 byte.
Mode	String	Tidak	Recreate	Mode di mana ROS melanjutkan pembuatan stack. Nilai default: Recreate. Nilai yang valid: Recreate Jika Anda menetapkan parameter ini ke Recreate, ROS hanya melanjutkan pembuatan jenis resource berikut: Resource yang gagal dibuat Resource yang Anda tentukan untuk parameter RecreatingResources.N Dependencies dari resource yang Anda tentukan untuk parameter RecreatingResources.N Resource yang belum Anda buat Catatan Parameter RecreatingResources.N, TemplateBody, dan TemplateURL, serta bagian Parameters hanya berlaku ketika parameter Mode ditetapkan ke Recreate. Ignore ROS mengabaikan dan membuang resource yang gagal dibuat dan yang belum Anda buat, lalu menandai stack sebagai berhasil dibuat. Body template yang digunakan untuk membuat stack telah diubah. Catatan Nilai ini hanya berlaku untuk stack ROS.
TemplateBody	String	Tidak	{"ROSTemplateFormatVersion": "2015-09-01"}	Struktur yang berisi body template. Body template harus memiliki panjang 1 hingga 524.288 byte. Jika panjang body template melebihi batas atas, kami menyarankan 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 template: Description, Metadata, Resources, dan Outputs. Anda tidak dapat menambahkan atau menghapus bagian dari template. Bagian Resources tunduk pada batasan berikut: Anda tidak dapat menghapus resource atau mengubah body template untuk resource yang tidak ingin Anda lanjutkan pembuatannya. Anda dapat menghapus resource atau mengubah body template untuk resource yang ingin Anda lanjutkan pembuatannya. Anda dapat menambahkan resource ke bagian ini. Catatan Parameter ini hanya berlaku ketika parameter Mode ditetapkan ke Recreate. Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId. Jika Anda tidak menentukan parameter tersebut, template yang ada akan digunakan.
TemplateURL	String	Tidak	oss://ros-template/demo	URL file yang berisi body template. URL harus mengarah ke template yang berada di server web HTTP atau HTTPS atau di Bucket Object Storage Service (OSS), seperti oss://ros/template/demo atau oss://ros/template/demo?RegionId=cn-hangzhou. Body template dapat memiliki panjang hingga 524.288 byte. Jika Anda tidak menentukan ID wilayah Bucket OSS, nilai parameter RegionId yang akan digunakan. Catatan Parameter ini hanya berlaku ketika parameter Mode ditetapkan ke Recreate. Saat Anda menentukan parameter TemplateURL dalam template, template tersebut tunduk pada batasan yang dijelaskan untuk parameter TemplateBody dalam topik ini. Anda hanya dapat menentukan salah satu dari parameter berikut: TemplateBody, TemplateURL, dan TemplateId. Jika Anda tidak menentukan parameter tersebut, template yang ada akan digunakan.
DryRun	Boolean	Tidak	false	Menentukan apakah hanya akan memvalidasi stack dalam permintaan. Nilai default: false. Nilai yang valid: true: hanya memvalidasi stack. false: memvalidasi dan melanjutkan pembuatan stack.
TemplateId	String	Tidak	5ecd1e10-b0e9-4389-a565-e4c15efc****	ID template. Parameter ini berlaku untuk template bersama dan template pribadi. Catatan Parameter ini berlaku ketika parameter `Mode` ditetapkan ke `Recreate`. Saat Anda menentukan parameter TemplateId dalam template, template tersebut tunduk pada batasan yang dijelaskan untuk parameter `TemplateBody` dalam topik ini. Anda hanya dapat menentukan salah satu dari parameter berikut: `TemplateBody`, `TemplateURL`, dan `TemplateId`. Jika Anda tidak menentukan parameter tersebut, template yang ada akan digunakan.
TemplateVersion	String	Tidak	v1	Versi template. Parameter ini hanya berlaku ketika parameter TemplateId ditentukan.
RecreatingResources.N	String	Tidak	WebServer	Resource N yang dilanjutkan pembuatannya oleh ROS setelah resource tersebut gagal dibuat. Anda dapat menambahkan resource baru ke daftar resource yang dilanjutkan pembuatannya oleh ROS. ROS akan melanjutkan pembuatan semua dependencies dari resource baru tersebut. Catatan Parameter ini hanya berlaku untuk stack ROS.
Parameters.N.ParameterKey	String	Ya	Amount	Nama parameter template N yang ingin Anda gunakan untuk menggantikan parameter lain. Jika Anda tidak menentukan nama dan nilai parameter template, ROS akan menggunakan nama dan nilai yang ditentukan dalam operasi sebelumnya untuk membuat stack. Nilai maksimum N: 200. Catatan Parameter ini hanya berlaku ketika parameter Mode ditetapkan ke Recreate.
Parameters.N.ParameterValue	String	Ya	12	Nilai parameter template N yang ingin Anda gunakan untuk menggantikan parameter lain. Nilai maksimum N: 200. Untuk stack ROS, batasan berikut diterapkan pada parameter template yang digunakan untuk menggantikan parameter lain: Anda tidak dapat mengubah nilai kondisi di bagian Conditions template dari true ke false atau dari false ke true. Parameter template hanya dapat direferensikan oleh resource yang dilanjutkan pembuatannya oleh ROS. Catatan Parameter ini hanya berlaku ketika parameter Mode ditetapkan ke Recreate.
Parallelism	Long	Tidak	1	Jumlah maksimum operasi konkuren yang dapat dilakukan pada resource. 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 tersebut akan digunakan. Jika Anda menetapkan parameter ini ke 0, tidak ada batasan untuk stack ROS. Namun, nilai default di Terraform akan digunakan untuk stack Terraform. Umumnya, nilai default di Terraform adalah 10. Jika Anda membiarkan parameter ini kosong, nilai yang Anda tentukan untuk parameter ini dalam permintaan sebelumnya akan digunakan. Jika Anda membiarkannya kosong dalam permintaan sebelumnya, tidak ada batasan untuk stack ROS. Namun, nilai default di Terraform akan digunakan untuk stack Terraform. Umumnya, nilai default di Terraform adalah 10. Jika Anda menetapkan parameter ini ke nilai tertentu, ROS akan mengaitkan nilai tersebut dengan stack. Nilai ini akan memengaruhi operasi selanjutnya pada stack.
RecreatingOptions.N	String	Tidak	CreateNewPrepaidInstance	Opsi N yang diadopsi ROS saat melanjutkan pembuatan stack. Parameter ini berlaku ketika parameter `Mode` ditetapkan ke `Recreate`. Nilai yang valid: TryToFixSignalFailureByRerunEcsCommand: ROS mencoba memperbaiki sinyal FAILURE yang sudah ada. Ketika resource ALIYUN::ROS::WaitCondition gagal dibuat, ROS menggunakan resource ALIYUN::ECS::RunCommand dan ALIYUN::ECS::Invocation yang terkait dan telah dibuat beserta dependencies-nya untuk membuat ulang resource ALIYUN::ROS::WaitCondition tersebut. Catatan Nilai ini hanya berlaku untuk stack ROS. IgnoreExistingSignalFailure: ROS mengabaikan sinyal FAILURE yang sudah ada. Jika resource ALIYUN::ROS::WaitCondition gagal dibuat, resource tersebut dianggap berhasil dibuat saat ROS melanjutkan pembuatan stack. Catatan Nilai ini hanya berlaku untuk stack ROS. AutoRecreatingResources: ROS secara otomatis membuat ulang resource yang konten templatenya atau parameter yang direferensikannya dimodifikasi beserta dependencies-nya. Opsi ini mempermudah konfigurasi parameter RecreatingResources.N. Namun, resource yang tidak perlu juga mungkin dibuat ulang. Catatan Nilai ini hanya berlaku untuk stack ROS. CreateNewPrepaidInstance: ROS membuat instans langganan baru jika resource langganan gagal dibuat, atau jika Anda menggunakan ROS untuk membuat ulang resource langganan yang telah berhasil dibuat. Catatan Nilai ini hanya berlaku untuk stack ROS. Jika instans langganan sudah dibuat, ROS akan menyimpan instans langganan tersebut karena resource langganan tidak dapat dihapus. Jika Anda tidak menetapkan parameter RecreatingOptions.N ke CreateNewPrepaidInstance, ROS akan mencoba menggunakan kembali instans yang sudah ada. Jika ROS menggunakan kembali instans tersebut, Anda tidak dapat memodifikasi properti resource, atau hanya dapat memodifikasi sejumlah kecil properti resource.

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

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6	ID permintaan.
StackId	String	4a6c9851-3b0f-4f5f-b4ca-a14bf691****	ID stack.
DryRunResult	Object		Hasil validasi.
ParametersAllowedToBeModified	Array of String	description	Parameter yang dapat dimodifikasi. Operasi modifikasi parameter tersebut tidak menyebabkan error validasi. Catatan Parameter ini hanya dikembalikan jika parameter DryRun ditetapkan ke `true`. Nilai parameter ParametersAllowedToBeModified bervariasi berdasarkan nilai parameter Mode, Template*, RecreatingResources.N, dan RecreatingOptions.N.
ParametersConditionallyAllowedToBeModified	Array of String	name	Parameter yang dapat dimodifikasi dengan syarat tertentu. Nilai baru parameter tersebut menentukan apakah operasi modifikasi parameter menyebabkan error validasi. Catatan Parameter ini hanya dikembalikan jika parameter DryRun ditetapkan ke `true`. Nilai parameter ParametersConditionallyAllowedToBeModified bervariasi berdasarkan nilai parameter Mode, Template*, RecreatingResources.N, dan RecreatingOptions.N.
ParametersNotAllowedToBeModified	Array of String	cidr	Parameter yang tidak dapat dimodifikasi. Operasi modifikasi parameter tersebut menyebabkan error validasi. Catatan Parameter ini hanya dikembalikan jika parameter DryRun ditetapkan ke `true`. Nilai parameter ParametersNotAllowedToBeModified bervariasi berdasarkan nilai parameter Mode, Template*, RecreatingResources.N, dan RecreatingOptions.N.

Contoh

Permintaan contoh

http(s)://ros.aliyuncs.com/?Action=ContinueCreateStack
&RegionId=cn-hangzhou
&StackId=4a6c9851-3b0f-4f5f-b4ca-a14bf691****
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ContinueCreateStackResponse>
    <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6</RequestId>
    <StackId>4a6c9851-3b0f-4f5f-b4ca-a14bf691****</StackId>
</ContinueCreateStackResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId" : "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	CircularDependency	Circular Dependency Found: {reason}.	Pesan kesalahan yang dikembalikan karena template berisi dependensi melingkar. reason menunjukkan penyebab kesalahan.
400	InvalidSchema	{reason}.	Pesan kesalahan yang dikembalikan karena format template tidak valid. reason menunjukkan penyebab kesalahan.
400	InvalidTemplateAttribute	The Referenced Attribute ({resource} {name}) is incorrect.	Pesan kesalahan yang dikembalikan karena properti resource yang direferensikan di bagian Outputs template tidak valid. resource menunjukkan nama resource. name menunjukkan nama properti.
400	InvalidTemplatePropertyType	The specified value type of ({resource} {section}) is incorrect.	Pesan kesalahan yang dikembalikan karena tipe properti resource yang didefinisikan di bagian template tidak valid. resource menunjukkan nama resource. section menunjukkan nama bagian.
400	InvalidTemplateReference	The specified reference "{name}" (in {referencer}) is incorrect.	Pesan kesalahan yang dikembalikan karena template berisi referensi yang tidak valid. name menunjukkan nama referensi. referencer menunjukkan nama pengacu.
400	InvalidTemplateSection	The template section is invalid: {section}.	Pesan kesalahan yang dikembalikan karena template berisi bagian yang tidak valid. section menunjukkan nama bagian.
400	InvalidTemplateVersion	The template version is invalid: {reason}.	Pesan kesalahan yang dikembalikan karena versi template tidak valid. reason menunjukkan penyebab kesalahan.
400	StackValidationFailed	{reason}.	Pesan kesalahan yang dikembalikan karena stack gagal divalidasi. reason menunjukkan penyebab kesalahan.
400	UnknownUserParameter	The Parameter ({name}) was not defined in template.	Pesan kesalahan yang dikembalikan karena parameter yang ditentukan tidak didefinisikan dalam template. name menunjukkan nama parameter.
400	UserParameterMissing	The Parameter {name} was not provided.	Pesan kesalahan yang dikembalikan karena tidak ada nilai yang ditentukan untuk parameter yang didefinisikan dalam template. name menunjukkan nama parameter.
400	ContinueCreateStackValidationFailed	{reason}.	Pesan kesalahan yang dikembalikan karena operasi untuk melanjutkan pembuatan stack gagal divalidasi. reason menunjukkan penyebab kesalahan.
404	ResourceNotFound	The Resource ({name}) could not be found in Stack {stack}.	Pesan kesalahan yang dikembalikan karena resource tidak ada dalam stack. name menunjukkan nama resource. stack menunjukkan nama atau ID stack.
404	StackNotFound	The Stack ({name}) could not be found.	Pesan kesalahan yang dikembalikan karena stack tidak ada. name menunjukkan nama atau ID stack.
409	ActionInProgress	Stack {name} already has an action ({action}) in progress.	Pesan kesalahan yang dikembalikan karena stack sedang dalam proses perubahan. name menunjukkan nama atau ID stack. action menunjukkan operasi perubahan.
404	TemplateNotFound	The Tempalte ({ ID }) could not be found.	Pesan kesalahan yang dikembalikan karena template tidak ada. ID menunjukkan ID template.
404	TemplateNotFound	The Template { ID } with version { version } could not be found.	Pesan kesalahan yang dikembalikan karena template atau versi template tidak ada. ID menunjukkan ID template. version menunjukkan versi template.