All Products
Search

This Product

    Resource Orchestration Service:ListTemplateScratches

    Document Center

    Resource Orchestration Service:ListTemplateScratches

    Last Updated:Jun 17, 2026

    Mengkueri daftar skenario sumber daya.

    Deskripsi operasi

    Topik ini memberikan contoh cara mengkueri daftar skenario sumber daya di wilayah China (Hangzhou). Respons menunjukkan bahwa terdapat dua skenario sumber daya di wilayah China (Hangzhou): manajemen sumber daya dan replikasi sumber daya.

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

    get

    *TemplateScratch

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah skenario sumber daya.

    Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    TemplateScratchId

    string

    No

    ID skenario sumber daya.

    ts-7f7a704cf71c49a6****
    TemplateScratchType

    string

    No

    Jenis skenario sumber daya. Nilai yang valid:

    • ArchitectureReplication: replikasi sumber daya.

    • ArchitectureDetection: deteksi sumber daya.

    • ResourceImport: manajemen sumber daya.

    • ResourceMigration: migrasi sumber daya.

    ArchitectureReplication
    Status

    string

    No

    Status skenario sumber daya. Nilai yang valid:

    • GENERATE_IN_PROGRESS: sedang dibuat.

    • GENERATE_COMPLETE: sudah dibuat.

    • GENERATE_FAILED: gagal dibuat.

    ["GENERATE_COMPLETE"]
    Tags

    array<object>

    No

    Tag skenario sumber daya.

    object

    No

    Key

    string

    Yes

    Kunci tag skenario sumber daya.

    Catatan

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

    usage
    Value

    string

    No

    Nilai tag skenario sumber daya.

    test
    PageSize

    integer

    No

    Jumlah entri per halaman dalam kueri berpaginasi. Pengaturan untuk paginasi.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    PageNumber

    integer

    No

    Nomor halaman daftar skenario sumber daya.

    Nilai awal: 1.

    Nilai default: 1.

    1
    ResourceGroupId

    string

    No

    ID grup sumber daya.

    rg-acfmxazb4ph6aiy****

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    D1C09606-C58B-558F-9B4E-5BF263D17D09
    TotalCount

    integer

    Jumlah total skenario sumber daya.

    2
    PageNumber

    integer

    Nomor halaman daftar skenario sumber daya.

    1
    PageSize

    integer

    Jumlah entri per halaman dalam kueri berpaginasi. Pengaturan untuk paginasi.

    10
    TemplateScratches

    array<object>

    Skenario sumber daya.

    array<object>

    TemplateScratchId

    string

    ID skenario sumber daya.

    ts-48ad85d66cca4620****
    TemplateScratchType

    string

    Jenis skenario sumber daya. Nilai yang valid:

    • ResourceImport: manajemen sumber daya.

    • ArchitectureReplication: replikasi sumber daya.

    ResourceImport
    Status

    string

    Status skenario sumber daya.

    GENERATE_COMPLETE
    StatusReason

    string

    Alasan mengapa skenario sumber daya gagal dibuat.

    Catatan

    Parameter ini hanya dikembalikan jika Status bernilai GENERATE_FAILED.

    Resource ALIYUN::ECS::VPC vpc-m5eauuq80anx59v28**** could not be found for template scratch.
    FailedCode

    string

    Kode status yang menunjukkan mengapa skenario sumber daya gagal dibuat. Nilai yang valid:

    • InvalidZoneId: ID zona tidak valid.

    • IncorrectInstanceStatus: status instans tidak mendukung operasi ini.

    • RecommendEmpty.DiskCategoryNotRecommended: kategori cloud disk tidak tersedia.

    • Forbidden.RAM: izin RAM tidak memadai.

    Catatan

    Parameter ini hanya dikembalikan jika Status bernilai GENERATE_FAILED.

    Informasi ini dihasilkan berdasarkan log panggilan dan mungkin tidak lengkap. Verifikasi informasi tersebut.

    InvalidZoneId
    PreferenceParameters

    array<object>

    Parameter konfigurasi skenario sumber daya.

    object

    ParameterKey

    string

    Nama parameter.

    DeletionPolicy
    ParameterValue

    string

    Nilai parameter.

    Retain
    Description

    string

    Deskripsi skenario sumber daya.

    Deskripsi skenario.
    SourceResources

    array<object>

    Sumber daya asal.

    object

    ResourceId

    string

    ID sumber daya.

    vpc-m5eauuq80anx59v28****
    ResourceType

    string

    Jenis sumber daya.

    ALIYUN::ECS::VPC
    SourceTag

    object

    Tag asal.

    ResourceTags

    object

    Tag sumber.

    {"a": "b"}
    ResourceTypeFilter

    array

    Jenis sumber daya untuk memfilter sumber daya.

    string

    Jenis sumber daya untuk memfilter sumber daya.

    ALIYUN::ECS::VPC
    SourceResourceGroup

    object

    Grup sumber daya asal.

    ResourceGroupId

    string

    ID grup sumber daya sumber.

    rg-acfmzawhxxc****
    ResourceTypeFilter

    array

    Jenis sumber daya untuk memfilter sumber daya.

    string

    Jenis sumber daya untuk memfilter sumber daya.

    ALIYUN::ECS::VPC
    LogicalIdStrategy

    string

    Strategi pembuatan ID logis. Nilai yang valid:

    • LongTypePrefixAndIndexSuffix (default): prefiks jenis panjang dengan sufiks indeks.

    • LongTypePrefixAndHashSuffix: prefiks jenis panjang dengan sufiks hash.

    • ShortTypePrefixAndHashSuffix: prefiks jenis pendek dengan sufiks hash.

    LongTypePrefixAndIndexSuffix
    Tags

    array<object>

    Tag skenario sumber daya.

    object

    Key

    string

    Kunci tag skenario sumber daya.

    usage1
    Value

    string

    Nilai tag skenario sumber daya.

    test1
    CreateTime

    string

    Waktu ketika skenario sumber daya dibuat. Waktu ditampilkan dalam UTC+0 dan mengikuti standar ISO 8601 tanpa sufiks Z. Format: YYYY-MM-DDThh:mm:ss.

    2021-12-07T08:06:44
    UpdateTime

    string

    Waktu ketika skenario sumber daya terakhir diperbarui. Waktu ditampilkan dalam UTC+0 dan mengikuti standar ISO 8601 tanpa sufiks Z. Format: YYYY-MM-DDThh:mm:ss.

    2021-12-07T08:06:44
    ResourceGroupId

    string

    ID grup sumber daya.

    rg-acfm4nxcvht4pmi

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "D1C09606-C58B-558F-9B4E-5BF263D17D09",
  "TotalCount": 2,
  "PageNumber": 1,
  "PageSize": 10,
  "TemplateScratches": [
    {
      "TemplateScratchId": "ts-48ad85d66cca4620****",
      "TemplateScratchType": "ResourceImport",
      "Status": "GENERATE_COMPLETE",
      "StatusReason": "Resource ALIYUN::ECS::VPC vpc-m5eauuq80anx59v28**** could not be found for template scratch.",
      "FailedCode": "InvalidZoneId",
      "PreferenceParameters": [
        {
          "ParameterKey": "DeletionPolicy",
          "ParameterValue": "Retain"
        }
      ],
      "Description": "Mengelola sumber daya VPC.",
      "SourceResources": [
        {
          "ResourceId": "vpc-m5eauuq80anx59v28****",
          "ResourceType": "ALIYUN::ECS::VPC"
        }
      ],
      "SourceTag": {
        "ResourceTags": {
          "a": "b"
        },
        "ResourceTypeFilter": [
          "ALIYUN::ECS::VPC"
        ]
      },
      "SourceResourceGroup": {
        "ResourceGroupId": "rg-acfmzawhxxc****",
        "ResourceTypeFilter": [
          "ALIYUN::ECS::VPC"
        ]
      },
      "LogicalIdStrategy": "LongTypePrefixAndIndexSuffix",
      "Tags": [
        {
          "Key": "usage1",
          "Value": "test1"
        }
      ],
      "CreateTime": "2021-12-07T08:06:44",
      "UpdateTime": "2021-12-07T08:06:44",
      "ResourceGroupId": "rg-acfm4nxcvht4pmi"
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.