Resource Orchestration Service:リソース

プロパティ値は、テキスト文字列、文字列のリスト、ブール値、参照パラメーター、または関数の戻り値のいずれかになります。JSON テンプレートを作成する際は、以下のルールに従ってください。

• プロパティ値がテキスト文字列の場合、二重引用符（" "）で囲みます。

• プロパティ値が文字列のリストの場合、角括弧（[]）で囲みます。

• プロパティ値が組み込み関数または参照パラメーターの場合、中括弧（{}）で囲みます。

これらのルールは、テキスト、リスト、参照パラメーター、関数の戻り値を組み合わせる場合にも適用されます。次の例では、さまざまなプロパティ値の型を宣言する方法を示します：

{
  "Properties": {
    "String": "string",
    "LiteralList": [
      "value1",
      "value2"
    ],
    "Boolean": true,
    "ReferenceForOneValue": {
      "Ref": "ResourceID"
    },
    "FunctionResultWithFunctionParams": {
      "Fn::Join": [
        "%",
        [
          "Key=",
          {
            "Ref": "SomeParameter"
          }
        ]
      ]
    }
  }
}

リソースを削除する際には、以下の 2 つのシナリオが考えられます：

• DeletionPolicy を Delete に設定した場合、スタックからリソースが削除されると、リソース自体も削除されます。

• DeletionPolicy を Retain に設定した場合、スタックからリソースが削除されても、リソースは保持されます。

たとえば、スタックの削除時に ECS インスタンスを保持するには、次のコードセグメントに示すようにポリシーを宣言します：

Resources:
  ECSInstance:
    Type: ALIYUN::ECS::Instance
    Properties:
      ImageId: m-25l0r****
    DeletionPolicy: Retain

この属性の使用方法を以下に示します：

• 単一のリソースへの依存：

  DependsOn: ResourceName

• 複数のリソースへの依存：

  DependsOn:
    - ResourceName1
    - ResourceName2

次のコードセグメントに示すように、WebServer は DatabaseServer の作成が正常に完了した後にのみ作成されます：

ROSTemplateFormatVersion: '2015-09-01'
Resources:
  WebServer:
    Type: ALIYUN::ECS::Instance
    DependsOn: DatabseServer
  DatabseServer:
    Type: ALIYUN::ECS::Instance
    Properties:
      ImageId: m-25l0r****
      InstanceType: ecs.t1.small

次のコードセグメントに示すように、WebServer の作成は MaxAmount の値に依存します：

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  MaxAmount:
    Type: Number
    Default: 1
Conditions:
  CreateWebServer:
    Fn::Not:
      Fn::Equals:
        - 0
        - Ref: MaxAmount
Resources:
  WebServer:
    Type: ALIYUN::ECS::InstanceGroup
    Condition: CreateWebServer
    Properties:
      ImageId: m-25l0rc****
      InstanceType: ecs.t1.small
      MaxAmount:
        Ref: MaxAmount
  DatabseServer:
    Type: ALIYUN::ECS::Instance
    Properties:
      ImageId: m-25l0r****
      InstanceType: ecs.t1.small

テンプレート内で、リソースに Count を指定すると、ROS はテンプレートを前処理し、そのリソースを複数のリソースに展開します。前処理後のテンプレートは、スタックに対する操作実行時に使用されます。

• たとえば、リソース名が A で、Count 値が 3 の場合、前処理後のテンプレートには A リソースは含まれません。代わりに、A[0]、A[1]、A[2] の 3 つのリソースが含まれます。

  Resources:
    A:
      Count: 3
      ...

  処理後：

  Resources:
    A[0]:
      ...
    A[1]:
      ...
    A[2]:
      ...

  重要

  A[1] のような展開後のリソース名が、元のテンプレートにすでに存在する場合、前処理は失敗し、テンプレートの検証に合格しません。

  既存のリソースに Count 属性を追加しないでください。これによりリソース名が変更され、削除操作がトリガーされます。

• Count の最終的な結果は、自然数である必要があります。サポートされる関数は以下のとおりです：

  • Ref（パラメーターのみを参照）

  • Fn::FindInMap

  • Fn::Select

  • Fn::Join

  • Fn::Split

  • Fn::Replace

  • Fn::Base64Encode

  • Fn::Base64Decode

  • Fn::If

  • Fn::ListMerge

  • Fn::GetJsonValue

  • Fn::MergeMapToList

  • Fn::SelectMapList

  • Fn::Add

  • Fn::Avg

  • Fn::Str

  • Fn::Calculate

  • Fn::Max

  • Fn::Min

• 前処理後のテンプレート内のリソース総数は、現在の上限である 300 を超えてはなりません。

• Properties 内で Count が指定されたリソースでは、疑似パラメーター ALIYUN::Index を使用できます。前処理中に、このパラメーターは対応する数値に置き換えられます。たとえば、ALIYUN::Index を使用する A[0] では 0 に、ALIYUN::Index を使用する A[1] では 1 に置き換えられます。ALIYUN::Index は、テンプレート内の他の場所では使用できません。

• Count が指定されたリソースが DependsOn に出現した場合、展開されます。

  DependsOn: A

  処理後:

  DependsOn:
    - A[0]
    - A[1]
    - A[2]

• Count が指定されたリソースが Ref または Fn::GetAtt 関数に出現した場合、展開されます。

  Ref: A
  Fn::GetAtt:
    - A
    - PropertyName

  処理後：

  - Ref: A[0]
  - Ref: A[1]
  - Ref: A[2]
  - Fn::GetAtt:
      - A[0]
      - PropertyName
  - Fn::GetAtt:
      - A[1]
      - PropertyName
  - Fn::GetAtt:
      - A[2]
      - PropertyName

  複数のリソースが Count を使用し、相互に参照関係がある場合、Fn::Select および ALIYUN::Index を併用できます。

  Fn::Select:
    - Ref: ALIYUN::Index
    - Ref: A

  A を例にとります。B が A を参照し、Count が 2 の場合、B の変換後の式の一部は、B[0] および B[1] について以下のようになります：

  - Ref: A[0]
  - Ref: A[1]

• リソースに Count 属性が設定されている場合、DependsOn 属性でも式がサポートされます。DependsOn 式で使用可能な関数は、Count 属性で使用可能な関数と同じであり、ALIYUN::Index 疑似パラメーターも使用できます。下表に、式の形式および許容される計算結果を示します。

  形式	例	許容される計算結果
  辞書	Fn::Split: - ',' - Server1,Server2	null 値が null の場合、DependsOn 属性は削除されます。
  		文字列 値が空文字列の場合、DependsOn 属性は削除されます。 値が空でない文字列の場合、有効なリソース名である必要があります。
  		リスト リスト項目が null または空文字列の場合、その項目は破棄されます。 リストが空の場合、DependsOn 属性は削除されます。 リストが空でない場合、各項目は文字列であり、有効なリソース名である必要があります。
  リスト	- Server0 - Fn::Split: - ',' - Server1,Server2	リスト項目は辞書または文字列のいずれかです。許容される計算結果は項目の種類によって異なります： リスト項目が辞書の場合、式が計算されます。許容される計算結果は以下のとおりです： 値が null または空文字列の場合、項目は破棄されます。 それ以外の場合、文字列であり、有効なリソース名である必要があります。 リスト項目が文字列の場合、有効なリソース名である必要があります。 説明 リストが空の場合、DependsOn 属性は削除されます。
  文字列	Server0	文字列 追加の処理は行われません。

  次の例のテンプレートでは、Count を使用して作成されるリソースの同時実行数を制御します。Count パラメーターは作成するリソースの数を指定し、ParallelCount パラメーターは最大同時実行数を指定します。

  ROSTemplateFormatVersion: '2015-09-01'
  Parameters:
    Count:
      Type: Number
    ParallelCount:
      Type: Number
  Resources:
    WaitConditionHandle:
      Type: ALIYUN::ROS::WaitConditionHandle
      Count:
        Ref: Count
      DependsOn:
        Fn::Select:
          - Fn::Calculate:
              - 1-{0}//{1}
              - 0
              - - Fn::Min:
                    - Ref: ALIYUN::Index
                    - Ref: ParallelCount
                - Ref: ParallelCount
          - - Fn::Replace:
                - index:
                    Fn::Calculate:
                      - '{0}-{1}'
                      - 0
                      - - Ref: ALIYUN::Index
                        - Ref: ParallelCount
                - WaitConditionHandle[index]

  前処理後のテンプレートは、Count および ParallelCount の値によって異なります：

  • Count を 3、ParallelCount を 1 に設定した場合、前処理後のテンプレートは以下のとおりです：

    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      WaitConditionHandle[0]:
        Type: ALIYUN::ROS::WaitConditionHandle
      WaitConditionHandle[1]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[0]
      WaitConditionHandle[2]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[1]
    Parameters:
      Count:
        Type: Number
      ParallelCount:
        Type: Number

  • Count を 5、ParallelCount を 2 に設定した場合、前処理後のテンプレートは以下のとおりです：

    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      WaitConditionHandle[0]:
        Type: ALIYUN::ROS::WaitConditionHandle
      WaitConditionHandle[1]:
        Type: ALIYUN::ROS::WaitConditionHandle
      WaitConditionHandle[2]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[0]
      WaitConditionHandle[3]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[1]
      WaitConditionHandle[4]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[2]
    Parameters:
      Count:
        Type: Number
      ParallelCount:
        Type: Number

  • Count を 5、ParallelCount を 3 に設定した場合、前処理後のテンプレートは以下のとおりです：

    ROSTemplateFormatVersion: '2015-09-01'
    Resources:
      WaitConditionHandle[0]:
        Type: ALIYUN::ROS::WaitConditionHandle
      WaitConditionHandle[1]:
        Type: ALIYUN::ROS::WaitConditionHandle
      WaitConditionHandle[2]:
        Type: ALIYUN::ROS::WaitConditionHandle
      WaitConditionHandle[3]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[0]
      WaitConditionHandle[4]:
        Type: ALIYUN::ROS::WaitConditionHandle
        DependsOn: WaitConditionHandle[1]
    Parameters:
      Count:
        Type: Number
      ParallelCount:
        Type: Number