List stack data

Method URI Description
GET /v1/{tenant_id}/stacks{?status, name,limit,marker,sort_keys, sort_dir} アクティブなスタックの一覧を表示します。

Normal response codes: 200

Error response codes: badRequest (400), unauthorized (401), internalServerError (500)

Request

下表は、スタックデータ一覧取得リクエストのパラメーターの一覧です。

Parameter Style Type Required Description
tenant_id URI String Yes プロジェクトID
status query String No 一覧を取得するスタックのステータスです。クエリ文字列として名前=値のセットを複数回指定できます。以下のステータスが有効です。
  • COMPLETE
  • FAILED
  • IN_PROGRESS
name query String No 一覧を取得するスタックの名前です。クエリ文字列として名前=値のセットを複数回指定できます。
limit query String No 一覧を取得するスタックの数です。 marker パラメーターと組み合わせて使います。
marker query String No limit パラメーターを指定して取得したスタック一覧のうち、最後のスタックのIDを指定します。ソート順に従って、IDを指定したスタックの次以降のスタックの一覧を取得します。デフォルトのソート順はスタックの作成日時の降順です。 存在しないスタックのIDを指定した場合は、このオプションは無視されます。
sort_keys query String No スタックをソートする項目を指定します。クエリ文字列の値としてカンマ区切りで複数の項目を指定できます。以下の項目が有効です。省略したときの値は created_at です。
  • name
  • status
  • created_at
  • updated_at
sort_dir query String No ソートの方向を指定します。
  • asc

    昇順ソートします。

  • desc

    降順ソートします。

本操作ではリクエストボディ部の指定は不要です。

Response

Example. List stack data: JSON response


{
	"stacks": [
		{
			"creation_time": "2014-06-03T20:59:46Z", 
			"description": "sample stack",
			"id": "3095aefc-09fb-4bc7-b1f0-f21a304e864c", 
			"links": [
				{
					"href": "http://192.168.123.200:8004/v1/ eb1c63a4f77141548385f113a28f0f52/stacks/simple_stack/3095aefc-09fb-4bc7-b1f0- f21a304e864c",
					"rel":   "self"
				}
			],
			"stack_name": "simple_stack",
			"stack_status": "CREATE_COMPLETE",
			"stack_status_reason": "Stack CREATE completed successfully",
			"updated_time": ""
		}
	]
}