Gunakan UpdateTemplate API untuk memperbarui template - Resource Orchestration Service - Alibaba Cloud - Resource Orchestration Service

Deskripsi operasi

Saat memperbarui template, harap perhatikan:

Jika Anda menentukan TemplateBody atau TemplateURL, versi template akan bertambah 1 setelah pembaruan berhasil. Misalnya, versi berubah dari v1 menjadi v2.
Jika baik TemplateBody maupun TemplateURL tidak ditentukan, versi template tetap tidak berubah.
Sebuah template dapat memiliki hingga 100 versi. Jika batas versi tercapai, pembaruan template akan gagal, dan Anda perlu membuat ulang template.

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:UpdateTemplate

update

*template

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TemplateURL	string	No	Lokasi file yang berisi isi template. URL harus mengarah ke template yang berada di server web (HTTP atau HTTPS) atau di bucket OSS Alibaba Cloud (mis., oss://ros/template/demo, oss://ros/template/demo?RegionId=cn-hangzhou), dengan ukuran maksimum 524.288 byte. Catatan Jika region OSS tidak ditentukan, secara default akan sama dengan parameter `RegionId` dalam permintaan. Anda hanya dapat menentukan salah satu dari `TemplateBody` atau `TemplateURL`. Panjang maksimum URL adalah 1.024 byte.	oss://ros/template/demo
TemplateName	string	No	Nama template. Panjangnya tidak boleh melebihi 255 karakter (pengkodean utf-8), dan harus diawali dengan angka, huruf, atau karakter Tionghoa. Dapat mencakup angka, huruf, karakter Tionghoa, tanda hubung (-), dan garis bawah (_).	MyTemplate
Description	string	No	Deskripsi template. Panjang maksimum adalah 256 karakter.	It is a demo.
TemplateBody	string	No	Struktur isi template. Panjangnya harus antara 1 dan 524.288 byte. Jika konten panjang, disarankan untuk menggunakan HTTP POST + Body Param untuk meneruskan parameter dalam isi permintaan guna menghindari kegagalan permintaan karena URL yang terlalu panjang. Catatan Anda harus dan hanya dapat menentukan salah satu dari `TemplateBody`, `TemplateURL`, `TemplateId`, atau `TemplateScratchId`.	{"ROSTemplateFormatVersion":"2015-09-01"}
TemplateId	string	Yes	ID template. Mendukung template bersama maupun pribadi.	5ecd1e10-b0e9-4389-a565-e4c15efc****
ValidationOptions	array	No	Opsi validasi. Secara default, tidak ada opsi yang diaktifkan, dan validasi ketat dilakukan.
	string	No	Opsi validasi. Nilai: BasicValidation: Hanya melakukan validasi struktural dasar pada konten template.	BasicValidation
RotateStrategy	string	No	Strategi rotasi versi template. Nilai: None (default): Tidak ada rotasi. Error terjadi ketika batas versi tercapai. DeleteOldestNonSharedVersionWhenLimitExceeded: Merotasi dan menghapus versi template yang tidak dibagikan. Catatan Jika semua versi template dibagikan, versi-versi tersebut tidak dapat dirotasi dan dihapus. Versi terbaru saat ini tidak akan dirotasi dan dihapus. Terlepas dari apakah penghapusan rotasi digunakan, nomor versi template tidak boleh melebihi v65000.	None
IsDraft	boolean	No	Apakah akan memperbarui versi Draft (draf). Nilai: false (default): Jika konten template diberikan, versi baru dibuat, dan versi Draft dihapus. Jika tidak, versi terbaru saat ini diubah. true: Mengubah versi Draft. Versi Draft hanya dapat diambil melalui antarmuka GetTemplate. Antarmuka ListTemplateVersions tidak akan mengembalikannya. Parameter TemplateVersion pada antarmuka lain tidak dapat menentukan Draft.	false

Untuk detail tentang parameter permintaan umum, lihat Parameter Umum.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID Permintaan.	8C5D90E1-66B6-496C-9371-3807F8DA80A8
TemplateId	string	ID Template.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	Versi template yang terpengaruh oleh operasi ini.	v2

Contoh

Respons sukses

JSONformat

{
  "RequestId": "8C5D90E1-66B6-496C-9371-3807F8DA80A8",
  "TemplateId": "5ecd1e10-b0e9-4389-a565-e4c15efc****",
  "TemplateVersion": "v2"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.