• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Heat
  5. Stacks
  6. Show Stack Details

Show Stack Details

Function Description

This interface is used to query stack details.

Interface Format

Method

URI

Description

GET

/v1/{tenant_id}/stacks/{stack_name}/{stack_id}

Queries stack details.

Request Parameter

N/A

Response Parameter

Parameter

Type

Mandatory

Description

id

UUID string

Yes

Specifies the stack UUID.

stack_name

List(dict)

Yes

Specifies the stack name.

stack_status

String

Yes

Specifies the stack status.

stack_status_reason

String

Yes

Specifies the description of the stack operation.

description

String

Yes

Describes the stack.

links

String

Yes

Specifies the stack URI.

creation_time

String

Yes

Specifies the time when a stack was created.

updated_time

String

Yes

Specifies the time when a stack was updated.

disable_rollback

Boolean

Yes

Specifies whether to perform a rollback if the update fails.

parameters

Dict

Yes

Specifies the stack parameters.

timeout_mins

Int

Yes

Specifies the timeout duration.

template_description

String

Yes

Specifies the template description.

Request Example

GET /v1/95d02433133a4c0a87ba6967474a2ad3/stacks/HeatStack/c89c4bb3-96cb-4a55-aafa-076a7939a306

Response Example

{"stack": {
   "disable_rollback": true,
   "description": "Hello world HOT template that just defines a single compute instance. Contains just base features to verify base HOT support.\n",
   "parameters":    {
      "Network": "3f8713b7-8aea-4b0f-a70b-98d4e1d6251f",
      "OS::stack_name": "HeatStack",
      "ImageId": "68e22196-a4aa-4946-85c3-75f4957e667a",
      "OS::stack_id": "c89c4bb3-96cb-4a55-aafa-076a7939a306",
      "KeyName": "heat-key",
      "OS::project_id": "95d02433133a4c0a87ba6967474a2ad3",
      "InstanceType": "m1.tiny"
   },
   "stack_status_reason": "Stack create completed successfully",
   "stack_name": "HeatStack",
   "outputs": [   {
      "output_value": "10.11.12.2",
      "description": "The IP address of the deployed instance",
      "output_key": "instance_ip"
   }],
   "creation_time": "2014-01-26T17:21:35Z",
   "links": [   {
      "href": "http://172.25.150.29:8004/v1/95d02433133a4c0a87ba6967474a2ad3/stacks/HeatStack/c89c4bb3-96cb-4a55-aafa-076a7939a306",
      "rel": "self"
   }],
   "capabilities": [],
   "notification_topics": [],
   "timeout_mins": 60,
   "stack_status": "CREATE_COMPLETE",
   "updated_time": "2014-01-26T17:21:41Z",
   "id": "c89c4bb3-96cb-4a55-aafa-076a7939a306",
   "template_description": "Hello world HOT template that just defines a single compute instance. Contains just base features to verify base HOT support.\n"
}}

Returned Code

See section Return Code Processing.