ContinueCreateStack - Resource Orchestration Service (ROS) - Alibaba Cloud -

スタックの作成に失敗した後も、スタックの作成を続行します。

操作説明

このトピックでは、スタックの作成に失敗した後にスタックの作成を再開する方法について例を示します。この例では、ID が 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** のスタックを中国 (杭州) リージョンに作成します。

今すぐお試しください

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

update

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
StackId	string	必須	スタック ID。	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
RegionId	string	必須	スタックのリージョン ID。最新のリージョン一覧を照会するには、DescribeRegions 操作を呼び出します。	cn-hangzhou
RamRoleName	string	任意	RAM ロールの名前。Resource Orchestration Service (ROS) は RAM ロールを偽装してスタックを作成し、Alibaba Cloud サービスの API を呼び出す際にそのロールの認証情報を使用します。 ROS はスタックに対する操作を実行する際に RAM ロールを偽装します。スタックに対する操作の権限があっても RAM ロールを使用する権限がない場合でも、ROS は RAM ロールを偽装します。そのため、RAM ロールには最小権限が付与されていることを確認してください。このパラメーターを指定しない場合、ROS はスタックに関連付けられている既存のロールを偽装します。利用可能なロールがない場合は、ご利用のアカウントの認証情報から生成された一時認証情報を使用します。 RAM ロールの名前の長さは最大 64 バイトです。	test-role
Mode	string	任意	ROS がスタックの作成を再開するモード。有効値： Recreate (デフォルト) このパラメーターを Recreate に設定すると、ROS は以下のタイプのリソースのみ作成を再開します。作成に失敗したリソース RecreatingResources.N で指定したリソース RecreatingResources.N で指定したリソースの依存関係にあるリソースまだ作成されていないリソース説明 RecreatingResources.N、TemplateBody、TemplateURL、および Parameters は、Mode が Recreate に設定されている場合にのみ有効です。 Ignore ROS は作成に失敗したリソースおよびまだ作成されていないリソースを無視して破棄し、スタックが正常に作成されたと見なします。スタック作成に使用するテンプレートの本文が変更されます。説明このモードは ROS スタックでのみ使用できます。	Recreate
TemplateBody	string	任意	テンプレート本文を含む構造。テンプレート本文の長さは 1～524,288 バイトである必要があります。テンプレート本文の長さが上限を超える場合は、URL が長くなりすぎてリクエストが失敗するのを防ぐため、HTTP POST リクエストボディにパラメーターを追加することを推奨します。 ROS テンプレートには以下の制限があります。テンプレート内で変更できるセクションは、Description、Metadata、Resources、Outputs のみです。テンプレートにセクションを追加したり、セクションを削除したりすることはできません。 Resources セクションには以下の制限があります。作成を再開したくないリソースについては、リソースを削除したりテンプレート本文を変更したりすることはできません。作成を再開したいリソースについては、リソースを削除したりテンプレート本文を変更したりすることができます。このセクションにリソースを追加できます。説明このパラメーターは、Mode が Recreate に設定されている場合にのみ有効です。 TemplateBody、TemplateURL、および TemplateId のうち、いずれか 1 つのみを指定できます。これらのパラメーターを指定しない場合は、既存のテンプレートが使用されます。	{"ROSTemplateFormatVersion": "2015-09-01"}
TemplateURL	string	任意	テンプレート本文を含むファイルの URL。URL は HTTP または HTTPS Web サーバー、または Object Storage Service (OSS) バケット (例：oss://ros/template/demo または oss://ros/template/demo?RegionId=cn-hangzhou) 上のテンプレートを指している必要があります。テンプレート本文の長さは最大 524,288 バイトです。 OSS バケットのリージョン ID を指定しない場合、RegionId の値が使用されます。説明このパラメーターは、Mode が Recreate に設定されている場合にのみ有効です。TemplateURL を指定する場合、このトピックで TemplateBody について説明されている制限が適用されます。 TemplateBody、TemplateURL、および TemplateId のうち、いずれか 1 つのみを指定できます。これらのパラメーターを指定しない場合は、既存のテンプレートが使用されます。	oss://ros-template/demo
DryRun	boolean	任意	リクエスト内でスタックの検証のみを行うかどうかを指定します。有効値： true：スタックの検証のみを行います。 false (デフォルト)：スタックを検証して作成を再開します。	false
TemplateId	string	任意	テンプレート ID。このパラメーターは共有テンプレートおよびプライベートテンプレートに適用されます。説明このパラメーターは、`Mode` が `Recreate` に設定されている場合に有効です。TemplateId を指定する場合、このトピックで `TemplateBody` について説明されている制限が適用されます。 TemplateBody、TemplateURL、および TemplateId のうち、いずれか 1 つのみを指定できます。これらのパラメーターを指定しない場合は、既存のテンプレートが使用されます。	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	任意	テンプレートのバージョン。このパラメーターは TemplateId を指定した場合にのみ有効です。	v1
RecreatingResources	array	任意	作成に失敗した後に ROS が作成を再開するリソース。作成を再開するリソースに新しいリソースを追加できます。ROS は新しいリソースのすべての依存関係を再開します。説明このパラメーターは ROS スタックでのみ使用できます。	WebServer
	string	任意	作成に失敗した後に ROS が作成を再開するリソース。作成を再開するリソースに新しいリソースを追加できます。ROS は新しいリソースのすべての依存関係を再開します。説明このパラメーターは ROS スタックでのみ使用できます。	WebServer
Parameters	array<object>	任意	特定のパラメーターをオーバーライドするために使用するテンプレートパラメーター。
	object	任意
ParameterKey	string	必須	特定のパラメーターをオーバーライドするために使用するテンプレートパラメーター N の名前。テンプレートパラメーターの名前と値を指定しない場合、ROS はスタック作成のために以前に実行された操作で指定された名前と値を使用します。N の最大値は 200 です。説明このパラメーターは、Mode が Recreate に設定されている場合にのみ有効です。	Amount
ParameterValue	string	必須	特定のパラメーターをオーバーライドするために使用するテンプレートパラメーター N の値。N の最大値は 200 です。 ROS スタックの場合、特定のパラメーターをオーバーライドするために使用するテンプレートパラメーターには以下の制限があります。テンプレートの Conditions セクション内の条件値を true から false、または false から true に変更することはできません。テンプレートパラメーターは、ROS が作成を再開するリソースからのみ参照できます。説明このパラメーターは、Mode が Recreate に設定されている場合にのみ有効です。	12
Parallelism	integer	任意	リソースに対して同時に実行できる操作の最大数。デフォルトでは、このパラメーターは空です。0 以上の整数を設定できます。説明 0 より大きい整数を設定した場合、その整数が使用されます。このパラメーターを 0 に設定した場合、ROS スタックには制限がありません。ただし、Terraform スタックには Terraform のデフォルト値が使用されます。通常、Terraform のデフォルト値は 10 です。このパラメーターを空のままにした場合、前回のリクエストで指定した値が使用されます。前回のリクエストでこのパラメーターを空のままにしていた場合、ROS スタックには制限がありません。ただし、Terraform スタックには Terraform のデフォルト値が使用されます。通常、Terraform のデフォルト値は 10 です。このパラメーターに特定の値を設定した場合、ROS はその値をスタックに関連付けます。この値はスタックに対する後続の操作に影響します。	1
RecreatingOptions	array	任意	ROS がスタックの作成を再開する際に採用するオプション。
	string	任意	ROS がスタックの作成を再開する際に採用するオプション。このパラメーターは、`Mode` が `Recreate` に設定されている場合に有効です。有効値： TryToFixSignalFailureByRerunEcsCommand：ROS は FAILURE タイプの既存の信号を修正しようと試みます。ALIYUN::ROS::WaitCondition リソースの作成に失敗した場合、ROS は関連付けられた ALIYUN::ECS::RunCommand および ALIYUN::ECS::Invocation リソースと関連する依存関係を使用して、ALIYUN::ROS::WaitCondition リソースを再作成します。説明この値は ROS スタックでのみ有効です。 IgnoreExistingSignalFailure：ROS は FAILURE タイプの既存の信号を無視します。ALIYUN::ROS::WaitCondition リソースの作成に失敗した場合、スタックの作成を再開すると、そのリソースは正常に作成されたと見なされます。説明この値は ROS スタックでのみ有効です。 AutoRecreatingResources：ROS はテンプレートの内容または参照されるパラメーターが変更されたリソースと関連する依存関係を自動的に再作成します。このオプションにより、RecreatingResources.N の構成が容易になりますが、不要なリソースも再作成される可能性があります。説明この値は ROS スタックでのみ有効です。 CreateNewPrepaidInstance：サブスクリプションリソースの作成に失敗した場合、または正常に作成されたサブスクリプションリソースを ROS で再作成する場合、ROS は新しいサブスクリプションインスタンスを作成します。説明この値は ROS スタックでのみ有効です。サブスクリプションインスタンスがすでに作成されている場合、サブスクリプションリソースは削除できないため、ROS はそのサブスクリプションインスタンスを保持します。 RecreatingOptions.N に CreateNewPrepaidInstance を設定しない場合、ROS は既存のインスタンスを再利用しようと試みます。ROS がインスタンスを再利用する場合、リソースプロパティを変更できないか、または少数のリソースプロパティのみを変更できます。	CreateNewPrepaidInstance

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

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	B288A0BE-D927-4888-B0F7-B35EF84B6E6
StackId	string	スタック ID。	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
DryRunResult	object	検証結果。
ParametersAllowedToBeModified	array	変更可能なパラメーター。
	string	変更可能なパラメーター。このパラメーターの変更操作は検証エラーを引き起こしません。説明このパラメーターは DryRun が `true` に設定されている場合にのみ返されます。ParametersAllowedToBeModified の値は、Mode、Template*、RecreatingResources.N、および RecreatingOptions.N の値に基づいて異なります。	description
ParametersConditionallyAllowedToBeModified	array	特定の条件下で変更可能なパラメーター。
	string	特定の条件下で変更可能なパラメーター。パラメーターの新しい値によって、変更操作が検証エラーを引き起こすかどうかが決まります。説明このパラメーターは DryRun が `true` に設定されている場合にのみ返されます。ParametersConditionallyAllowedToBeModified の値は、Mode、Template*、RecreatingResources.N、および RecreatingOptions.N の値に基づいて異なります。	name
ParametersNotAllowedToBeModified	array	変更できないパラメーター。
	string	変更できないパラメーター。このパラメーターの変更操作は検証エラーを引き起こします。説明このパラメーターは DryRun が `true` に設定されている場合にのみ返されます。ParametersNotAllowedToBeModified の値は、Mode、Template*、RecreatingResources.N、および RecreatingOptions.N の値に基づいて異なります。	cidr

例

成功レスポンス

JSONJSON

{
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
  "DryRunResult": {
    "ParametersAllowedToBeModified": [
      "description"
    ],
    "ParametersConditionallyAllowedToBeModified": [
      "name"
    ],
    "ParametersNotAllowedToBeModified": [
      "cidr"
    ]
  }
}

エラーコード

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

変更履歴

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