全部产品
Search

搜索本产品

    Resource Orchestration Service：ListTemplateScratches

    文档中心

    Resource Orchestration Service：ListTemplateScratches

    更新时间：Dec 15, 2025

    Mengambil daftar skenario.

    Deskripsi operasi

    Pada contoh ini, skenario yang dibuat di wilayah China (Hangzhou) diambil. Dalam respons, dikembalikan satu skenario Resource Management dan satu skenario tipe Resource Replication.

    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 dari skenario tersebut.

    Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.

    cn-hangzhou
    TemplateScratchId

    string

    No

    ID skenario tersebut.

    ts-7f7a704cf71c49a6****
    TemplateScratchType

    string

    No

    Tipe skenario sumber daya. Nilai yang valid:

    • ArchitectureReplication: resource replication

    • ArchitectureDetection: resource detection

    • ResourceImport: resource management

    • ResourceMigration: resource migration

    ArchitectureReplication
    Status

    string

    No

    Status skenario tersebut. Nilai yang valid:

    • GENERATE_IN_PROGRESS: Skenario sedang dibuat.

    • GENERATE_COMPLETE: Skenario telah dibuat.

    • GENERATE_FAILED: Pembuatan skenario gagal.

    ["GENERATE_COMPLETE"]
    Tags

    array<object>

    No

    Tag skenario tersebut.

    object

    No

    Key

    string

    Yes

    Kunci tag skenario tersebut.

    Catatan

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

    usage
    Value

    string

    No

    Nilai tag skenario tersebut.

    test
    PageSize

    integer

    No

    Jumlah entri yang dikembalikan per halaman.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    PageNumber

    integer

    No

    Nomor halaman yang dikembalikan.

    Halaman dimulai dari halaman 1.

    Nilai default: 1

    1
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-acfmxazb4ph6aiy****

    Untuk informasi selengkapnya mengenai parameter permintaan umum, lihat Common parameters.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

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

    integer

    Jumlah total skenario.

    2
    PageNumber

    integer

    Nomor halaman yang dikembalikan.

    1
    PageSize

    integer

    Jumlah entri yang dikembalikan per halaman.

    10
    TemplateScratches

    array<object>

    Skenario sumber daya.

    array<object>

    TemplateScratchId

    string

    ID skenario sumber daya.

    ts-48ad85d66cca4620****
    TemplateScratchType

    string

    Tipe skenario sumber daya. Nilai yang valid:

    • ResourceImport: resource management

    • ArchitectureReplication: resource replication

    ResourceImport
    Status

    string

    Status skenario sumber daya.

    GENERATE_COMPLETE
    StatusReason

    string

    Alasan kegagalan pembuatan skenario sumber daya.

    Catatan

    Parameter ini hanya dikembalikan jika nilai Status adalah GENERATE_FAILED.

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

    string

    Kode status skenario sumber daya yang gagal dibuat.

    Catatan

    Parameter ini hanya dikembalikan jika nilai Status adalah GENERATE_FAILED.

    InvalidZoneId
    PreferenceParameters

    array<object>

    Parameter preferensi skenario sumber daya.

    object

    ParameterKey

    string

    Nama parameter.

    DeletionPolicy
    ParameterValue

    string

    Nilai parameter.

    Retain
    Description

    string

    Deskripsi skenario sumber daya.

    The description of the scenario.
    SourceResources

    array<object>

    Sumber daya asal.

    object

    ResourceId

    string

    ID sumber daya.

    vpc-m5eauuq80anx59v28****
    ResourceType

    string

    Tipe sumber daya.

    ALIYUN::ECS::VPC
    SourceTag

    object

    Tag asal.

    ResourceTags

    object

    Tag asal.

    {"a": "b"}
    ResourceTypeFilter

    array

    Tipe sumber daya untuk memfilter sumber daya.

    string

    Tipe sumber daya untuk memfilter sumber daya.

    ALIYUN::ECS::VPC
    SourceResourceGroup

    object

    Kelompok sumber daya asal.

    ResourceGroupId

    string

    ID kelompok sumber daya asal.

    rg-acfmzawhxxc****
    ResourceTypeFilter

    array

    Tipe sumber daya untuk memfilter sumber daya.

    string

    Tipe sumber daya untuk memfilter sumber daya.

    ALIYUN::ECS::VPC
    LogicalIdStrategy

    string

    Kebijakan yang digunakan untuk menghasilkan ID logis. Nilai yang valid:

    • LongTypePrefixAndIndexSuffix (default): awalan tipe panjang + akhiran tipe indeks

    • LongTypePrefixAndHashSuffix: awalan tipe panjang + akhiran tipe hash

    • ShortTypePrefixAndHashSuffix: awalan tipe pendek + akhiran tipe 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 pembuatan skenario sumber daya.

    Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.

    2021-12-07T08:06:44
    UpdateTime

    string

    Waktu pembaruan skenario sumber daya.

    Waktu mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ss. Waktu ditampilkan dalam UTC.

    2021-12-07T08:06:44
    ResourceGroupId

    string

    ID kelompok 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": "纳管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.