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

Melanjutkan pembuatan stack setelah pembuatan stack gagal.

Deskripsi operasi

Topik ini menyediakan contoh cara melanjutkan pembuatan stack yang gagal dengan ID 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** di wilayah China (Hangzhou).

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

*stack.

acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

Template.

acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

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 Resource Access Management (RAM). Resource Orchestration Service (ROS) mengasumsikan peran ini untuk membuat stack dan menggunakan kredensial peran tersebut untuk memanggil operasi API atas nama pengguna. ROS selalu menggunakan peran ini untuk operasi berikutnya pada stack. Selama Anda memiliki izin untuk melakukan operasi pada stack, ROS akan menggunakan peran ini meskipun Anda tidak memiliki izin untuk mengasumsikan peran tersebut. Hal ini memastikan bahwa izin minimum diberikan kepada peran. Jika Anda tidak menentukan parameter ini, ROS menggunakan peran yang sebelumnya dikaitkan dengan stack. Jika tidak ada peran yang tersedia, ROS menggunakan kredensial sementara yang dihasilkan dari kredensial pengguna Anda. Nama peran RAM dapat memiliki panjang hingga 64 byte.	test-role
Mode	string	No	Mode untuk melanjutkan pembuatan stack. Nilai valid: Recreate (default): Anda hanya perlu melanjutkan pembuatan empat jenis Sumber daya berikut. Sumber daya lain tidak perlu dibuat: Sumber daya yang gagal dibuat. Sumber daya yang ditentukan untuk dibuat ulang (RecreatingResources.N). Sumber daya yang bergantung pada Sumber daya yang ditentukan untuk dibuat ulang (RecreatingResources.N). Sumber daya yang belum dibuat. Catatan Parameter RecreatingResources.N, TemplateBody, TemplateURL, dan Parameters hanya berlaku pada mode ini. Ignore: Mengabaikan dan membuang semua Sumber daya yang gagal dibuat dan Sumber daya yang belum dibuat, serta langsung menandai stack sebagai berhasil. Konten templat berubah. Catatan Mode ini hanya tersedia untuk stack ROS.	Recreate
TemplateBody	string	No	Struktur templat. Badan templat harus memiliki panjang 1 hingga 524.288 byte. Jika panjang badan templat melebihi batas atas, kami menyarankan Anda menggunakan metode HTTP POST dan meneruskan parameter di badan permintaan untuk mencegah kegagalan permintaan yang disebabkan oleh URL yang terlalu panjang. Batas berikut berlaku untuk Template ROS: Anda hanya dapat memodifikasi bagian Description, Metadata, Resources, Outputs, dan Rules pada templat. Anda tidak dapat menambahkan atau menghapus bagian, yang merupakan elemen tingkat pertama dari konten templat. Bagian Resources pada templat memiliki batas berikut: Untuk Sumber daya yang tidak akan dibuat ulang, Anda tidak dapat menghapusnya maupun memodifikasi konten templatnya. Untuk Sumber daya yang akan dibuat ulang, Anda dapat menghapusnya atau memodifikasi konten templatnya. Anda dapat menambahkan Sumber daya baru. Catatan Parameter ini hanya berlaku ketika Mode diatur ke Recreate. Anda hanya dapat menentukan salah satu dari parameter TemplateBody, TemplateURL, dan TemplateId. Jika tidak ada parameter ini yang ditentukan, templat asli akan digunakan.	{"ROSTemplateFormatVersion": "2015-09-01"}
TemplateURL	string	No	URL file yang berisi badan templat. URL harus mengarah ke templat yang terletak di server web HTTP atau HTTPS atau di bucket Alibaba Cloud Object Storage Service (OSS), seperti oss://ros/template/demo dan oss://ros/template/demo?RegionId=cn-hangzhou. Templat dapat memiliki panjang hingga 524.288 byte. Jika wilayah bucket OSS tidak ditentukan, wilayah bucket OSS sama dengan nilai parameter RegionId. Catatan Parameter ini hanya berlaku ketika Mode diatur ke Recreate. Batas pada templat sama dengan batas untuk TemplateBody. Anda hanya dapat menentukan salah satu dari parameter TemplateBody, TemplateURL, dan TemplateId. Jika tidak ada parameter ini yang ditentukan, templat asli akan digunakan.	oss://ros-template/demo
DryRun	boolean	No	Apakah akan hanya melakukan pemeriksaan awal pada permintaan. Nilai valid: true: Melakukan pemeriksaan awal tanpa menjalankan operasi aktual. false (default): Menjalankan operasi aktual dan melanjutkan pembuatan stack.	false
TemplateId	string	No	ID templat. Templat bersama dan templat pribadi didukung. Catatan Parameter ini hanya berlaku ketika `Mode` diatur ke `Recreate`. Batas pada templat sama dengan batas untuk `TemplateBody`. Anda hanya dapat menentukan salah satu dari parameter `TemplateBody`, `TemplateURL`, dan `TemplateId`. Jika tidak ada parameter ini yang ditentukan, templat asli akan digunakan.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	No	Versi templat. Parameter ini hanya berlaku ketika TemplateId ditentukan.	v1
RecreatingResources	array	No	Sumber daya yang gagal dibuat akan dibuat ulang. Anda dapat menentukan daftar Sumber daya tambahan yang akan dibuat ulang. ROS akan membuat ulang semua Sumber daya yang bergantung pada Sumber daya ini. Catatan Parameter ini hanya tersedia untuk stack ROS.	WebServer
	string	No	Sumber daya yang gagal dibuat akan dibuat ulang. Anda dapat menentukan daftar Sumber daya tambahan yang akan dibuat ulang. ROS akan membuat ulang semua Sumber daya yang bergantung pada Sumber daya ini. Catatan Parameter ini hanya tersedia untuk stack ROS.	WebServer
Parameters	array<object>	No	Parameter templat yang akan diganti.
	object	No
ParameterKey	string	Yes	Nama parameter templat yang akan diganti. Jika Anda tidak menentukan nama dan nilai parameter tertentu, ROS menggunakan nilai dari pembuatan sebelumnya. Nilai maksimum N: 200. Catatan Parameter ini hanya berlaku ketika Mode diatur ke Recreate.	Amount
ParameterValue	string	Yes	Nilai parameter templat yang akan diganti. Nilai maksimum N: 200. Untuk stack ROS, parameter templat yang diganti memiliki batas berikut: Penggantian tidak dapat menyebabkan nilai kondisi apa pun di bagian Conditions pada templat berubah dari true menjadi false atau dari false menjadi true. Parameter yang diganti tidak dapat direferensikan oleh Sumber daya yang tidak akan dibuat ulang. Catatan Parameter ini hanya berlaku ketika Mode diatur ke Recreate.	12
Parallelism	integer	No	Jumlah maksimum Sumber daya konkuren. Nilai default: kosong. Anda dapat memasukkan bilangan bulat yang lebih besar dari atau sama dengan 0. Catatan Jika Anda mengatur parameter ini ke bilangan bulat yang lebih besar dari 0, bilangan bulat yang ditentukan akan digunakan. Jika Anda mengatur parameter ini ke 0, tidak ada batas yang diterapkan pada stack ROS, dan nilai default Terraform (biasanya 10) digunakan untuk stack Terraform. Jika Anda tidak menentukan parameter ini, nilai dari operasi sebelumnya akan digunakan. Jika tidak ada nilai yang ditentukan pada operasi sebelumnya, tidak ada batas yang diterapkan pada stack ROS, dan nilai default Terraform (biasanya 10) digunakan untuk stack Terraform. Jika Anda menentukan parameter ini, parameter tersebut akan dikaitkan dengan stack dan memengaruhi operasi berikutnya pada stack.	1
RecreatingOptions	array	No	Opsi pembuatan ulang.
	string	No	Opsi pembuatan ulang. Parameter ini berlaku ketika `Mode` diatur ke `Recreate`. Nilai valid: TryToFixSignalFailureByRerunEcsCommand: mencoba memperbaiki kegagalan sinyal yang ada. Ketika Sumber daya ALIYUN::ROS::WaitCondition gagal dibuat, ROS menemukan Sumber daya ALIYUN::ECS::RunCommand dan ALIYUN::ECS::Invocation yang terkait dan berhasil dibuat, lalu membuat ulang Sumber daya ini serta Sumber daya yang bergantung padanya. Catatan Opsi ini hanya berlaku untuk stack ROS. IgnoreExistingSignalFailure: mengabaikan kegagalan sinyal yang ada. Jika Sumber daya ALIYUN::ROS::WaitCondition sebelumnya gagal dibuat, Sumber daya tersebut langsung ditandai sebagai berhasil dibuat selama proses pembuatan baru. Catatan Opsi ini hanya berlaku untuk stack ROS. AutoRecreatingResources: secara otomatis membuat ulang Sumber daya yang konten templat atau parameter yang direferensikannya telah berubah, termasuk Sumber daya yang bergantung padanya. Opsi ini menyederhanakan konfigurasi parameter RecreatingResources.N, tetapi dapat menyebabkan pembuatan ulang Sumber daya yang tidak terduga. Catatan Opsi ini hanya berlaku untuk stack ROS. CreateNewPrepaidInstance: ketika Anda melanjutkan pembuatan instans, jika Sumber daya yang gagal dibuat atau berhasil dibuat tetapi ditentukan untuk dibuat ulang bertipe langganan, ROS membuat instans baru. Catatan Opsi ini hanya berlaku untuk stack ROS. Jika instans lama telah dibuat, instans tersebut tidak dihapus karena instans langganan tidak dapat dihapus. Secara default (ketika CreateNewPrepaidInstance tidak diatur), dalam skenario ini, jika instans lama telah dibuat, ROS akan mencoba menggunakan kembali instans yang dibuat. Penggunaan kembali memiliki batas tertentu, dan properti Sumber daya umumnya tidak diizinkan untuk dimodifikasi atau hanya beberapa properti yang diizinkan untuk dimodifikasi.	CreateNewPrepaidInstance

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

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	B288A0BE-D927-4888-B0F7-B35EF84B6E6
StackId	string	ID stack.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
DryRunResult	object	Hasil pemeriksaan awal.
ParametersAllowedToBeModified	array	Parameter yang diizinkan untuk dimodifikasi.
	string	Parameter yang diizinkan untuk dimodifikasi. Memodifikasi parameter ini tidak menyebabkan kesalahan pemeriksaan awal. Catatan Parameter ini hanya dikembalikan ketika DryRun diatur ke `true`. Hasilnya terkait dengan Mode, Template*, RecreatingResources.N, dan RecreatingOptions.N.	description
ParametersConditionallyAllowedToBeModified	array	Parameter yang mungkin diizinkan untuk dimodifikasi.
	string	Parameter yang mungkin diizinkan untuk dimodifikasi. Apakah memodifikasi parameter menyebabkan kesalahan pemeriksaan awal bergantung pada nilai parameter tersebut. Catatan Parameter ini hanya dikembalikan ketika DryRun diatur ke `true`. Hasilnya terkait dengan Mode, Template*, RecreatingResources.N, dan RecreatingOptions.N.	name
ParametersNotAllowedToBeModified	array	Parameter yang tidak diizinkan untuk dimodifikasi.
	string	Parameter yang tidak diizinkan untuk dimodifikasi. Memodifikasi parameter ini pasti menyebabkan kesalahan pemeriksaan awal. Catatan Parameter ini hanya dikembalikan ketika DryRun diatur ke `true`. Hasilnya terkait dengan Mode, Template*, RecreatingResources.N, dan 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.