本文导读

展开导读

文档首页/ 资源编排服务 RFS/ API参考（吉隆坡区域）/ API/ 资源栈集/ 获取资源栈集模板

获取资源栈集模板

更新时间：2024-12-12 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

获取资源栈集模板（ShowStackSetTemplate）

此API用于获取指定资源栈集的模板。

如果获取成功，则以临时重定向形式返回模板下载链接（OBS Pre Signed地址，有效期为5分钟），大多数的客户端会进行自动重定向并下载模板；如果未进行自动重定向，请参考HTTP的重定向规则获取模板下载链接，手动下载模板。

URI

GET /v1/stack-sets/{stack_set_name}/templates

表1 路径参数
参数	是否必选	参数类型	描述
stack_set_name	是	String	资源栈集的名称。此名字在domain_id+region下应唯一，可以使用中文、大小写英文、数字、下划线、中划线。首字符需为中文或者英文，区分大小写。最小长度：1 最大长度：128

表2 Query参数
参数	是否必选	参数类型	描述
stack_set_id	否	String	资源栈集（stack_set）的唯一ID。此ID由资源编排服务在生成资源栈集的时候生成，为UUID。由于资源栈集名称仅仅在同一时间下唯一，即用户允许先生成一个叫HelloWorld的资源栈集，删除，再重新创建一个同名资源栈集。对于团队并行开发，用户可能希望确保，当前我操作的资源栈集就是我认为的那个，而不是其他队友删除后创建的同名资源栈集。因此，使用ID就可以做到强匹配。资源编排服务保证每次创建的资源栈集所对应的ID都不相同，更新不会影响ID。如果给予的stack_set_id和当前资源栈集的ID不一致，则返回400 最小长度：36 最大长度：36

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
Client-Request-Id	是	String	用户指定的，对于此请求的唯一ID，用于定位某个请求，推荐使用UUID 最小长度：36 最大长度：128

响应参数

状态码： 307

表4 响应Header参数
参数	参数类型	描述
Location	String	HTTP重定向指定头域，客户端可通过此头域重定向至新地址。其内容为模板下载链接，为OBS Pre Signed地址，有效期为5分钟

状态码： 400

表5 响应Body参数
参数	参数类型	描述
error_code	String	响应码最小长度：11 最大长度：11
error_msg	String	响应消息
encoded_authorization_message	String	包含有关未经授权请求的信息。

状态码： 401

表6 响应Body参数
参数	参数类型	描述
error_code	String	响应码最小长度：11 最大长度：11
error_msg	String	响应消息
encoded_authorization_message	String	包含有关未经授权请求的信息。

状态码： 403

表7 响应Body参数
参数	参数类型	描述
error_code	String	响应码最小长度：11 最大长度：11
error_msg	String	响应消息
encoded_authorization_message	String	包含有关未经授权请求的信息。

状态码： 404

表8 响应Body参数
参数	参数类型	描述
error_code	String	响应码最小长度：11 最大长度：11
error_msg	String	响应消息
encoded_authorization_message	String	包含有关未经授权请求的信息。

状态码： 429

表9 响应Body参数
参数	参数类型	描述
error_code	String	响应码最小长度：11 最大长度：11
error_msg	String	响应消息
encoded_authorization_message	String	包含有关未经授权请求的信息。

状态码： 500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	响应码最小长度：11 最大长度：11
error_msg	String	响应消息
encoded_authorization_message	String	包含有关未经授权请求的信息。

请求示例

获取资源栈集模板

GET https://{endpoint}/v1/stack-sets/my_hello_world_stack_set/templates

获取资源栈集模板，并提供资源栈集id以校验是否与当前资源栈集匹配

GET https://{endpoint}/v1/stack-sets/my_hello_world_stack_set/templates?stack_set_id=ea6a4f0e-ee8a-494e-b12a-8be4a1e65af2

响应示例

无

状态码

状态码	描述
307	获取成功，临时重定向
400	用户请求非法
401	用户身份认证失败
403	用户无权限调用此API
404	资源栈集不存在
429	请求数量过多
500	服务器内部错误

父主题： 资源栈集

上一篇：创建资源栈集

下一篇：列举资源栈集操作

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

获取资源栈集模板

功能介绍

URI

请求参数

响应参数

请求示例

响应示例

状态码

意见反馈

文档内容是否对您有帮助？

文档反馈