All Products
Search
Document Center

Resource Orchestration Service:CreateTemplateScratch

Last Updated:Jun 10, 2026

Membuat templatescratch: skenario.

Deskripsi operasi

Batasan

Hanya tipe sumber daya tertentu yang mendukung fitur skenario sumber daya. Untuk informasi selengkapnya, lihat Tipe sumber daya yang mendukung skenario.

Deskripsi

Resource Orchestration Service (ROS) menyediakan fitur skenario sumber daya. Anda dapat memilih cakupan sumber daya di UI dan melakukan operasi seperti replikasi atau pengelolaan sekelompok sumber daya, yang membantu menyederhanakan pengelolaan sumber daya. Untuk informasi selengkapnya tentang skenario sumber daya, lihat Ikhtisar.

Skenario replikasi sumber daya

Jika Anda ingin mereplikasi kumpulan sumber daya dan dependensi antar sumber daya, Anda dapat membuat skenario replikasi sumber daya. Tipe skenario ini memungkinkan Anda mereplikasi semua sumber daya yang ada dalam cakupan yang ditentukan dan menghasilkan kumpulan sumber daya yang memiliki arsitektur yang sama dengan sumber daya yang ada. Untuk informasi selengkapnya, lihat Skenario replikasi sumber daya.

Skenario pemrofilan sumber daya

Jika hubungan antar sumber daya yang ingin Anda buat rumit, Anda dapat membuat skenario pemrofilan sumber daya untuk melihat pratinjau arsitektur sumber daya secara keseluruhan atau arsitektur yang dimulai dari sumber daya tertentu. Hal ini membantu menyederhanakan pengelolaan sumber daya. Untuk informasi selengkapnya, lihat Skenario deteksi sumber daya.

Skenario pengelolaan sumber daya

Jika Anda perlu mengimpor kumpulan sumber daya yang ada ke dalam stack sumber daya baru untuk pengelolaan terpadu, Anda dapat membuat skenario pengelolaan sumber daya. Untuk informasi selengkapnya, lihat Skenario pengelolaan sumber daya.

Skenario migrasi sumber daya

Jika Anda ingin memigrasikan kumpulan sumber daya dan dependensi antar sumber daya, Anda dapat membuat skenario migrasi sumber daya. Saat Anda memigrasikan sumber daya, ROS menghasilkan sebuah stack. Anda dapat melihat progres migrasi pada tab Stacks dari halaman detail skenario. Setelah Anda memigrasikan sumber daya, Anda dapat menghapus sumber daya sumber. Untuk informasi selengkapnya, lihat Skenario migrasi sumber daya.

Topik ini memberikan contoh cara membuat skenario replikasi sumber daya di region China (Hangzhou) untuk mereplikasi virtual private cloud (VPC) dengan ID vpc-bp1m6fww66xbntjyc****.

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

create

*TemplateScratch

acs:ros:{#regionId}:{#accountId}:templatescratch/*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID region dari skenario sumber daya.

Anda dapat memanggil DescribeRegions untuk meminta daftar region terbaru.

cn-hangzhou

TemplateScratchType

string

Yes

Tipe skenario sumber daya. Nilai yang valid:

  • ArchitectureReplication: replikasi sumber daya

  • ArchitectureDetection: pemrofilan sumber daya

  • ResourceImport: pengelolaan sumber daya

  • ResourceMigration: migrasi sumber daya

Catatan

Saat Anda menentukan nilai yang berbeda untuk parameter TemplateScratchType, parameter opsional dalam deskripsi tambahan parameter permintaan juga berbeda. Untuk informasi selengkapnya, lihat bagian Deskripsi tambahan parameter permintaan di bawah.

ArchitectureReplication

Description

string

No

Deskripsi skenario sumber daya.

Copy VPC resources.

SourceResources

array<object>

No

Sumber daya sumber.

Saat Anda mengatur TemplateScratchType ke ArchitectureDetection, Anda dapat menentukan SourceResources untuk mendeteksi data arsitektur dari semua sumber daya yang terkait dengan sumber daya sumber yang ditentukan. Misalnya, jika Anda menentukan ID instans CLB, sistem akan mendeteksi dan mengidentifikasi sumber daya terkaitnya seperti instans ECS, vSwitch, dan VPC.

Jika TemplateScratchType diatur ke ArchitectureDetection, Anda dapat menentukan hingga 20 sumber daya sumber.

Dalam kasus lain, didukung hingga 200 sumber daya sumber.

object

No

Sumber daya sumber.

ResourceId

string

Yes

ID sumber daya.

vpc-bp1m6fww66xbntjyc****

ResourceType

string

Yes

Tipe sumber daya.

ALIYUN::ECS::VPC

RegionId

string

No

ID region dari sumber daya.

Anda dapat memanggil DescribeRegions untuk meminta daftar region terbaru.

Catatan
  • Parameter ini hanya berlaku ketika TemplateScratchType diatur ke ArchitectureDetection.

  • ID region dari sumber daya global adalah global. Misalnya, ALIYUN::CDN::Domain adalah sumber daya global, dan ID region-nya adalah global.

cn-beijing

RelatedResourceTypeFilter

array

No

Filter tipe sumber daya terkait.

string

No

Filter tipe sumber daya terkait.

ALIYUN::ECS::VPC

SourceTag

object

No

Tag sumber.

ResourceTags

object

Yes

Tag sumber yang terdiri dari pasangan kunci-nilai. Jika Anda hanya ingin menentukan kunci tag, atur nilai tag ke string kosong, misalnya: {"TagKey": ""}.

Anda dapat menambahkan hingga 10 tag sumber. Jika Anda mengatur TemplateScratchType ke ArchitectureDetection, Anda dapat menambahkan hingga 5 tag sumber.

{"a": "b"}

ResourceTypeFilter

array

No

Filter tipe sumber daya.

string

No

Filter untuk tipe sumber daya. Jika daftar tipe sumber daya ditentukan, hanya sumber daya dari tipe yang ditentukan yang berisi tag yang ditentukan yang akan dipindai. Jika tidak ditentukan, semua sumber daya yang berisi tag yang ditentukan akan dipindai.

Anda dapat menentukan hingga 20 tipe sumber daya.

ALIYUN::ECS::VPC

SourceResourceGroup

object

No

Grup sumber daya sumber.

ResourceGroupId

string

Yes

ID grup sumber daya sumber.

rg-acfmzawhxxc****

ResourceTypeFilter

array

No

Tipe sumber daya untuk memfilter sumber daya.

string

No

Filter untuk tipe sumber daya. Jika daftar tipe sumber daya ditentukan, hanya sumber daya dari tipe yang ditentukan yang berisi tag yang ditentukan yang akan dipindai. Jika tidak ditentukan, semua sumber daya yang berisi tag yang ditentukan akan dipindai.

Anda dapat menentukan hingga 20 tipe sumber daya.

ALIYUN::ECS::VPC

PreferenceParameters

array<object>

No

Parameter konfigurasi untuk skenario sumber daya

object

No

ParameterKey

string

Yes

Kunci parameter.

Untuk informasi selengkapnya tentang nilai yang valid, lihat bagian Deskripsi tambahan parameter permintaan dalam topik ini.

Catatan
  • PreferenceParameters bersifat opsional. Jika Anda menentukan PreferenceParameters, Anda harus menentukan ParameterKey dan ParameterValue.

  • Anda harus mengatur ParameterKey ke DeletionPolicy ketika TemplateScratchType diatur ke ResourceImport.

DeletionPolicy

ParameterValue

string

Yes

Nilai parameter. Nilai tersebut adalah penugasan ke ParameterKey.

Untuk informasi selengkapnya tentang nilai yang valid, lihat bagian Deskripsi tambahan parameter permintaan dalam topik ini.

Catatan

PreferenceParameters bersifat opsional. Jika Anda menentukan PreferenceParameters, Anda harus menentukan ParameterKey dan ParameterValue.

Retain

LogicalIdStrategy

string

No

Strategi pembuatan ID logis. Nilai yang valid:

  • LongTypePrefixAndIndexSuffix: prefiks tipe panjang + sufiks tipe indeks

  • LongTypePrefixAndHashSuffix: prefiks tipe panjang + sufiks tipe hash

  • ShortTypePrefixAndHashSuffix: prefiks tipe pendek + sufiks tipe hash

Catatan

Nilai default: LongTypePrefixAndIndexSuffix. Jika TemplateScratchType diatur ke ArchitectureDetection, nilai default-nya adalah LongTypePrefixAndHashSuffix.

LongTypePrefixAndIndexSuffix

ClientToken

string

No

Memastikan idempotensi dari permintaan. Nilai ini harus dibuat oleh klien dan harus unik secara global.

Nilai tersebut tidak boleh lebih dari 64 karakter dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

123e4567-e89b-12d3-a456-42665544****

ExecutionMode

string

No

Mode eksekusi. Nilai yang valid:

  • Async (default): mode asinkron

  • Sync: mode sinkron

Catatan

Jika cakupan sumber daya besar, eksekusi sinkron memakan waktu yang lama. Kami merekomendasikan Anda menentukan ClientToken untuk menghindari masalah waktu habis.

Sync

Tags

array<object>

No

Tag dari skenario sumber daya.

object

No

Key

string

Yes

Kunci tag N yang ingin Anda tambahkan ke skenario sumber daya.

Catatan

Tags bersifat opsional. Jika Anda menentukan Tags, Anda harus menentukan Tags.N.Key.

usage

Value

string

No

Nilai tag N yang ingin Anda tambahkan ke skenario sumber daya.

test

ResourceGroupId

string

No

ID grup sumber daya tempat Anda ingin menetapkan kebijakan snapshot. Jika Anda mengosongkan parameter ini, skenario sumber daya ditambahkan ke grup sumber daya default.

rg-acfmxazb4ph6aiy****

Catatan tambahan tentang parameter permintaan

Untuk informasi selengkapnya, lihat Parameter umum.

Saat Anda menentukan nilai yang berbeda untuk parameter TemplateScratchType, nilai yang valid dari ParameterKey dan ParameterValue juga berbeda.

Skenario replikasi sumber daya

Tabel berikut menjelaskan nilai yang valid dari ParameterKey dan ParameterValue saat Anda mengatur TemplateScratchType ke ArchitectureReplication.

ParameterKeyParameterValue
DeletionPolicyKebijakan penghapusan sumber daya. Nilai yang valid: Retain: mempertahankan sumber daya saat Anda menghapus stack tempat sumber daya direplikasi. Delete: menghapus sumber daya secara default saat Anda menghapus stack tempat sumber daya direplikasi. Jika Anda mempertahankan sumber daya tertentu saat kotak dialog Delete Stack muncul, sumber daya akan dipertahankan.
RegionIdID region tujuan tempat Anda ingin mereplikasi sumber daya. Jika Anda tidak menentukan region tujuan, region saat ini digunakan secara default. Contoh: cn-shanghai.
ZoneIdID zona tujuan tempat Anda ingin mereplikasi sumber daya. Jika Anda mereplikasi sumber daya di region yang sama dan Anda tidak menentukan zona tujuan, zona dari sumber daya sumber digunakan untuk sumber daya yang direplikasi. Jika Anda mereplikasi sumber daya lintas region dan Anda tidak menentukan zona tujuan, sistem memfilter zona yang didukung oleh semua sumber daya. Contoh: cn-shanghai-b.
VpcIdID VPC tujuan tempat Anda ingin mereplikasi sumber daya. Jika Anda mereplikasi sumber daya di region yang sama dan Anda tidak menentukan VPC tujuan, VPC dari sumber daya sumber digunakan untuk sumber daya yang direplikasi. Jika Anda mereplikasi sumber daya lintas region dan Anda tidak menentukan VPC tujuan, sistem secara otomatis membuat VPC di region tujuan. Contoh: vpc-bp1hye0s8b69xokfu****.
VSwitchIdID vSwitch tujuan tempat Anda ingin mereplikasi sumber daya. Jika Anda mereplikasi sumber daya di region yang sama dan Anda tidak menentukan vSwitch tujuan, vSwitch dari sumber daya sumber digunakan untuk sumber daya yang direplikasi. Jika Anda mereplikasi sumber daya lintas region dan Anda tidak menentukan vSwitch tujuan, sistem secara otomatis membuat vSwitch di region tujuan. Contoh: vsw-bp11ufkwqwggtm1cj****.
NamePrefixPrefiks dari nama sumber daya. Secara default, nama sumber daya tidak berisi prefiks. Prefiks harus terdiri dari 2 hingga 32 karakter.
DisableNameUniqueMenentukan apakah akan menonaktifkan penegakan otomatis keunikan nama. Secara default, opsi ini diaktifkan. Untuk sumber daya yang memiliki fitur diaktifkan, seperti sumber daya Bucket, kode acak delapan karakter secara otomatis ditambahkan ke nama sumber daya untuk memastikan keunikan nama dari sumber daya yang direplikasi.
InstanceDataReplicationMenentukan apakah akan mereplikasi data instans ECS. Nilai default: false. Nilai yang valid:* true: mereplikasi data instans ECS. Jika Anda mereplikasi data di region yang sama, image khusus dibuat untuk instans sumber dan instans baru dibuat berdasarkan image khusus. Jika Anda mereplikasi data lintas region, image khusus dibuat untuk instans sumber dan direplikasi ke region tujuan. Instans baru dibuat berdasarkan image khusus.
  • false: tidak mereplikasi data instans ECS. | | InstancePeriod | Durasi langganan dari instans ECS langganan tujuan. Secara default, durasi langganan dari instans sumber digunakan. | | InstancePeriodUnit | Unit dari durasi langganan dari instans ECS langganan tujuan. Secara default, unit durasi langganan dari instans sumber digunakan. Nilai yang valid:* Week

  • Month

  • Year | | InstanceAmount | Jumlah instans ECS yang akan direplikasi. Parameter ini hanya berlaku ketika sumber daya sumber adalah satu instans ECS. | | RamAttachedPolicyReplication | Menentukan apakah akan mereplikasi kebijakan RAM yang terkait dengan pengguna RAM, grup pengguna, dan role. Nilai default: false. Nilai yang valid:* true

  • false | | AlbLoadBalancerEdition | Edisi dari instans ALB. Fitur dan aturan penagihan bervariasi berdasarkan edisi. Nilai yang valid:* Basic: Basic Edition

  • Standard: Standard Edition

  • StandardWithWaf: Edisi yang mengaktifkan Web Application Firewall (WAF). Contoh: Standard. | | AlbAddressType | Tipe alamat dari instans ALB. Nilai yang valid:* Internet: Instans ALB memiliki alamat IP publik. Nama domain Domain Name System (DNS) di-resolve ke alamat IP publik. Oleh karena itu, instans ALB dapat diakses melalui Internet.

  • Intranet: Instans ALB hanya memiliki alamat IP privat. Nama domain DNS di-resolve ke alamat IP privat. Oleh karena itu, instans ALB hanya dapat diakses dalam VPC tempat instans ALB di-deploy. Contoh: Internet. | | AlbAddressIpVersion | Versi IP. Nilai yang valid:* IPv4: IPv4

  • DualStack: dual stack. Contoh: IPv4. | | AlbZoneMappings | Pemetaan antara zona dan vSwitch. Anda dapat menentukan paling banyak 10 zona. Jika region yang dipilih mendukung dua atau lebih zona, pilih setidaknya dua zona untuk memastikan ketersediaan tinggi dari layanan Anda. Nilai adalah string JSON yang memiliki struktur yang sama dengan parameter ZoneMappings dalam operasi ALB CreateLoadBalancer. Contoh: [{"ZoneId": "cn-bejing-g": "VSwitchId": "vsw-gersdf****"}, {"ZoneId": "cn-bejing-f": "VSwitchId": "vsw-fersdf****"}] | | SlbListenerProtocols | Protokol listener dari instans CLB. Menentukan protokol listener yang akan disertakan dalam replikasi. Anda dapat mengatur satu atau lebih protokol, dipisahkan dengan koma. Secara default, tidak ada batasan yang diterapkan. Nilai yang valid:* tcp

  • udp

  • http

  • https. Contoh: tcp,udp. |

Catatan

Saat Anda mengatur ParameterKey ke InstanceDataReplication dan ParameterValue ke true, hentikan instans sumber sebelum Anda mereplikasi sumber daya untuk memastikan konsistensi data.

Skenario pemrofilan sumber daya

Tabel berikut menjelaskan nilai yang valid dari ParameterKey dan ParameterValue saat Anda mengatur TemplateScratchType ke ArchitectureDetection.

ParameterKeyParameterValue
RegionIdsSatu atau lebih ID region. Pisahkan beberapa ID region dengan koma (,). Region global global didukung. Jika Anda tidak menentukan region, region dari skenario digunakan.

Skenario pengelolaan sumber daya

Tabel berikut menjelaskan nilai yang valid dari ParameterKey dan ParameterValue saat Anda mengatur TemplateScratchType ke ResourceImport.

Catatan

Untuk skenario pengelolaan sumber daya, Anda harus mengatur ParameterKey ke DeletionPolicy.

ParameterKeyParameterValue
DeletionPolicyKebijakan penghapusan sumber daya. Nilai yang valid: Retain: mempertahankan sumber daya saat Anda menghapus stack yang Anda gunakan untuk mengelola sumber daya. Delete: menghapus sumber daya secara default saat Anda menghapus stack yang Anda gunakan untuk mengelola sumber daya. Jika Anda mempertahankan sumber daya tertentu saat kotak dialog Delete Stack muncul, sumber daya akan dipertahankan.
SlbListenerProtocolsProtokol listener dari instans CLB. Menentukan protokol listener yang akan disertakan dalam pengelolaan. Anda dapat mengatur satu atau lebih protokol, dipisahkan dengan koma. Secara default, tidak ada batasan yang diterapkan. Nilai yang valid: Nilai yang valid:* tcp
  • udp

  • http

  • https. Contoh: tcp,udp. |

Skenario migrasi sumber daya

Tabel berikut menjelaskan nilai yang valid dari ParameterKey dan ParameterValue saat Anda mengatur TemplateScratchType ke ResourceMigration.

ParameterKeyParameterValue
RegionIdID region tujuan tempat Anda ingin memigrasikan sumber daya. Jika Anda tidak menentukan region tujuan, region saat ini digunakan secara default. Contoh: cn-shanghai.
ZoneIdID zona tujuan tempat Anda ingin memigrasikan sumber daya. Jika Anda mereplikasi sumber daya di region yang sama dan Anda tidak menentukan zona tujuan, zona dari sumber daya sumber digunakan untuk sumber daya yang direplikasi. Jika Anda mereplikasi sumber daya lintas region dan Anda tidak menentukan zona tujuan, sistem memfilter zona yang didukung oleh semua sumber daya. Contoh: cn-shanghai-b.
VpcIdID VPC tujuan tempat Anda ingin memigrasikan sumber daya. Jika Anda mereplikasi sumber daya di region yang sama dan Anda tidak menentukan VPC tujuan, VPC dari sumber daya sumber digunakan untuk sumber daya yang direplikasi. Jika Anda mereplikasi sumber daya lintas region dan Anda tidak menentukan VPC tujuan, sistem secara otomatis membuat VPC di region tujuan. Contoh: vpc-bp1hye0s8b69xokfu****.
VSwitchIdID vSwitch tujuan tempat Anda ingin memigrasikan sumber daya. Jika Anda mereplikasi sumber daya di region yang sama dan Anda tidak menentukan vSwitch tujuan, vSwitch dari sumber daya sumber digunakan untuk sumber daya yang direplikasi. Jika Anda mereplikasi sumber daya lintas region dan Anda tidak menentukan vSwitch tujuan, sistem secara otomatis membuat vSwitch di region tujuan. Contoh: vsw-bp11ufkwqwggtm1cj****.
InstanceDataReplicationMenentukan apakah akan memigrasikan data instans ECS. Nilai yang valid: true: memigrasikan data instans ECS. Jika Anda memigrasikan data di region yang sama, image khusus dibuat untuk instans sumber dan instans baru dibuat berdasarkan image khusus. Jika Anda memigrasikan data lintas region, image khusus dibuat untuk instans sumber dan direplikasi ke region tujuan. Instans baru dibuat berdasarkan image khusus. false: tidak memigrasikan data instans ECS.

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

84980977-22F0-5421-B30D-B201311D5DCF

TemplateScratchId

string

ID skenario sumber daya.

ts-7f7a704cf71c49a6****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "84980977-22F0-5421-B30D-B201311D5DCF",
  "TemplateScratchId": "ts-7f7a704cf71c49a6****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.