查询堆栈元素列表

功能介绍

用于查询堆栈元素列表。

URI

GET /v2/stacks/{stack_id}/elements

请求消息

N/A。

响应消息

• 响应参数

  响应参数是一个堆栈元素结构列表或者返回消息结构。

  • 查询成功时返回堆栈元素结构列表。
  • 查询失败时返回失败消息结构。

  返回失败消息结构如表5所示。

  表2 响应参数

  参数	参数类型	描述
  [数组元素]	Array of objects	数组每个元素表示堆栈某一个元素的详细信息，详情请参见表3。

  表3 堆栈元素详细信息

  参数	参数类型	描述
  id	String	元素的名称
  description	String	元素的描述
  properties	Object	元素的属性，与模板内容相对应。
  runtime_properties	Object	元素运行时属性
  relationships	Object	元素的关系，详情请参见表4。
  stack_id	String	元素所属的堆栈的guid
  type	String	元素的类型
  create_at	String	元素创建时间
  update_at	String	元素更新时间
  type_hierarchy	String	堆栈元素类型
  action_status	Object	堆栈元素当前的状态，详情请参见表5。

  表4 Stack Nodes Relationship结构

  参数	参数类型	描述
  name	String	关系的名称
  type	String	关系的类型
  target_id	String	关系的目标节点名字
  type_hierarchy	Array of strings	关系的继承结构
  properties	Object	关系的属性，内含一个名为connection_type类型为String的key，表示关系的连接类型。

  表5 action_status字段数据结构说明

  参数	参数类型	描述
  subActionName	String	元素子操作的名字
  phase	String	堆栈的执行状态，有执行成功、执行中、执行挂起、执行取消、执行取消中、执行强制取消中、执行挂起中、执行重试中、执行运行中等，详情请参见表10。
  createAt	String	以RFC3339格式表示的信息创建的UTC时间戳
  updateAt	String	以RFC3339格式表示的信息更新的UTC时间戳

• 响应示例

  [
      {
          "id": "subnet",
          "stack_id": "a067769b-c1bb-11ea-8a77-0255ac1003d8",
          "relationships": [
              {
                  "name": "vpcId",
                  "type": "Cloud.Relationships.ContainedIn",
                  "type_hierarchy": [
                      "Cloud.Relationships.Root",
                      "Cloud.Relationships.DependsOn",
                      "Cloud.Relationships.ContainedIn"
                  ],
                  "properties": {},
                  "target_id": "vpc"
              }
          ],
          "type_hierarchy": [
              "Cloud.Node.Root",
              "Cloud.VPC.Subnet"
          ],
          "properties": {
              "cidr": "192.168.1.0/24",
              "dhcpEnable": true,
              "gateway": "192.168.1.1",
              "name": "dfsdf",
              "vpcId": {
                  "get_attribute": [
                      "vpc",
                      "refID"
                  ]
              }
          },
          "type": "Cloud.VPC.Subnet",
          "runtime_properties": {
              "neutron_network_id": "940bb729-260c-44fe-ab40-e98367865530",
              "neutron_subnet_id": "dc893222-ab37-4358-b162-3316c97c4958",
              "refID": "940bb729-260c-44fe-ab40-e98367865530",
              "refName": "dfsdf",
              "vpcId": "f78881f0-2944-44d4-9325-966f5f30369e"
          },
          "action_status": {
              "subActionName": "create",
              "phase": "Succeeded",
              "updateAt": "2020-07-09T08:10:26.830795Z",
              "createAt": "2020-07-09T08:10:22.270746Z"
          },
          "create_at": "2020-07-09T08:10:18Z",
          "update_at": "2020-07-09T08:10:18Z"
      },
      {
          "id": "vpc",
          "stack_id": "a067769b-c1bb-11ea-8a77-0255ac1003d8",
          "relationships": [],
          "type_hierarchy": [
              "Cloud.Node.Root",
              "Cloud.VPC.VPC"
          ],
          "properties": {
              "cidr": "192.168.0.0/16",
              "name": "sdfs"
          },
          "type": "Cloud.VPC.VPC",
          "runtime_properties": {
              "refID": "f78881f0-2944-44d4-9325-966f5f30369e",
              "refName": "sdfs"
          },
          "action_status": {
              "subActionName": "create",
              "phase": "Succeeded",
              "updateAt": "2020-07-09T08:10:22.270648Z",
              "createAt": "2020-07-09T08:10:18.278579Z"
          },
          "create_at": "2020-07-09T08:10:18Z",
          "update_at": "2020-07-09T08:10:18Z"
      }
  ]

状态码

• 正常

  表6 状态码

  状态码	描述
  200	查询堆栈元素列表成功

• 异常

  表7 状态码

  状态码	描述
  404	请求堆栈不存在
  500	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。