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 | 一覧を取得するスタックのステータスです。クエリ文字列として名前=値のセットを複数回指定できます。以下のステータスが有効です。
|
name | query | String | No | 一覧を取得するスタックの名前です。クエリ文字列として名前=値のセットを複数回指定できます。 |
limit | query | String | No | 一覧を取得するスタックの数です。 marker パラメーターと組み合わせて使います。 |
marker | query | String | No | limit パラメーターを指定して取得したスタック一覧のうち、最後のスタックのIDを指定します。ソート順に従って、IDを指定したスタックの次以降のスタックの一覧を取得します。デフォルトのソート順はスタックの作成日時の降順です。 存在しないスタックのIDを指定した場合は、このオプションは無視されます。 |
sort_keys | query | String | No | スタックをソートする項目を指定します。クエリ文字列の値としてカンマ区切りで複数の項目を指定できます。以下の項目が有効です。省略したときの値は created_at です。
|
sort_dir | query | String | No | ソートの方向を指定します。
|
本操作ではリクエストボディ部の指定は不要です。
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": ""
}
]
}