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）__模板語法_資源編排-阿裏雲