1# TIC 接口调用示例
2
3## demo运行
4运行该demo将会创建一个新的资源栈和版本，并对该版本分别执行plan，apply，destroy操作，过程中创建的资源均会被删除。
5
6注意，需要先将模版文件打包成zip上传到cos。
7
8```shell
9$ export TENCENTCLOUD_SECRET_ID=<your-secret-id>
10$ export TENCENTCLOUD_SECRET_KEY=<your-secret-key>
11$ export TIC_TEMPLATE_URL=<your-template-zip-cos-url>
12$ go run main.go
13```
14
15## 最简单的流程
16
171. 创建资源栈，得到资源栈ID和版本ID
182. 使用上一步的资源栈ID和版本ID进行调用`PlanStack`，`ApplyStack`，`DestroyStack`分别进行预览，执行和销毁操作，其中销毁会删除资源栈创建的资源
19
20可以参考[main.go](main.go)代码示例。
21
22## 在已有的资源栈或版本上操作
23
241. 已有资源栈ID，可以给调用`CreateStackVersion`增加一个版本，或者调用`UpdateStackVersion`更新版本内容，然后进行plan，apply，destroy操作资源栈
25
26## 查询接口
27
28- `DescribeStacks`用于查询一个或多个资源栈信息
29- `DescribeStackVersions`用于查询一个或多个版本的详细信息，可以通过名字(Name)和状态(Status)过滤
30- `DescribeStackEvents`用于查看一个或多个事件详细信息，可以通过版本ID(VersionId)，资源栈ID（StackId)，事件类型(Type)，事件状态(Status)过滤
31- `DescribeStackEvent`用于获取单个事件详情，尤其是可以得到事件的详细控制台输出文本
32
33## 注意事项
34
35执行事件的过程可能比较耗时，需要等待事件状态结束，并且处于plan，apply状态下的版本无法再执行其他事件，需要等待状态变成success或fail。