すべてのプロダクト
Search

このプロダクト

    :ListTemplateScratches

    ドキュメントセンター

    :ListTemplateScratches

    最終更新日:Jun 17, 2026

    リソースシナリオのリストを照会します。

    操作説明

    この Topic では、中国 (杭州) リージョンのリソースシナリオのリストをクエリする例を示します。応答には、中国 (杭州) リージョンにリソース管理とリソースレプリケーションの 2 つのリソースシナリオがあることが示されています。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ros:ListTemplateScratches

    get

    *TemplateScratch

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リソースシナリオのリージョン ID。

    DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

    cn-hangzhou
    TemplateScratchId

    string

    任意

    リソースシナリオの ID。

    ts-7f7a704cf71c49a6****
    TemplateScratchType

    string

    任意

    リソースシナリオのタイプ。有効な値:

    • ArchitectureReplication: リソースレプリケーション。

    • ArchitectureDetection: リソース検出。

    • ResourceImport: リソース管理。

    • ResourceMigration: リソース移行。

    ArchitectureReplication
    Status

    string

    任意

    リソースシナリオのステータス。有効な値:

    • GENERATE_IN_PROGRESS: 生成中。

    • GENERATE_COMPLETE: 生成完了。

    • GENERATE_FAILED: 生成に失敗した。

    ["GENERATE_COMPLETE"]
    Tags

    array<object>

    任意

    リソースシナリオのタグ。

    object

    任意

    Key

    string

    必須

    リソースシナリオのタグキー。

    説明

    Tags は任意です。Tags を指定する場合、Tags.N.Key を指定する必要があります。

    usage
    Value

    string

    任意

    リソースシナリオのタグ値。

    test
    PageSize

    integer

    任意

    ページングクエリにおける 1 ページあたりのエントリ数。ページングの設定項目。

    最大値: 50。

    デフォルト値: 10。

    10
    PageNumber

    integer

    任意

    リソースシナリオリストのページ番号。

    開始値: 1。

    デフォルト値: 1。

    1
    ResourceGroupId

    string

    任意

    リソースグループ ID。

    rg-acfmxazb4ph6aiy****

    共通リクエストパラメーターの詳細については、共通パラメーター を参照してください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

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

    integer

    リソースシナリオの合計数。

    2
    PageNumber

    integer

    リソースシナリオリストのページ番号。

    1
    PageSize

    integer

    ページングクエリにおける 1 ページあたりのエントリ数。ページングの設定項目。

    10
    TemplateScratches

    array<object>

    リソースシナリオ。

    array<object>

    TemplateScratchId

    string

    リソースシナリオの ID。

    ts-48ad85d66cca4620****
    TemplateScratchType

    string

    リソースシナリオのタイプ。有効な値:

    • ResourceImport: リソース管理。

    • ArchitectureReplication: リソースレプリケーション。

    ResourceImport
    Status

    string

    リソースシナリオのステータス。

    GENERATE_COMPLETE
    StatusReason

    string

    リソースシナリオの生成に失敗した理由。

    説明

    このパラメーターは、Status が GENERATE_FAILED の場合にのみ返されます。

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

    string

    リソースシナリオの生成に失敗した理由を示す状態コード。有効な値:

    • InvalidZoneId: 無効なゾーン ID。

    • IncorrectInstanceStatus: インスタンスステータスがこの操作をサポートしていません。

    • RecommendEmpty.DiskCategoryNotRecommended: クラウドディスクカテゴリが利用できません。

    • Forbidden.RAM: RAM 権限が不足しています。

    説明

    このパラメーターは、Status が GENERATE_FAILED の場合にのみ返されます。

    この情報は呼び出しログに基づいて生成されており、不完全な場合があります。情報を確認してください。

    InvalidZoneId
    PreferenceParameters

    array<object>

    リソースシナリオの構成パラメーター。

    object

    ParameterKey

    string

    パラメーター名。

    DeletionPolicy
    ParameterValue

    string

    パラメーター値。

    Retain
    Description

    string

    リソースシナリオの説明。

    The description of the scenario.
    SourceResources

    array<object>

    ソースリソース。

    object

    ResourceId

    string

    リソース ID。

    vpc-m5eauuq80anx59v28****
    ResourceType

    string

    リソースタイプ。

    ALIYUN::ECS::VPC
    SourceTag

    object

    ソースタグ。

    ResourceTags

    object

    ソースタグ。

    {"a": "b"}
    ResourceTypeFilter

    array

    リソースをフィルタリングするためのリソースタイプ。

    string

    リソースをフィルタリングするためのリソースタイプ。

    ALIYUN::ECS::VPC
    SourceResourceGroup

    object

    ソースリソースグループ。

    ResourceGroupId

    string

    ソースリソースグループの ID。

    rg-acfmzawhxxc****
    ResourceTypeFilter

    array

    リソースをフィルタリングするためのリソースタイプ。

    string

    リソースをフィルタリングするためのリソースタイプ。

    ALIYUN::ECS::VPC
    LogicalIdStrategy

    string

    論理 ID 生成戦略。有効な値:

    • LongTypePrefixAndIndexSuffix (デフォルト): 長いタイププレフィックスとインデックスサフィックス。

    • LongTypePrefixAndHashSuffix: 長いタイププレフィックスとハッシュサフィックス。

    • ShortTypePrefixAndHashSuffix: 短いタイププレフィックスとハッシュサフィックス。

    LongTypePrefixAndIndexSuffix
    Tags

    array<object>

    リソースシナリオのタグ。

    object

    Key

    string

    リソースシナリオのタグキー。

    usage1
    Value

    string

    リソースシナリオのタグ値。

    test1
    CreateTime

    string

    リソースシナリオが作成された時間。時間は UTC+0 で表示され、Z サフィックスなしの ISO 8601 標準に従います。フォーマット: YYYY-MM-DDThh:mm:ss。

    2021-12-07T08:06:44
    UpdateTime

    string

    リソースシナリオが最後に更新された時間。時間は UTC+0 で表示され、Z サフィックスなしの ISO 8601 標準に従います。フォーマット: YYYY-MM-DDThh:mm:ss。

    2021-12-07T08:06:44
    ResourceGroupId

    string

    リソースグループ ID。

    rg-acfm4nxcvht4pmi

    例

    成功レスポンス

    JSONJSON

    {
  "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"
    }
  ]
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。