Resource Orchestration Service:データ構造

パラメーター

タイプ

説明

ResourceChange

構造体

ROS に変更させたいリソースと、ROS にリソースに対して実行させたい操作。

タイプ

文字列

ROS に変更させたいエンティティのタイプ。

値を Resource に設定します。Resource の値は、エンティティがリソースであることを指定します。

パラメーター

タイプ

説明

アクション

文字列

リソースに対して ROS に実行させたい操作。有効な値:

• Add: リソースを作成します。

• Modify: リソースを変更します。

• Remove: リソースを解放します。

詳細

配列

リソースへの変更の詳細。Action パラメーターが Modify に設定されている場合にのみ、このパラメーターは有効になります。

論理リソース ID

文字列

リソースの論理 ID。論理 ID は、テンプレートで定義されているリソース名です。

物理リソース ID

文字列

リソースの物理 ID。Action パラメーターが Modify または Remove に設定されている場合にのみ、このパラメーターは有効になります。

置換

文字列

新しいリソースを作成し、既存のリソースを削除することでリソースを変更するかどうかを指定します。Action パラメーターが Modify に設定されている場合にのみ、このパラメーターは有効になります。

• ROS タイプのスタックの有効な値:

  • True: ROS は、新しいリソースを作成し、既存のリソースを削除することでリソースを変更します。RequiresRecreation パラメーターを Always に、Evaluation パラメーターを Static に設定した場合、Replacement パラメーターを True に設定する必要があります。

  • False: ROS は、新しいリソースを作成し、既存のリソースを削除することでリソースを変更しません。RequiresRecreation パラメーターを Never に、Evaluation パラメーターを Static に設定した場合、Replacement パラメーターを False に設定する必要があります。

  • Conditional: ROS は、新しいリソースを作成し、既存のリソースを削除することでリソースを変更する場合があります。RequiresRecreation パラメーターを Always に、Evaluation パラメーターを Dynamic に設定した場合、Replacement パラメーターを Conditional に設定する必要があります。

  説明

  RequiresRecreation パラメーターに複数の値を指定した場合、Replacement パラメーターの値は、最も影響の大きい RequiresRecreation 値に基づいて変化します。RequiresRecreation 値の影響は、Always、Conditional、Never の順に減少します。

• Terraform タイプのスタックの有効な値:

  • True: Terraform は、新しいリソースを作成し、既存のリソースを削除することでリソースを変更します。

  • False: Terraform は、新しいリソースを作成し、既存のリソースを削除することでリソースを変更しません。

リソースタイプ

文字列

リソースタイプ。

スコープ

文字列の配列

ROS が更新をトリガーするパラメーター。Action パラメーターが Modify に設定されている場合にのみ、このパラメーターは有効になります。有効な値:

• Properties: リソースの Properties パラメーター

• Metadata: リソースの Metadata パラメーター

• DeletionPolicy: リソースの DeletionPolicy パラメーター

プロパティの変更

ResourcePropertyChange の構造体配列

リソースプロパティへの変更。Action パラメーターが Modify に設定されている場合にのみ、このパラメーターは有効になります。詳細については、ResourcePropertyChange をご参照ください。

モジュール情報

ModuleInfo の構造体配列

リソースが作成されたモジュールに関する情報。このパラメーターは、リソースがモジュールから作成された場合にのみ返されます。詳細については、ModuleInfo をご参照ください。

パラメーター

タイプ

説明

変更ソース

文字列

ROS が更新をトリガーする理由。有効な値:

• ResourceReference: 参照されているリソースの物理 ID が変更される可能性があります。

• ParameterReference: テンプレートで参照されているパラメーターが変更される可能性があります。

• ResourceAttribute: 参照されているリソースの出力プロパティが変更される可能性があります。

• DirectModification: テンプレートが変更されています。

• Automatic: ALIYUN::ROS::Stack リソースタイプを使用して作成されたネストされたスタックが変更されていない場合、ROS は ChangeSource パラメーターを Automatic に設定します。これは、ネストされたスタックのテンプレートが変更されている可能性があるためです。親スタックを更新する前に、ROS はネストされたスタックのテンプレートを変更しません。

• System: リソースの入力値が変更されていない場合でも、ALIYUN::ROS::WaitConditionHandle などの特定の条件または内部メカニズムによって更新がトリガーされます。

原因となるエンティティ

文字列

ChangeSource パラメーターに関連付けられているエンティティ。以下の情報は、ChangeSource パラメーターと CausingEntity パラメーターの値の関係について説明しています。

• ChangeSource パラメーターを ResourceReference に設定した場合、CausingEntity パラメーターの値はリソース名です。

• ChangeSource パラメーターを ParameterReference に設定した場合、CausingEntity パラメーターの値はパラメーター名です。

• ChangeSource パラメーターを ResourceAttribute に設定した場合、CausingEntity パラメーターの値は リソース名.パラメーター名 の形式になります。

• ChangeSource パラメーターを DirectModification に設定した場合、CausingEntity パラメーターの値は null です。

• ChangeSource パラメーターを Automatic に設定した場合、CausingEntity パラメーターの値はリソース名です。

• ChangeSource パラメーターを System に設定した場合、CausingEntity パラメーターの値はリソース名です。

評価

文字列

ROS が目的の値を決定できるかどうか、および変更セットを実行する前に目的の値が変更されるかどうかを指定します。有効な値:

• Static: ROS は目的の値を決定でき、変更セットを実行する前に目的の値が変更されます。

• Dynamic: ROS は目的の値を決定できません。ROS がスタックを更新すると、Ref や Fn::GetAtt などの内部関数の結果に基づいて目的の値が変化する場合があります。

ターゲット

構造体

ROS が更新をトリガーするエンティティの詳細。

パラメーター

タイプ

説明

属性

文字列

ROS が更新をトリガーするパラメーター。有効な値:

• Properties: リソースの Properties パラメーター

• Metadata: リソースの Metadata パラメーター

• DeletionPolicy: リソースの DeletionPolicy パラメーター

名前

文字列

Attribute パラメーターを Properties に設定した場合、Name パラメーターの値はプロパティ名です。それ以外の場合、Name パラメーターの値は null です。

再作成が必要

文字列

プロパティの変更によってリソースの再作成が必要になるかどうかを指定します。Attribute パラメーターが Properties に設定されている場合にのみ、このパラメーターは有効になります。有効な値:

• Never: プロパティの変更によってリソースの再作成は必要ありません。

• Conditionally: プロパティの変更によってリソースの再作成が必要になる場合があります。

• Always: プロパティの変更によってリソースの再作成が必要になります。

パラメーター

タイプ

説明

名前

文字列

プロパティ名。

変更前の値

データ型はプロパティによって異なります。

ROS がプロパティを更新する前のプロパティの値。

変更後の値

データ型はプロパティによって異なります。

プロパティが更新された後のプロパティの値。

パラメーター

タイプ

説明

論理 ID 階層

文字列

リソースを含む 1 つ以上のモジュールの連結された論理 ID。モジュールは最も外側の層からリストされ、スラッシュ (/) で区切られます。

次の例では、リソースは親モジュール A 内にネストされたモジュール B から作成されます。

moduleA/moduleB

タイプ階層

文字列

リソースを含む 1 つ以上のモジュールの連結されたタイプ。モジュールタイプは最も外側の層からリストされ、スラッシュ (/) で区切られます。

次の例では、リソースは MODULE::ROS::Parent::Example タイプの親モジュール内にネストされた MODULE::ROS::Child::Example タイプのモジュールから作成されます。

MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example