函数（Functions）
资源编排服务提供多个内部函数，帮助您管理资源栈。您可以在定义资源（Resources）和输出（Outputs）时，使用内部函数。
可在资源栈模板中使用的内部函数包括：Fn::Str、Fn::Base64Encode、Fn::Base64Decode、Fn::FindInMap、Fn::GetAtt、Fn::Join、Fn::Sub、Fn::Select、Ref、Fn::GetAZs、Fn::Replace、Fn::Split、Fn::Equals、Fn::And、Fn::Or、Fn::Not、Fn::Index、Fn::If、Fn::Length、Fn::ListMerge、Fn::GetJsonValue、Fn::MergeMapToList、Fn::Avg、Fn::SelectMapList、Fn::Add、Fn::Calculate、Fn::Max、Fn::Min、Fn::GetStackOutput、Fn::Jq、Fn::FormatTime、Fn::MarketplaceImage和Fn::Any。
Fn::Str
内部函数Fn::Str返回输入数字的字符串结果。
声明
Fn::Str: toString参数
toString：需要转换的Number/Integer类型的值。返回值
该值的字符串类型。
示例
Fn::Str: 123456返回：
"123456"。
Fn::Base64Encode
内部函数Fn::Base64Encode返回输入字符串的Base64编码结果。
声明
Fn::Base64Encode: stringToEncode参数
stringToEncode：转换成Base64的字符串。返回值
用Base64表示的原始字符串。
示例
Fn::Base64Encode: string to encode返回：
string to encode。
Fn::Base64Decode
内部函数Fn::Base64Decode返回Base64编码的字符串解码的结果。
声明
Fn::Base64Decode: stringToEncode参数
stringToDecode：将Base64编码的字符串解码。返回值
字符串。
示例
Fn::Base64Decode: c3RyaW5nIHRvIGVuY29kZQ==返回：
c3RyaW5nIHRvIGVuY29kZQ==。
Fn::FindInMap
内部函数Fn::FindInMap返回与Mappings声明的双层映射中的键对应的值。
声明
Fn::FindInMap: - MapName - TopLevelKey - SecondLevelKey参数
MapName：Mappings中所声明映射的ID，包含键和值。TopLevelKey：第一级键，其值是一个键/值对列表。SecondLevelKey：第二级键，其值是一个字符串或者数字。
返回值
分配给SecondLevelKey的值。
示例
在创建名为WebServer的资源时，需要指定ImageId属性。在Mappings中，描述根据区域区分的ImageId映射。在Parameters中，描述需要用户指定的区域。Fn::FindInMap会根据用户指定的区域，在RegionMap中查找对应的ImageId映射，然后在映射中找到对应的ImageId。
MapName可按照个人意愿设置。在本示例中为
RegionMap。TopLevelKey设置为创建资源栈的地区。在本示例中，通过
Ref: regionParam确定。SecondLevelKey设置为所需的架构。在本示例中为
"32"。
ROSTemplateFormatVersion: '2015-09-01' Parameters: regionParam: Description: 选择创建ECS的区域 Type: String AllowedValues: - hangzhou - beijing Mappings: RegionMap: hangzhou: '32': m-25l0rcfjo '64': m-25l0rcfj1 beijing: '32': m-25l0rcfj2 '64': m-25l0rcfj3 Resources: WebServer: Type: ALIYUN::ECS::Instance Properties: ImageId: Fn::FindInMap: - RegionMap - Ref: regionParam - '32' InstanceType: ecs.t1.small SecurityGroupId: sg-25zwc**** ZoneId: cn-beijing-b Tags: - Key: key1 Value: value1 - Key: key2 Value: value2支持的函数
Fn::FindInMap
Ref
Fn::GetAtt
内部函数Fn::GetAtt返回模板中的资源的属性值。
场景一：Fn::GetAtt函数用于资源栈
声明
Fn::GetAtt: - resourceID - attributeName参数
resourceID：资源栈中资源的ID。attributeName：资源栈中资源的属性名称。
返回值
属性值。
示例
返回Resource ID为MyEcsInstance的ImageId属性。
Fn::GetAtt: - MyEcsInstance - ImageID
场景二：Fn::GetAtt函数用于嵌套资源栈
声明
Fn::GetAtt: - nestedStack - Outputs.attributeName参数
nestedStack：嵌套资源栈的名称。Outputs.attributeName：Outputs.前缀固定，attributeName为嵌套资源栈输出的属性名称。
返回值
嵌套资源栈的输出值。
示例
关于示例的更多信息，请参见ALIYUN::ROS::Stack。
Fn::Join
内部函数Fn::Join将一组值连接起来，用特定分隔符隔开。
Fn::Sub和Fn::Join均可用于拼接字符串。Fn::Join只能把多个字符串拼接成一个字符串，而Fn::Sub可以把多个字符串或数字拼接成字符串，更为简洁和直观，因此推荐您使用Fn::Sub。
声明
Fn::Join: - delimiter - - string1 - string2 - ...参数
delimiter：分隔符。分隔符可以为空，表示将所有的值直接连接起来。string1, string2, ...：被连接起来的值列表。
返回值
被连接起来的字符串。
示例
Fn::Join: - ',' - - a - b - c返回：
a, b, c。支持的函数
Fn::Base64Encode
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Fn::Sub
内部函数Fn::Sub用于将输入字符串中的变量替换为您指定的值。
声明
Fn::Sub: - String - Var1Name: Var1Value Var2Name: Var2Value ...: Null参数
String
一个能进行变量替换的字符串，ROS在运行时会将这些变量替换为指定值。以
${VarName}形式编写变量，变量可以是模板参数、伪参数、资源逻辑ID、资源属性或键值映射中的变量等。如果您仅指定模板参数、伪参数、资源逻辑ID和资源属性，则不需要指定键值映射。如果您指定模板参数名、伪参数或资源逻辑ID（如
${MyParameter}），则ROS返回的值与您使用Ref内部函数时返回的值相同。如果您指定资源属性（如${MyInstance.InstanceId}），则ROS返回的值与您使用Fn::GetAtt内部函数时返回的值相同。要按字面书写美元符号（$）和大括号（{ }），请在左大括号后面添加感叹号（!），如
${!Literal}。ROS将该文本解析为${Literal}。VarName
String参数中包含的变量的名称。
VarValue
ROS在运行时要将关联的变量名称替换为的值。
如果不需要使用键值映射，可使用以下声明方式：
Fn::Sub: String返回值
ROS返回原始字符串，并替换所有变量的值。
示例
ROSTemplateFormatVersion: '2015-09-01' Parameters: VpcName: Type: String Default: vpc Resources: Vpc: Type: ALIYUN::ECS::VPC Properties: VpcName: Ref: VpcName CidrBlock: 10.0.XX.XX Outputs: Pseudo: Value: Fn::Sub: - 'Var1: ${Var1}, Var2: ${Var2}, StackName: ${ALIYUN::StackName}, Region: ${ALIYUN::Region}' - Var1: Var1Value Var2: Var2Value VpcId: Value: Fn::Sub: '资源的返回值：${Vpc.VpcId}, 资源ID: ${Vpc}'返回
Var1: Var1Value, Var2: Var2Value, StackName: SubTest, Region: cn-hangzhou 资源的返回值：vpc-bp11eu7avmtvr37hl****, 资源ID: vpc-bp11eu7avmtvr37hl****
Fn::Select
内部函数Fn::Select通过索引返回列表或字典中的数据。
声明
获取列表（数组）中的数据
根据索引获取单个数据
Fn::Select: - index - - value1 - value2 - ...Fn::Select: - index - - value1 - value2 - ... - default_value获取多个数据
Fn::Select: - start:stop - - value1 - value2 - ...Fn::Select: - start:stop:step - - value1 - value2 - ...
获取字典（映射表）某个键对应的值：
Fn::Select: - key - key1: value1 key2: value2 ...: NullFn::Select: - key - key1: value1 key2: value2 ...: Null - default_value
参数
index：待检索数据的索引。索引是0到N-1之间或-N到-1之间的某个值（其中N代表列表中元素的数量），负数表示从右往左第几个元素。如果索引不在取值范围内，若指定了默认值则返回默认值，若未指定则返回空字符串。start、stop和step：根据指定的起始位置和终止位置获取列表中的元素，可以指定步长，即每隔step-1个元素取一个元素，返回一个列表。start:stop：start、stop取值同index，start不填时默认为0，stop不填时默认为N。返回列表中第start+1到第stop个元素组成的列表，如果二者取值不在取值范围内则返回空列表。start:stop:step：step不填时默认为1，如果step为负数，则start表示的元素的索引应大于stop表示的元素的索引，从第start个元素到第stop+1元素，每隔-step-1个元素取一个元素，返回一个列表。
key：字典的某个键，返回键对应的值。如果字典中不存在该键，若指定了默认值则返回默认值，若未指定则返回空字符串。default_value：index或key未命中时的默认值。如未指定，则为空字符串。
返回值
选定的数据。
示例
从列表或数组中取值：
Fn::Select: - '1' - - apples - grapes - oranges - mangoes返回：
"grapes"。Fn::Select: - '1:3' - - 1 - 2 - 3 - 4 - 5返回：
[2, 3]Fn::Select: - '::2' - - 1 - 2 - 3 - 4 - 5返回：
[1, 3, 5]Fn::Select: - 5:0:-2 - - 1 - 2 - 3 - 4 - 5返回：
[5, 3]
获取字典某个键对应的值：
Fn::Select: - key1 - key1: grapes key2: mangoes返回：
grapes。如果数据元列表是一个CommaDelimitedList：
Parameters: userParam: Type: CommaDelimitedList Default: 10.0.0.1, 10.0.0.2, 10.0.0.3 Resources: resourceID: Properties: CidrBlock: Fn::Select: - '0' - Ref: userParam返回：
10.0.0.1
支持的函数
对于Fn::Select索引值，您可以使用Ref函数。
对于对象的Fn::Select列表，您可以使用以下函数：
Fn::Base64Encode
Fn::FindInMap
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Ref
内部函数Ref返回指定参数或资源的值。
如果指定参数是Resource ID，则返回资源的值。否则系统将认为指定参数是参数，将尝试返回参数的值。
声明
Ref: logicalName参数
logicalName：要引用的资源或参数的逻辑名称。返回值
资源的值或者参数的值。
示例
使用Ref函数指定regionParam作为WebServer的RegionMap的区域参数。
ROSTemplateFormatVersion: '2015-09-01' Parameters: regionParam: Description: 选择创建ECS的区域 Type: String AllowedValues: - hangzhou - beijing Mappings: RegionMap: hangzhou: '32': m-25l0rcfjo '64': m-25l0rcfj1 beijing: '32': m-25l0rcfj2 '64': m-25l0rcfj3 Resources: WebServer: Type: ALIYUN::ECS::Instance Properties: ImageId: Fn::FindInMap: - RegionMap - Ref: regionParam - '32' InstanceType: ecs.t1.small SecurityGroupId: sg-25zwc**** ZoneId: cn-beijing-b Tags: - Key: tiantt Value: ros - Key: tiantt1 Value: ros1支持的函数
不能在Ref函数中使用任何函数。必须指定为资源逻辑ID的字符串。
Fn::GetAZs
内部函数Fn::GetAZs返回指定Region的可用区列表。
该函数只适用于ECS和VPC类型的资源。
声明
Fn::GetAZs: region参数
region：region ID。返回值
指定Region下的可用区列表。
示例
在指定Region的第一个可用区内创建一个ECS实例。
ROSTemplateFormatVersion: '2015-09-01' Resources: WebServer: Type: ALIYUN::ECS::Instance Properties: ImageId: centos7u2_64_40G_cloudinit_2016072**** InstanceType: ecs.n1.tiny SecurityGroupId: sg-2zedcm7ep5quses0**** Password: Ros1**** AllocatePublicIP: true InternetChargeType: PayByTraffic InternetMaxBandwidthIn: 100 InternetMaxBandwidthOut: 100 SystemDiskCategory: cloud_efficiency IoOptimized: optimized ZoneId: Fn::Select: - '0' - Fn::GetAZs: Ref: ALIYUN::Region Outputs: InstanceId: Value: Fn::GetAtt: - WebServer - InstanceId PublicIp: Value: Fn::GetAtt: - WebServer - PublicIp支持的函数
Fn::Base64Encode
Fn::FindInMap
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Fn::Replace
内部函数Fn::Replace将字符串中指定子字符串用新字符串替换。
声明
Fn::Replace: - object_key: object_value - object_string参数
object_key：将要被替换的字符串。object_value：将要替换成的最终字符串。object_string：包含被替换object_key的字符串。
返回值
被替换后的字符串。
示例
所指定脚本中的print替换成echo。
ROSTemplateFormatVersion: '2015-09-01' Resources: WebServer: Type: ALIYUN::ECS::Instance Properties: ImageId: centos_7_2_64_40G_base_20170222**** InstanceType: ecs.n1.medium SecurityGroupId: sg-94q49**** Password: MytestPassword**** IoOptimized: optimized VSwitchId: vsw-94vdv**** VpcId: vpc-949uz**** SystemDiskCategory: cloud_ssd UserData: Fn::Replace: - print: echo - Fn::Join: - '' - - | #!/bin/sh - | mkdir ~/test_ros - | print hello > ~/1.txt Outputs: InstanceId: Value: Fn::GetAtt: - WebServer - InstanceId PublicIp: Value: Fn::GetAtt: - WebServer - PublicIp支持的函数
Fn::Base64Encode
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Fn::Split
内部函数Fn::Split通过指定分隔符对字符串进行切片，并返回所有切片组成的列表。
声明
Fn::Split: - delim - original_string参数
delim：分隔符，例如：英文逗号（,）、半角分号（;）、换行符（\n）、缩进（\t）等。original_string：将要被切片的字符串。
返回值
返回切片后所有字符串组成的列表。
示例
如果数据元列表是一个数组：
Fn::Split: - ; - foo; bar; achoo返回：
["foo; bar; achoo" ]。使用Fn::Split对InstanceIds进行切片：
Parameters: InstanceIds: Type: String Default: instane1_id,instance2_id,instance2_id Resources: resourceID: Type: ALIYUN::SLB::BackendServerAttachment Properties: BackendServerList: Fn::Split: - ',' - Ref: InstanceIds
支持的函数
Fn::Base64Encode
Fn::FindInMap
Fn::GetAtt
Fn::Join
Fn::Select
Fn::Replace
Fn::GetAZs
Fn::If
Ref
Fn::Equals
比较两个值是否相等。如果两个值相等，则返回true；如果不相等，则返回false。
声明
Fn::Equals: - value_1 - value_2参数
value：要比较的任意类型的值。返回值
true或false。
示例
在Conditions中使用Fn::Equals定义条件。
ROSTemplateFormatVersion: '2015-09-01' Parameters: EnvType: Default: pre Type: String Conditions: TestEqualsCond: Fn::Equals: - prod - Ref: EnvType支持的函数
Fn::Or
Fn::Not
Fn::Equals
Fn::FindInMap
Fn::And
Ref
Fn::And
代表AND运算符，最少包含两个条件。如果所有指定条件计算为true，则返回true；如果任意条件计算为false，则返回false。
声明
Fn::And: - condition - ...: Null参数
condition：计算为true或false的条件。返回值
true或false。
示例
在Conditions中使用Fn::And定义一个条件：
ROSTemplateFormatVersion: '2015-09-01' Parameters: EnvType: Default: pre Type: String Conditions: TestEqualsCond: Fn::Equals: - prod - Ref: EnvType TestAndCond: Fn::And: - TestEqualsCond - Fn::Equals: - pre - Ref: EnvType支持的函数
Fn::Or
Fn::Not
Fn::Equals
Fn::FindInMap
Fn::And
Ref
Fn::Or
代表OR运算符，最少包含两个条件。如果任意一个指定条件计算为true，则返回true；如果所有条件都计算为false，则返回false。
声明
Fn::Or: - condition - ...: Null参数
condition：计算为true或false的条件。返回值
true或false。
示例
在Conditions中使用Fn::Or定义一个条件。
ROSTemplateFormatVersion: '2015-09-01' Parameters: EnvType: Type: String Default: pre Conditions: TestEqualsCond: Fn::Equals: - prod - Ref: EnvType TestOrCond: Fn::Or: - TestEqualsCond - Fn::Equals: - pre - Ref: EnvType支持的函数
Fn::Or
Fn::Not
Fn::Equals
Fn::FindInMap
Fn::And
Ref
Fn::Not
代表NOT运算符。对计算为false的条件，返回true；对计算为true的条件，返回false。
声明
Fn::Not: condition参数
condition：计算为true或false的条件。返回值
true或false。
示例
在Conditions中使用Fn::Not定义一个条件。
ROSTemplateFormatVersion: '2015-09-01' Parameters: EnvType: Default: pre Type: String Conditions: TestNotCond: Fn::Not: Fn::Equals: - pre - Ref: EnvType支持的函数
Fn::Or
Fn::Not
Fn::Equals
Fn::FindInMap
Fn::And
Ref
Fn::Index
用于查找列表中某个元素的索引。
声明
Fn::Index: - item - - ...参数
item：列表中的元素。返回值
列表中元素的索引，不存在则返回空。
示例
ROSTemplateFormatVersion: '2015-09-01' Parameters: ZoneIds: Type: Json Default: - cn-beijing-a - cn-beijing-b - cn-beijing-f ZoneId: Type: String Default: cn-beijing-b Outputs: Index: Value: Fn::Index: - Ref: ZoneId - Ref: ZoneIds
Fn::If
如果指定的条件计算为true，则返回一个值；如果指定的条件计算为false，则返回另一个值。在模板Resources和Outputs属性值中支持Fn::If内部函数。您可以使用ALIYUN::NoValue伪参数作为返回值来删除相应的属性。
声明
Fn::If: - condition_name - value_if_true - value_if_false参数
condition_name：Conditions中条件对应的条件名称。通过条件名称引用条件。value_if_true：当指定的条件计算为true时，返回此值。value_if_false：当指定的条件计算为false时，返回此值。
示例
根据输入的参数，确定是否创建数据盘。
ROSTemplateFormatVersion: '2015-09-01' Parameters: EnvType: Default: pre Type: String Conditions: CreateDisk: Fn::Equals: - prod - Ref: EnvType Resources: WebServer: Type: ALIYUN::ECS::Instance Properties: DiskMappings: Fn::If: - CreateDisk - - Category: cloud_efficiency DiskName: FirstDataDiskName Size: 40 - Category: cloud_ssd DiskName: SecondDataDiskName Size: 40 - Ref: ALIYUN::NoValue VpcId: vpc-2zew9pxh2yirtzqxd**** SystemDiskCategory: cloud_efficiency SecurityGroupId: sg-2zece6wcqriejf1v**** SystemDiskSize: 40 ImageId: centos_6_8_64_40G_base_20170222**** IoOptimized: optimized VSwitchId: vsw-2zed9txvy7h2srqo6**** InstanceType: ecs.n1.medium Outputs: InstanceId: Value: Fn::GetAtt: - WebServer - InstanceId ZoneId: Value: Fn::GetAtt: - WebServer - ZoneId支持的函数
Fn::Or
Fn::Not
Fn::Equals
Fn::FindInMap
Fn::And
Ref
Fn::Length
内部函数Fn::Length返回对象的长度。
声明
Fn::Length : Object参数
Object：需要计算长度的对象。支持字符串、列表和字典三种类型。
返回值
该对象的长度，整型。
示例
Fn::Length: key1: v1 key2: v2返回：
2Fn::Length: - 1 - 2 - 3返回：
3Fn::Length: length返回：
6
Fn::ListMerge
合并多个列表为一个列表。
声明
Fn::ListMerge: - - list_1_item_1 - list_1_imte_2 - ... - - list_2_item_1 - list_2_imte_2 - ...参数
list_1_item_1, list_1_imte_2, ...：将要合并的第一个列表。list_2_item_1, list_2_imte_2, ...：将要和第一个列表合并的列表。
示例
把两个ECS组挂载到同一个负载均衡实例上。
ROSTemplateFormatVersion: '2015-09-01' Resources: LoadBalancer: Type: ALIYUN::SLB::LoadBalancer Properties: LoadBalancerName: ros AddressType: internet InternetChargeType: paybybandwidth BackendServer1: Type: ALIYUN::ECS::InstanceGroup Properties: ImageId: m-2ze9uqi7wo61hwep**** InstanceType: ecs.t1.small SecurityGroupId: sg-2ze8yxgempcdsq3i**** MaxAmount: 1 MinAmount: 1 BackendServer2: Type: ALIYUN::ECS::InstanceGroup Properties: ImageId: m-2ze9uqi7wo61hwep**** InstanceType: ecs.t1.small SecurityGroupId: sg-2ze8yxgempcdsq3i**** MaxAmount: 1 MinAmount: 1 Attachment: Type: ALIYUN::SLB::BackendServerAttachment Properties: LoadBalancerId: Ref: LoadBalancer BackendServerList: Fn::ListMerge: - Fn::GetAtt: - BackendServer1 - InstanceIds - Fn::GetAtt: - BackendServer2 - InstanceIds支持的函数
Fn::Base64Encode
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Fn::If
Fn::GetJsonValue
解析JSON字符串，获取指定的Key在第一层所对应的值。
声明
Fn::GetJsonValue: - key - json_string参数
key：键值。json_string：指定的需要解析的JSON字符串。
示例
WebServer2从WebServer实例执行完UserData返回的JSON字符串中，获取对应的值。
ROSTemplateFormatVersion: '2015-09-01' Resources: WebServer: Type: ALIYUN::ECS::Instance Properties: ImageId: m-2ze45uwova5fedlu**** InstanceType: ecs.n1.medium SecurityGroupId: sg-2ze7pxymaix640qr**** Password: Wenqiao**** IoOptimized: optimized VSwitchId: vsw-2zei67xd9nhcqxzec**** VpcId: vpc-2zevx9ios1rszqv0a**** SystemDiskCategory: cloud_ssd UserData: Fn::Replace: - ros-notify: Fn::GetAtt: - WaitConHandle - CurlCli - Fn::Join: - '' - - | #!/bin/sh - | mkdir ~/test_ros - | print hello > ~/1.txt - | cmd="ros-notify -d '{\"id\" : \"1\", \"data\" : [\"1111\", \"2222\"]}'" - | eval $cmd PrivateIpAddress: 192.168.XX.XX HostName: userdata-1 WaitConHandle: Type: ALIYUN::ROS::WaitConditionHandle WaitCondition: Type: ALIYUN::ROS::WaitCondition Properties: Handle: Ref: WaitConHandle Timeout: 900 WebServer2: Type: ALIYUN::ECS::Instance Properties: ImageId: m-2ze45uwova5fedlu**** InstanceType: ecs.n1.medium SecurityGroupId: sg-2ze7pxymaix640qr**** Password: Wenqiao**** IoOptimized: optimized VSwitchId: vsw-2zei67xd9nhcqxzec**** VpcId: vpc-2zevx9ios1rszqv0a**** SystemDiskCategory: cloud_ssd UserData: Fn::Join: - '' - - | #!/bin/sh - | mkdir ~/test_ros - | echo hello > ~/1.txt - server_1_token= - Fn::GetJsonValue: - '1' - Fn::GetAtt: - WaitCondition - Data - |+ PrivateIpAddress: 192.168.XX.XX HostName: userdata-2 Outputs: InstanceId: Value: Fn::GetAtt: - WebServer - InstanceId PublicIp: Value: Fn::GetAtt: - WebServer - PublicIp支持的函数
Fn::Base64Encode
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Fn::If
Fn::MergeMapToList
将多个Mapping合并成一个以Mapping为元素的列表。
声明
Fn::MergeMapToList: - key_1: - key_1_item_1 - key_1_item_2 - ... - key_2: - key_2_item_1 - key_2_item_2 - ... - ...参数
key_1: key_1_item_1, key_1_item_2, ...：将要合并的第一个Mapping。key_1所对应的值必须是一个列表。key_1将是合并后的列表元素中，每个Mapping的一个键。其对应的值在第一个Mapping中将是key_1_item_1，在第二个Mapping中是key_1_item_2，以此类推。最终合并的列表长度是所有将要合并的参数Mapping中，key_x所对应的列表中最长的长度。如果有的key_y所对应的列表长度比较短，会重复此列表的最后一个元素，使列表长度都达到最长。key_2: key_2_item_1, key_2_item_2, ...：将要合并的第二个Mapping。key_2所对应的值必须是一个列表。key_2将是合并后的列表元素中每个Mapping的一个键。其对应的值在第一个Mapping中将是key_2_item_1，在第二个Mapping中是key_2_item_2，以此类推。
示例
合并三个Mapping，每个Mapping中键值对应的列表长度一致：
Fn::MergeMapToList: - key_1: - key_1_item_1 - key_1_item_2 - key_2: - key_2_item_1 - key_2_item_2 - key_3: - key_3_item_1 - key_3_item_2合并结果如下：
- key_1: key_1_item_1 key_2: key_2_item_1 key_3: key_3_item_1 - key_1: key_1_item_2 key_2: key_2_item_2 key_3: key_3_item_2合并三个Mapping，每个Mapping中键值对应的列表长度不一致：
Fn::MergeMapToList: - key_1: - key_1_item_1 - key_1_item_2 - key_2: - key_2_item_1 - key_2_item_2 - key_2_item_3 - key_3: - key_3_item_1 - key_3_item_2合并结果如下：
- key_1: key_1_item_1 key_2: key_2_item_1 key_3: key_3_item_1 - key_1: key_1_item_2 key_2: key_2_item_2 key_3: key_3_item_2 - key_1: key_1_item_2 key_2: key_2_item_3 key_3: key_3_item_2以下模板示例中，把WebServer中创建的所有实例，都加入到一个负载均衡的虚拟服务器组中。
ROSTemplateFormatVersion: '2015-09-01' Resources: WebServer: Type: ALIYUN::ECS::InstanceGroupClone Properties: SourceInstanceId: i-xxxxx Password: Hello**** MinAmount: 1 MaxAmount: 1 CreateVServerGroup: Type: ALIYUN::SLB::VServerGroup Properties: LoadBalancerId: lb-**** VServerGroupName: VServerGroup-**** BackendServers: Fn::MergeMapToList: - Port: - 6666 - 9090 - 8080 - ServerId: Fn::GetAtt: - WebServer - InstanceIds - Weight: - 20 - 100
支持的函数
Fn::Base64Encode
Fn::GetAtt
Fn::Join
Fn::Select
Ref
Fn::If
Fn::ListMerge
Fn::GetJsonValue
Fn::Avg
内部函数Fn::Avg对一组数求平均值。
声明
Fn::Avg: - ndigits - - number1 - number2 - ...参数
ndigits：平均值保留几位小数，必须为整数。[number1, number2, ...]：一组用来求取平均值的数字。组内每个元素可以是数字或能转换成数字的字符串。
返回值
给定一组数字的平均值。
示例
Fn::Avg: - 1 - - 1 - 2 - 6 Fn::Avg: - 1 - - '1' - '2' - '6.0'返回：3.0。
支持的函数
Fn::GetAtt
Ref
Fn::SelectMapList
内部函数Fn::SelectMapList返回一个由map中元素构成的列表。
声明
Fn::SelectMapList: - key2 - - key1: value1-1 key3: value1-3 - key1: value2-1 key2: value2-2 - key1: value3-1 key2: value3-2 - ...参数
key2：在map中查询的key。key1: value1-1, key3: value1-3, ...：由map组成的List。
返回值
对map_list中的每个map，取出key对应的值，合并成一个列表。
示例
Fn::SelectMapList: - key2 - - key1: value1-1 key3: value1-3 - key1: value2-1 key2: value2-2 - key1: value3-1 key2: value3-2返回：
value2-2, value3-2。
Fn::Add
内部函数Fn::Add对参数进行求和。
声明
Fn::Add: - Product: ROS - Fn: Add参数
参数为一个列表。
列表内元素可以是数字、列表、字典，但是所有元素必须是同一类型，至少2个元素。
返回值
如果是数字类型，对参数进行求和；如果是列表类型，对参数进行拼接；如果是字典类型，对参数进行合并，key相同的情况下，后面的覆盖前面的。
示例
Fn::Add: - Product: ROS - Fn: Add返回：
Fn:Add, Product:ROS。
Fn::Calculate
内部函数Fn::Calculate对字符串形式的表达式进行计算。
声明
Fn::Calculate: - expression - ndigits - - <number1> - <number2> - ...参数
expression：字符串形式的表达式。ndigits：取值：0或正整数，表示保留小数的位数，如果表达式中不包含浮点数，则此参数不生效。[<number0>, <number1>, <number2>, ... ]：非必需参数。expression中可以定义{n}，n为列表中某个number的索引，在计算表达式时用number的值替换{n}。
返回值
表达式的计算结果，类型为Number。
示例
Fn::Calculate: - (2+3)/2*3-1 - 1 Fn::Calculate: - (2.0+3)/2*3-1 - 1 Fn::Calculate: - ({1}+3)/2*3-1 - 1 - - 3 - 5 - 6 Fn::Calculate: - ({0}+{1})%3 - 0 - - 5 - 6返回
5 6.5 11 2说明使用整数进行除法运算时不保留小数，即5/2=2，因此
Fn::Calculate:(2+3)/2*3-1, 1返回值为5。
Fn::Max
内部函数Fn::Max用于获取由数字组成的列表中的最大数字。
声明
Fn::Max: - Number1 - Number2 - Number3 - ...返回值
列表中的最大数字。
示例
Fn::Max: 1.1, 2, 3返回
3
Fn::Min
内部函数Fn::Min用于获取由数字组成的列表中的最小数字。
声明
Fn::Min: Number1, Number2, Number3, ...返回值
列表中的最小数字。
示例
Fn::Min: 1.1, 2, 3返回
1.1
Fn::GetStackOutput
内部函数Fn::GetStackOutput用于获取指定资源栈的输出。
声明
Fn::GetStackOutput: Stack, OutputName, RegionId参数
Stack：必选，String类型。资源栈的名称或ID。OutputName：必选，String类型。资源栈某一输出名。RegionId：可选，String类型。资源栈所属地域，若不指定，则与调用资源栈相同。
返回值
资源栈Stack的名为OutputName的输出，类型依赖于输出值，不确定。若符合如下条件则返回空值：
传递的参数中有一个值为空值。
Stack不存在（含已删除）。
Stack运行中或删除失败。
Output不存在。
限制
单向引用：A->B->C（允许），A->B->A（不允许），A->A（不允许）。
引用最大长度为3：A->B->C（允许），A->B->C->D（不允许）。
示例
Fn::GetStackOutput: 4a6c9851-3b0f-4f5f-b4ca-a14bf691****, InstanceId
Fn::Jq
内部函数Fn::Jq用于支持Jq功能。Jq功能详情请参见Jq文档。
声明
Fn::Jq: method,script,object参数
method：必选，字符串。取值：First：符合条件的第一个值。
All：符合条件的所有值。
script：必选，字符串。Jq脚本。object：必选，JSON字符串。
返回值
选定的字符串。
示例
使用过滤器
.test过滤出的值取第一个。当给定一个JSON字符串作为输入时，它将在键test处产生值；如果值不存在，则为null。Fn::Jq": - First - .test - '{"test":"test"}'返回
test使用过滤器
.parameters[]过滤出的内容，再次通过新的过滤器进行过滤。它们之间通过竖线（|）进行连接。给定一个JSON字符串作为输入时，它将在键.parameters[] | {\"param_name\": .name, \"param_type\":.type}处产生值；如果值不存在，则为null。Fn::Jq: - All - '.parameters[] | {"param_name": .name, "param_type":.type}' - changeSet: items: [] kind: git id: 2013-12-27_00-09-37 parameters: - name: PKG_TAG_NAME value: trunk - name: GIT_COMMIT value: master - name: TRIGGERED_JOB value: trunk-buildall返回
- param_name: PKG_TAG_NAME - param_name: GIT_COMMIT - param_name: TRIGGERED_JOB
Fn::FormatTime
内部函数Fn::FormatTime用于返回格式化后的当前时间。
声明
根据指定时区，获取该时区的当前时间。
Fn::FormatTime": - format - <time_zone>获取默认UTC时区的当前时间。
Fn::FormatTime: format
参数
format：必选，日期格式字符串，例如："%Y-%m-%d %H:%M:%S"。日期格式字符串中字段含义如下：
字段
说明
示例
%y
补零后，以十进制数表示不带世纪的年份。例如：2001年表示为01，0相当于占位符。
21
%Y
以十进制数表示带世纪的年份。
2021
%m
补零后，以十进制数表示的月份。
04
%d
补零后，以十进制数表示的一个月中的一天。
07
%H
补零后，以十进制数表示的小时（24小时制）。
14
%I
补零后，以十进制数表示的小时（12小时制）。
08
%M
补零后，以十进制数表示的分钟。
09
%S
补零后，以十进制数表示的秒。
10
%a
星期的缩写。
Wed
%A
星期的全称。
Wednesday
%b
月份的缩写。
Apr
%B
月份的全称。
April
%c
日期和时间。
Wed Apr 7 08:15:10 2021
%j
补零后，以十进制数表示的一年中的一天。
097
%p
取值：
AM：上午。
PM：下午。
AM
%U
补零后，以十进制数表示的一年中的周序号（星期日作为每周的第一天）。
说明在新的一年中第一个星期日之前的所有日子都被视为第0周。
14
%w
以十进制数显示的星期中的一天。
0表示星期日，6表示星期六。
3
%W
以十进制数表示的一年中的周序号（星期一作为每周的第一天）。
说明在新的一年中第一个星期一之前的所有日子都被视为第0周。
14
%x
日期。
04/07/21
%X
时间。
08:15:10
%Z
时区名称。取值：
UTC
GMT
UTC
%f
补零后，以十进制数表示微秒。
091798
%z
UTC偏移量，格式为
+HHMM或-HHMM。+0000
%%
百分号（%） 。
%
time_zone：时区，例如：UTC(default), Asia/Shanghai。
返回值
当前时间。
示例
Fn::FormatTime: %Y-%m-%d %H:%M:%S返回
2021-06-11 03:48:19Fn::FormatTime: %Y-%m-%d %H:%M:%S,Asia/Shanghai返回
2021-06-11 12:01:25
Fn::MarketplaceImage
内部函数Fn::MarketplaceImage用于返回指定云市场镜像商品Code的默认镜像ID。
在更新资源栈或创建更改集时，若此函数返回值和前一次不同，会被认为有差异而触发引用此函数的资源更新。例如：假设某镜像商品Code在杭州地域cn-hangzhou查到的镜像ID是m-1，您使用包含此函数的模板创建了资源栈。如果后续云市场商家将m-1更换为m-2，您再次使用包含此函数的模板更新资源栈时，由于得到的镜像ID不同而被认为有差异，从而触发引用此镜像ID的资源（例如ALIYUN::ECS::InstanceGroup）的更新。
声明
Fn::MarketplaceImage : <ImageProductCode>参数
ImageProductCode：必选，字符串。云市场镜像商品Code。例如：cmjj02****。返回值
字符串。云市场镜像商品Code在当前地域对应的默认镜像ID。
示例
Fn::MarketplaceImage: cmjj02****返回：
m-2zeeyr9nxxoo5gcg****。
Fn::Any
内部函数Fn::Any用于返回指定数组中取值的真假情况。当数组中任意一项为真时，返回true（真），否则返回false（假）。
声明
Fn::Any: value_1, value_2, ...参数
value：必选，任意类型的值。例如：true、false、1、0等。返回值
true或false。
示例
示例1
Fn::Any: true, true返回：
true。示例2
Fn::Any: true, false返回：
true。示例3
Fn::Any: false, false返回：
false。示例4
Fn::Any: 1, 1返回：
true。示例5
Fn::Any: 0, 0返回：
false。
Fn::Contains
如果列表中至少有一个成员与指定的值匹配，则返回true，否则返回false。
声明
Fn::Contains": - - value_1 - value_2 - ... - value参数
value_1, value_2, ...：必填，列表值。value：必填，指定的值。
返回值
true或false。
示例
Fn::Contains: - - 1 - 2 - 3 - 3返回：
true。Fn::Contains: - - 1 - 2 - 3 - 4返回：
false。
Fn::EachMemberIn
如果第一个列表中的每个成员与第二个列表中的至少一个值匹配，则返回true，否则返回false。
声明
Fn::EachMemberIn: - - value1_1 - value1_2 - ... - - value2_1 - value2_2 - ...参数
value1_1, value1_2,...：必填，第一个列表。value2_1, value2_2,...：必填，第二个列表。
返回值
true或false。
示例
Fn::EachMemberIn: - - 1 - 2 - 3 - - 1 - 2 - 3 - 3 - 4返回：
true。Fn::EachMemberIn: - - 1 - 2 - 3 - - 1 - 2 - 4返回：
false。
Fn::MatchPattern
检查输入字符串的值能否与正则表达式匹配，如果能匹配则返回true，否则返回false。
声明
Fn::MatchPattern: pattern, value参数
pattern：必填，一个字符串形式的正则表达式。value：必填，要匹配的字符串。
返回值
true或false。
示例
Fn::MatchPattern: - '[a-z]+' - adb返回：
true。Fn::MatchPattern: - '[a-z]+' - 12b返回：
false。