通过 POST 方法调用 /stacks/preview 预览根据指定模板将创建的资源栈信息。

请求参数

名称 位置 类型 是否必须 描述
x-acs-region-id header String 将要创建资源栈的地域。有关 ROS 支持的地域,请参见 ROS 地域列表
Name body String 资源栈名称,需符合该正则表达式 ^[a-zA-Z][a-zA-Z0-9_.-]*$,长度不超过 255 个字符。
Template body JSON JSON 格式的模板,目前默认模板大小最大为 512 KB。该配置值可调。
Parameters body JSON 创建资源栈所需要的参数,key 需要在模板中定义。
DisableRollback body Boolean 当创建资源栈失败时,是否禁用回滚策略。True 表示禁用回滚,即在创建资源栈失败时不会进行回滚;False 表示不禁用回滚,即在创建资源栈失败时会进行回滚。
TimeoutMins body Integer 创建资源栈的超时时间,以分钟为单位。默认值是 60。

返回参数

名称 参数类型 描述
Description String 资源栈描述。
Updated String 更新时间,按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为:YYYY-MM-DDThh:mm:ssZ。
Parameters JSON 资源栈参数,是一个 JSON 格式的参数集合。
Created String 创建时间,按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为:YYYY-MM-DDThh:mm:ssZ。
Region String 参数集合所在地域。
TemplateDescription String 模板描述。
Webhook String 自定义回调函数。
Id String 资源栈 ID.
Resources JSON 资源栈中资源的详细信息,是一个 JSON 格式的资源集合。
Name String 资源栈的名称。
DisableRollback Boolean 当创建资源栈失败时,是否禁用回滚策略。True 表示禁用回滚,即在创建资源栈失败时不会进行回滚;False 表示不禁用回滚,即在创建资源栈失败时会进行回滚。
TimeoutMins Integer 创建资源栈的超时时间,以分钟为单位。

错误码

错误代码 描述 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 非法的删除策略。
StackValidationFailed “%s” deletion policy not supported. 400 非法的删除策略。
StackValidationFailed Unknown Property %s. 400 未知的属性。
InvalidSchemaError Property %(prop)s: %(ua)s and %(im)s cannot both be True. 400 模板格式错误。

示例

请求示例

POST http://ros.aliyuncs.com/stacks/preview 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)

{
    "Updated":null,
    "Description":"No description",
    "Parameters":{
        "ALIYUN::StackId":"None",
        "ALIYUN::StackName":"update_test_0040",
        "ALIYUN::Region":"cn-beijing"
    },
    "Created":"2017-01-17T07:01:10.437639",
    "Region":"cn-beijing",
    "TemplateDescription":"No description",
    "Webhook":null,
    "Id":"None",
    "DisableRollback":false,
    "TimeoutMins":120,
    "Resources":[
        {
            "UpdatedTime":null,
            "StackIdentity":{
                "StackName":"update_test_0040",
                "StackId":"None",
                "Region":"cn-beijing",
                "Tenant":"175458090349****",
                "Path":""
            },
            "ResourceStatus":"COMPLETE",
            "Description":"",
            "ResourceData":null,
            "ResourceStatusReason":"",
            "ResourceAction":"INIT",
            "PhysicalResourceId":"",
            "DeletedTime":null,
            "StackName":"update_test_0040",
            "ResourceType":"ALIYUN::ECS::InstanceGroupClone",
            "RequiredBy":[

            ],
            "Attributes":{
                "OrderId":null,
                "InnerIps":null,
                "PrivateIps":null,
                "ZoneIds":null,
                "PublicIps":null,
                "InstanceIds":null
            },
            "CreatedTime":null,
            "ResourceName":"WebServer",
            "ResourceIdentity":{
                "StackName":"update_test_0040",
                "StackId":"None",
                "Region":"cn-beijing",
                "Tenant":"75458090349****",
                "Path":"/resources/WebServer"
            },
            "Properties":{
                "AutoReleaseTime":null,
                "DiskMappings":null,
                "LoadBalancerIdToAttach":null,
                "Description":null,
                "BackendServerWeight":100,
                "Tags":null,
                "MinAmount":1,
                "SecurityGroupId":null,
                "ZoneId":null,
                "InternetMaxBandwidthOut":null,
                "ImageId":null,
                "SourceInstanceId":"i-2ze5q7nkum5974w6****",
                "Password":"Test****",
                "InstanceName":null,
                "MaxAmount":1
            },
            "Metadata":{

            }
        }
    ],
    "Name":"update_test_0040"
}