743      小米

参数（Parameters）__模板语法_资源编排-阿里云

参数可用于在资源栈创建时覆盖模板中的某些值，用来提高模板的灵活性和可复用性。

例如，现在有一个模板可以用来创建包含 1 个 SLB 实例，2 个 ECS 实例，1 个 RDS 实例的 Web 应用。如果该 Web 应用负载较高，可以在创建时选择使用高配的 ECS 实例，否则可以在创建时选择使用低配的 ECS 实例。在这种情况下，可以定义如下的参数：

"Parameters" : {
  "InstanceType" : {
    "Type" : "String",
    "AllowedValues":["ecs.t1.small","ecs.s1.medium", "ecs.m1.medium", "ecs.c1.large"],
    "Default": "ecs.t1.small",
    "Label": "ECS规格类型",
    "Description" : "请选择创建 ECS 示例的配置，默认为 ecs.t1.small，可选 ecs.t1.small, ecs.s1.medium, ecs.m1.medium，ecs.c1.large。"
  }
}

上面定义的 InstanceType 参数，允许在用户使用模板创建资源栈时重新赋值。如果用户不设置参数值则使用默认的 ecs.t1.small。在资源定义时，可以引用此参数：

"Webserver" : {
  "Type" : "ALIYUN::ECS::Instance",
  "InstanceType": {
    "Ref": "InstanceType"
  }
}

语法

每个参数由参数名称和参数属性组成。

参数名称必须为字母数字，并且在同一个模板中不能与其它参数名称重复。可以用Label字段来定义友好的参数名，一般在把模板动态生成为Web表单时很有用。

参数属性列表：

示例

以下示例 Parameters 部分声明有两个参数。username 参数属于 String 类型，默认值为 anonymous。可指定的最小长度为 6，可指定的最大长度为 12，并且允许值为 anonymous，user-one，user-two。注意 username 的默认值也必须符合长度限制和允许值限制。password 参数属于 String 类型，无默认值。将 NoEcho 属性设置为 true 可阻止查询堆栈接口返回参数值。可指定的最小长度为 1，可指定的最大长度为 41。该模式允许小写和大写字母字符和数字。

"Parameters" : {
  "username" : {
    "Label": "用户名",
    "Description" : "请输入用户名",
    "Default": "anonymous",
    "Type" : "String",
    "MinLength" : "6",
    "MaxLength" : "12",
    "AllowedValues": ["anonymous", "user-one", "user-two"]
  },
  "password" : {
    "Label": "密码",
    "NoEcho" : "True",
    "Description" : "请输入用户密码",
    "Type" : "String",
    "MinLength" : "1",
    "MaxLength" : "41",
    "AllowedPattern" : "[a-zA-Z0-9]*"
  }
}

伪参数

伪参数是由ROS编排引擎提供的固定参数，可以和用户定义参数一样被引用，其值在编排运行时确定。目前支持的伪参数如下：

• ALIYUN::StackName - 当前资源栈的名称
• ALIYUN::StackId - 当前资源栈的ID
• ALIYUN::Region - 当前资源栈所在的区域

最后更新：2016-11-23 16:04:02

  上一篇： 模板结构说明__模板语法_资源编排-阿里云

  下一篇： 资源（Resources）__模板语法_资源编排-阿里云