すべてのプロダクト
Search

このプロダクト

    :UpdateStackTemplateByResources

    ドキュメントセンター

    :UpdateStackTemplateByResources

    最終更新日:Jun 03, 2026

    検出されたスタックドリフトを解消します。

    操作説明

    制限： ドリフトが発生したスタックのドリフトのみを解消できます。スタックのドリフトを解消するには、まず DetectStackDrift API を呼び出してドリフト検出を実行する必要があります。次に、GetStackDriftDetectionStatus API を呼び出してスタックのドリフトステータスをクエリして、スタックでドリフトが発生していることを確認します。最後に、UpdateStackTemplateByResources API を呼び出してドリフトを解消します。

    このトピックでは、ID が 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** のスタックのドリフトを解消します。このスタックは China (Hangzhou) リージョンにデプロイされています。

    今すぐお試しください

    この 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:UpdateStackTemplateByResources

    update

    *stack

    acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

    		 なし なし

    リクエスト構文

    POST /V2/UpdateStackTemplateByResources HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StackId

    string

    必須

    スタックの ID。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    DryRun

    boolean

    任意

    このリクエストで、修正後のテンプレートのプレビューのみを行う (ドライラン) かどうかを指定します。デフォルト値： false。有効な値：

    • true： 修正後のテンプレートの内容を返しますが、テンプレートは修正しません。Resource Orchestration Service (ROS) は、修正されたテンプレートと元のテンプレートを比較し、修正案を生成します。

    • false： テンプレートを修正してドリフトを解消します。

    説明

    DryRun パラメーターを true に設定して、修正後のテンプレートをプレビューすることを推奨します。テンプレートの内容が期待どおりである場合は、DryRun パラメーターを false に設定して修正を実行します。

    false
    RegionId

    string

    必須

    スタックが属するリージョン ID。DescribeRegions API を呼び出して、最新のリージョンリストをクエリできます。

    cn-hangzhou
    ClientToken

    string

    任意

    リクエストのべき等性を保証するために使用されるクライアントトークン。クライアント側で生成する値で、リクエストごとに一意である必要があります。

    トークンの長さは最大 64 文字で、文字、数字、ハイフン (-)、アンダースコア (_) を使用できます。

    詳細については、「べき等性を確保する方法」をご参照ください。

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

    string

    任意

    返されるテンプレート形式。デフォルト値： JSON。有効な値：

    • JSON

    • YAML

    JSON
    LogicalResourceId

    array

    任意

    リソースの論理 ID。

    Vpc

    string

    任意

    リソースをフィルタリングするために使用されるリソースの論理 ID。テンプレートの修正は、リスト内のリソースに対してのみ有効です。デフォルトでは、ドリフトしたすべてのリソースが修正されます。

    修正対象のリソースリストに DELETED 状態のリソースが含まれている場合、ROS は、新しいテンプレートの正確性を保証するために、リスト外にあるが、リスト内の削除済みリソースを参照しているリソースを調整することがあります。

    WebServer

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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    NewTemplateBody

    string

    修正後のテンプレートの内容。

    {\"ROSTemplateFormatVersion\": \"2015-09-01\", \"Resources\": {\"Vpc\": {\"Type\": \"ALIYUN::ECS::VPC\", \"Properties\": {\"VpcName\": \"test\", \"CidrBlock\": \"192.168.0.0/16\", \"Description\": \"test2\"}}}, \"Outputs\": {\"VpcId\": {\"Value\": {\"Fn::GetAtt\": [\"Vpc\", \"VpcId\"]}}}}
    OldTemplateBody

    string

    修正前のテンプレートの内容。

    {\"ROSTemplateFormatVersion\": \"2015-09-01\", \"Resources\": {\"Vpc\": {\"Type\": \"ALIYUN::ECS::VPC\", \"Properties\": {\"VpcName\": \"test\", \"CidrBlock\": \"192.168.0.0/16\", \"Description\": \"test1\"}}}, \"Outputs\": {\"VpcId\": {\"Value\": {\"Fn::GetAtt\": [\"Vpc\", \"VpcId\"]}}}}
    HTTP ステータスコードエラーコードエラーメッセージ説明
    400StackDriftDetectionNotAvailableThere is no complete drift detection for stack ({ID}).スタックでドリフト検出が完了していないため、エラーメッセージが返されます。ID はスタック ID を示します。
    400StackAlreadyInSyncThis is not need to correct stack drifts, stack ({ID}) is already in sync.ドリフトが存在せず、テンプレートの修正が不要なため、エラーメッセージが返されます。ID はスタック ID を示します。
    400CorrectStackDriftsFailure{reason}スタックを修正できないため、エラーメッセージが返されます。reason は具体的な理由を示します。
    404StackNotFoundThe Stack ({name}) could not be found.指定されたスタックが存在しないため、エラーメッセージが返されます。name はスタックの名前または ID を示します。
    404ResourceNotFoundThe Resource ({name}) could not be found in Stack {stack}.指定されたリソースが指定されたスタックに存在しないため、エラーメッセージが返されます。name はリソース名を示し、stack はスタックの名前または ID を示します。

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "NewTemplateBody": "{\\\"ROSTemplateFormatVersion\\\": \\\"2015-09-01\\\", \\\"Resources\\\": {\\\"Vpc\\\": {\\\"Type\\\": \\\"ALIYUN::ECS::VPC\\\", \\\"Properties\\\": {\\\"VpcName\\\": \\\"test\\\", \\\"CidrBlock\\\": \\\"192.168.0.0/16\\\", \\\"Description\\\": \\\"test2\\\"}}}, \\\"Outputs\\\": {\\\"VpcId\\\": {\\\"Value\\\": {\\\"Fn::GetAtt\\\": [\\\"Vpc\\\", \\\"VpcId\\\"]}}}}",
  "OldTemplateBody": "{\\\"ROSTemplateFormatVersion\\\": \\\"2015-09-01\\\", \\\"Resources\\\": {\\\"Vpc\\\": {\\\"Type\\\": \\\"ALIYUN::ECS::VPC\\\", \\\"Properties\\\": {\\\"VpcName\\\": \\\"test\\\", \\\"CidrBlock\\\": \\\"192.168.0.0/16\\\", \\\"Description\\\": \\\"test1\\\"}}}, \\\"Outputs\\\": {\\\"VpcId\\\": {\\\"Value\\\": {\\\"Fn::GetAtt\\\": [\\\"Vpc\\\", \\\"VpcId\\\"]}}}}"
}

    エラーコード

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

    変更履歴

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