文档首页 > > API参考> API> 堆栈管理> 查询堆栈列表

查询堆栈列表

分享
更新时间: 2019/05/24 GMT+08:00

功能介绍

查询指定租户的堆栈列表,访问数据库获取堆栈信息。

URI

GET /v1/{project_id}/stacks

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID

请求参数

参数

位置

参数类型

是否必选

描述

status/stack_status

query

String

堆栈状态

name/stack_name

query

String

堆栈名称

  • 只能包含大写字母、小写字母、数字、中划线(-)、点号(.)和下划线(_)。
  • 必须以大写或小写字母开头。
  • 长度为1~255个字符。

limit

query

Integer

控制堆栈显示方式和数量的参数,表示返回堆栈的数量。可以单独使用,也可以和marker参数配合使用。

例如,不使用limit和marker参数时,查询的堆栈列表如下:

[stack1,stack2,stack3,stack4,stack5,stack6,stack7,stack8]

limit=3,表示只获取堆栈列表中的前三个数据:

[stack1,stack2,stack3]

limit=3&marker=stack3,表示从stack3的下一个数据开始,依次显示3个堆栈:

[stack4,stack5,stack6]

limit=3&marker=stack6,此场景下,stack6后的数据不足3个,则显示剩余的全部数据即可:

[stack7,stack8]

marker

query

String

控制堆栈显示方式和数量的参数,表示从marker指定的堆栈的下一条数据开始查询。需要和limit参数配合使用。

sort_keys

query

String

按以下关键字排序:

stack_name、stack_status、creation_time、updated_time

sort_dir

query

String

排序方式:

asc(ascending)或者desc(descending)

响应参数

参数

位置

参数类型

描述

stacks

body

List <dict>

堆栈列表

stacks结构信息:

参数

位置

参数类型

描述

id

body

String

堆栈UUID

stack_name

body

String

堆栈名称

stack_status

body

String

堆栈状态

stack_status_reason

body

String

堆栈操作描述

description

body

String

堆栈描述

links

body

List <dict>

堆栈的URL列表

creation_time

body

String

创建时间

updated_time

body

String

更新时间

parent

body

String

父堆栈的堆栈UUID(如果这是嵌套堆栈)

tags

body

String

堆栈标签

stack_user_project_id

body

String

堆栈用户的项目UUID(可能为空)

请求样例

GET /v1/95d02433133a4c0a87ba6967474a2ad3/stacks

响应样例

{
    "stacks": [
        {
            "description": "Hello world HOT template that just defines a single compute instance. Contains just base features to verify base HOT support.\n",
            "links": [
                {
                     "href":  "http://x.x.x.x:8004/v1/95d02433133a4c0a87ba6967474a2ad3/stacks/HeatStack/c89c4bb3-96cb-4a55-aafa-076a7939a306",
                     "rel": "self"
                 }
             ],
            "stack_status_reason": "Stack create completed successfully",
            "stack_name": "HeatStack",
            "creation_time": "2018-01-26T17:21:35Z",
            "updated_time": "2018-01-26T17:21:41Z",
            "stack_status": "CREATE_COMPLETE",
            "id": "c89c4bb3-96cb-4a55-aafa-076a7939a306"
        }
    ]
}

返回码

表2 正常返回码

返回码

类型

说明

200

OK

请求成功

表3 错误返回码

返回码

类型

说明

400

Bad Request

服务器无法处理请求

401

Unauthorized

授权失败

500

Internal Server Error

服务器内部异常

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区