895
iPhone_iPad_Mac_apple
創建堆棧__堆棧相關接口_API 文檔_資源編排-阿裏雲
創建堆棧
描述：
• 用戶指定模板和參數列表創建堆棧
• 模板內容在HTTP消息體中提交
• 堆棧名稱由用戶指定, 堆棧創建成功後ROS服務返回堆棧ID，後續操作以ID作為唯一標識
• 堆棧會創建在以用戶ID為區分的命名空間下，所以同一個用戶在同一個region中創建的堆棧名稱不能重複
• 堆棧創建成功後，不支持重命名堆棧
• 不支持堆棧過繼到另一個用戶下
• 需要指定創建的區域(x-acs-region-id)
• 堆棧下所有資源所在區域需要與堆棧所在區域相同
請求參數
| 名稱 |
位置 |
類型 |
是否必須 |
描述 |
|---|
| x-acs-region-id |
header |
String |
是 |
要創建stack的區域，參見Region列表ROS區域列表。 |
|---|
| Name |
body |
String |
是 |
堆棧名稱，需符合該正則表達式^[a-zA-Z][a-zA-Z0-9_.-]*$，最大不超過255個字符。 |
|---|
| Template |
body |
JSON |
是 |
模板的JSON格式，目前默認最大為512Kb。該配置值可調。 |
|---|
| Parameters |
body |
JSON |
是 |
創建堆棧所需要的參數，key需要在templete中定義。 |
|---|
| DisableRollback |
body |
Boolean |
否 |
當創建stack失敗時，是否禁用回滾策略。True表示禁用回滾，即在創建stack失敗時不會進行回滾；False表示不禁用回滾，即在創建stack失敗時會進行回滾。 |
|---|
| TimeoutMins |
body |
Integer |
是 |
創建堆棧的超時時間,以分鍾為單位，默認值60。 |
|---|
返回參數
| 名稱 |
參數類型 |
描述 |
|---|
| Id |
String |
stack的Id，全局唯一。 |
|---|
| Name |
String |
stack的名稱。 |
|---|
錯誤碼
| 錯誤代碼 |
描述 |
Http狀態碼 |
語義 |
|---|
| InternalError |
Server error |
500 |
服務器端出現未知異常 |
|---|
| NotSupported |
%(feature)s is not supported |
404 |
參數不支持 |
|---|
| InvalidTemplateVersion |
Template version was not provided. |
400 |
模板版本號不合法 |
|---|
| InvalidTemplateVersion |
Ambiguous versions (%s). |
400 |
模板版本號不合法 |
|---|
| InvalidTemplateSection |
The Parameter (%(key)s) has no attributes. |
400 |
錯誤的模板屬性 |
|---|
| StackValidationFailed |
Each Resource must contain a Type key. |
400 |
資源必須包含Type屬性 |
|---|
| StackValidationFailed |
Resources must contain Resource. Found a [%s] instead. |
400 |
Resources必須包含Resource |
|---|
| StackValidationFailed |
Invalid deletion policy "%s". |
400 |
非法的deletion policy |
|---|
| StackValidationFailed |
"%s" deletion policy not supported. |
400 |
非法的deletion policy |
|---|
| StackValidationFailed |
Unknown Property %s. |
400 |
未知的屬性 |
|---|
| InvalidSchemaError |
Property %(prop)s: %(ua)s and %(im)s cannot both be True. |
400 |
模板格式錯誤 |
|---|
示例
請求示例
POST https://ros.aliyuncs.com/stacks HTTP/1.1
x-acs-signature-method: HMAC-SHA1
Authorization: acs <AccessKeyId>:<signature>
Date: Fri, 11 Sep 2015 05:28:47 GMT
Content-MD5: 4eCVDLNDI0GRJMiZ6mLmgw==
x-acs-signature-version: 1.0
Accept: application/octet-stream
Content-Type: application/json;charset=utf-8
x-acs-version: 2015-09-01
Cache-Control: no-cache
Pragma: no-cache
x-acs-region-id:cn-beijing
Host: ros.aliyuncs.com
Connection: keep-alive
Content-Length: 502
{
“Name”: “<stack name>”,
“Parameters”:
{
“key”: “value”
},
“Template”:<template text>,
“DisableRollback”: true,
“TimeoutMins”: 15
}
返回示例
HTTP/1.1 201 Created
Date: Fri, 11 Sep 2015 05:28:48 GMT
Content-Type: application/json
Content-Length: 155
Connection: close
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
Access-Control-Max-Age: 172800
X-Acs-Request-Id: 14EB3BE2-B4A8-4F84-BD6E-52F222DDB66C
Server: Jetty(7.2.2.v20101205)
{
"Id":"b44afc3c-46a4-4087-a215-c333a1218316",
"Name":"myStack"
}
最後更新：2016-11-23 17:16:06