edit-icon download-icon

Discard a stack

Last Updated: May 18, 2018

Use DELETE method to call the URI (/stacks/{StackName}/{StackId}/abandon) to discard a stack, while the resources in the stack are retained.

Request parameters

Name Location Type Required? Description
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.
RegionId Query String Yes The ID of the region specified during stack creation.

Returned parameters

Name Parameter type Description
Id String Stack ID
Name String Stack name
Action String Action
Status String Status
Template Json Template
Resources Json Resources
Environment Json Environment

Error codes

Error code Description HTTP status code Meaning
InternalError Server error. 500 Server-side unknown exception.
StackNotFound The Stack (%(stack_name)s) could not be found. 404 The stack does not exist.

Example

Request example

  1. DELETE http://ros.aliyuncs.com/stacks/myStack/28087440-3701-40ef-bbe8-6e80787d307f/abandon HTTP/1.1
  2. x-acs-signature-method: HMAC-SHA1
  3. Authorization: acs ACSTQDkNtSMrZtwL:3TCZAbfoSw8bpVeg/X5Uag1KgM8=
  4. Date: Fri, 11 Sep 2015 05:30:02 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. "Status" : "COMPLETE",
  14. "Name" : "test",
  15. "Environment" : {
  16. "parameter_defaults" : {},
  17. "parameters" : {},
  18. "resource_registry" : {
  19. "resources" : {}
  20. }
  21. },
  22. "Template" : {
  23. "Outputs" : {
  24. "secret1_v" : {
  25. "Description" : "secret1",
  26. "Value" : {
  27. "get_attr" : ["secret1", "value"]
  28. }
  29. }
  30. },
  31. "Resources" : {
  32. "secret1" : {
  33. "Type" : "ALIYUN::RandomString"
  34. },
  35. "securet3" : {
  36. "Type" : "ALIYUN::RandomString",
  37. "Properties" : {
  38. "length" : 100,
  39. "sequence" : "octdigits"
  40. }
  41. },
  42. "securet2" : {
  43. "Type" : "ALIYUN::RandomString",
  44. "Properties" : {
  45. "length" : 10
  46. }
  47. }
  48. },
  49. "ROSTemplateFormatVersion" : "2015-09-01"
  50. },
  51. "Action" : "CREATE",
  52. "Id" : "698ac08a-239d-4f2c-9609-afda80823531",
  53. "Resources" : {
  54. "secret1" : {
  55. "status" : "COMPLETE",
  56. "name" : "secret1",
  57. "resource_data" : {
  58. "value" : "ccsE2UZXxWX4oqu0lUpFqaZFulSc70jx"
  59. },
  60. "resource_id" : "test-secret1-x7equc4ngnfw",
  61. "action" : "CREATE",
  62. "type" : "ALIYUN::RandomString",
  63. "metadata" : {}
  64. },
  65. "securet3" : {
  66. "status" : "COMPLETE",
  67. "name" : "securet3",
  68. "resource_data" : {
  69. "value" : "asfdasdf"
  70. },
  71. "resource_id" : "test-securet3-hj5nvc7xaerg",
  72. "action" : "CREATE",
  73. "type" : "ALIYUN::RandomString",
  74. "metadata" : {}
  75. },
  76. "securet2" : {
  77. "status" : "COMPLETE",
  78. "name" : "securet2",
  79. "resource_data" : {
  80. "value" : "qGOkT6QX61"
  81. },
  82. "resource_id" : "test-securet2-xehhwo52odw6",
  83. "action" : "CREATE",
  84. "type" : "ALIYUN::RandomString",
  85. "metadata" : {}
  86. }
  87. }
  88. }
Thank you! We've received your feedback.