edit-icon download-icon

Query stack information

Last Updated: May 18, 2018

Call /stacks/{StackName}/{StackId} by GET to query the detailed information about a specific stack.

Request parameters

Name Location Type Required Description
RegionId Query String Yes The ID of the region specified during stack creation.
StackName URI String Yes Name of the stack, which must comply with the regular expression ^[a-zA-Z][a-zA-Z0-9_.-]*$. It can contain up to 255 characters.
StackId URI String Yes Stack ID.

Return parameters

Name Parameter type Description
Parameters JSON Stack parameters in JSON format.
Id String Stack ID.
Region String Region where the stack is located.
Name String Stack name.
Updated String Update time, which follows the ISO8601 standard and uses UTC time. The format is YYYY-MM-DDThh:mm:ssZ.
Created String Stack creation time, which follows the ISO8601 standard and uses UTC time. The format is YYYY-MM-DDThh:mm:ssZ.
TemplateDescription String Stack description.
StatusReason String Reason of the status.
Status String Stack status. Value options: CREATE_COMPLETE, CREATE_FAILED, CREATE_IN_PROGRESS, DELETE_FAILED, DELETE_IN_PROGRESS, ROLLBACK_COMPLETE, ROLLBACK_FAILED, and ROLLBACK_IN_PROGRESS.
Outputs List List of output definitions.
DisableRollback Boolean Whether to disable rollback when the stack fails to be created. “True” indicates that rollback is disabled. That is, rollback is not performed when the stack creation fails. “False” indicates that rollback is not disabled. That is, rollback is performed when the stack creation fails.
TimeoutMins Integer Timeout for stack creation, in minutes.

Error codes

Error code Description HTTP status code Meaning
InternalError Server error. 500 Server-side unknown exception.
StackNotFound The Stack (%(stack_name)s) cannot be found. 404 The stack cannot be found.
InvalidParameter The specified parameter %(parameter)s is not valid. 400 Invalid parameter.

Example

Request example

  1. GET http://ros.aliyuncs.com/stacks/myStack/378826b1-a71b-4c14-aa91-9b36351fbea9 HTTP/1.1
  2. x-acs-signature-method: HMAC-SHA1
  3. Authorization: acs ACSTQDkNtSMrZtwL:QnReVdih0pYK5MpRJwjIhCYsssY=
  4. Date: Fri, 11 Sep 2015 05:29:18 GMT
  5. x-acs-signature-version: 1.0
  6. x-sdk-client: Java/2.0.0
  7. Accept: application/octet-stream
  8. x-acs-version: 2015-09-01
  9. Cache-Control: no-cache
  10. Pragma: no-cache
  11. User-Agent: Java/1.6.0_27
  12. Host: ros.aliyuncs.com
  13. Connection: keep-alive

Response example

  1. HTTP/1.1 200 OK
  2. Date: Fri, 11 Sep 2015 05:29:18 GMT
  3. Content-Type: application/json; charset=UTF-8
  4. Content-Length: 521
  5. Connection: close
  6. Access-Control-Allow-Origin: *
  7. Access-Control-Allow-Methods: POST, GET, OPTIONS
  8. Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
  9. Access-Control-Max-Age: 172800
  10. X-Acs-Request-Id: 8E3F90A8-2F10-443E-9F54-4895CFEFD342
  11. Server: Jetty(7.2.2.v20101205)
  12. {
  13. "Id" : "378826b1-a71b-4c14-aa91-9b36351fbea9",
  14. "Updated" : null,
  15. "DisableRollback" : true,
  16. "TimeoutMins" : 15,
  17. "TemplateDescription" : "No description",
  18. "StatusReason" : "Stack CREATE completed successfully",
  19. "Created" : "2015-09-11T07:38:03Z",
  20. "Region" : "cn-beijing",
  21. "Status" : "CREATE_COMPLETE",
  22. "Name" : "myStack",
  23. "Outputs" :
  24. [{
  25. "output_key" : "secret1_v",
  26. "description" : "secret1",
  27. "output_value" : {
  28. "get_attr" :
  29. [
  30. "secret1",
  31. "value"
  32. ]
  33. }
  34. }
  35. ],
  36. "Parameters" : {
  37. "ALIYUN::StackId" : "378826b1-a71b-4c14-aa91-9b36351fbea9",
  38. "ALIYUN::StackName" : "myStack"
  39. }
  40. }
Thank you! We've received your feedback.