资源编排：资源（Resources）

属性值可以是文本字符串、字符串列表、布尔值、引用参数或者函数返回值。 当您编写JSON模板时，请参见以下规则。

• 如果属性值为文本字符串，该值会被双引号（" "）括起来。

• 如果属性值为任一类型的字符串列表，则会被方括号（[ ]）括起来。

• 如果属性值为内部函数或引用的参数，则会被大括号（{ }）括起来。

当您将文字、列表、引用参数和函数返回值合并起来取值时，上述规则也适用。声明不同的属性值类型示例如下：

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

当您需要你移除资源时，会面临两种情况：

• 当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

如以下代码段所示，根据MaxAmount的值判断否创建WebServer：

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::Str

  • Fn::Base64Decode

  • Fn::If

  • Fn::ListMerge

  • Fn::GetJsonValue

  • Fn::MergeMapToList

  • Fn::SelectMapList

  • Fn::Add

  • Fn::Avg

  • Fn::Str

  • Fn::Calculate

  • Fn::Max

  • Fn::Min

  • Fn::Jq

  • Fn::Length

  • Fn::GetAZs

  • Fn::Index

  • Fn::FormatTime

  • Fn::MarketplaceImage

• 处理后的模板资源总数需要符合限制，目前最多支持300个。

• 指定了Count的资源的属性（Properties）中可以使用伪参数ALIYUN::Index，在预处理的时候会被替换为相应的数值。例如，A[0]使用的ALIYUN::Index会被替换为0，A[1]使用的ALIYUN::Index会被替换为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，且B的Count为2，转换后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