List resource events#
リソースイベントを一覧表示します。
APIエンドポイント#
リージョン | APIエンドポイント |
---|---|
西日本リージョン3の場合 | https://orchestration.jp-west-3.cloud.global.fujitsu.com |
東日本リージョン3の場合 | https://orchestration.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
GET
/v1/{tenant_id}/stacks/{stack_name}/{stack_id}/resources/{resource_name}/events
HTTPステータスコード#
正常時:200
エラー時:400, 401, 404
リクエストパラメータの説明#
名前 | In | Type | デフォルト値 /必須指定 |
Description |
---|---|---|---|---|
tenant_id | path | string | 必須 | プロジェクトID |
stack_name | path | string | 必須 | スタック名 |
stack_id | path | string | 必須 | スタックのUUID |
resource_name | path | string | 必須 | リソース名 |
resource_action | query | string | 任意 | スタックのリソースアクション 指定可能な値は「ADOPT」、「CHECK」、「CREATE」、「DELETE」、「INIT」、「RESTORE」、「RESUME」、「ROLLBACK」、「SNAPSHOT」、「SUSPEND」、または「UPDATE」です。 |
resource_status | query | string | 任意 | レスポンスをスタックのステータスで絞り込みます。指定可能なステータスは「COMPLETE」、「FAILED」と「IN_PROGRESS」です。複数指定可能です。 |
resource_name | query | string | 任意 | レスポンスをリソース名で絞り込みます。複数指定可能です。 |
resource_type | query | string | 任意 | レスポンスをスタックのリソースタイプで絞り込みます。複数指定可能です。 |
limit | query | integer | 任意 | クエリ結果で返却される項目の最大数 指定されたlimit値を超えない範囲で、最大個数の項目が返却されます。limitパラメータを指定した場合、レスポンス内の最後の項目のIDをmarkerパラメータで指定して再度リクエストを送ることで、リストの続きを取得することができます。 |
marker | query | string | 任意 | 前回のレスポンスの最後の項目のID limitパラメータを指定した場合、レスポンス内の最後の項目のIDをmarkerパラメータで指定して再度リクエストを送ることで、リストの続きを取得することができます。 |
sort_keys | query | string | 任意 | 指定するキーでレスポンスをソートします。 |
sort_dir | query | string | 任意 | ソートの方向 asc (ascending:昇順)、またはdesc (descending:降順)です。 |
nested_depth | query | integer | 任意 | 指定する階層までの入れ子が返却されます。 |
レスポンスボディ(正常系)の説明#
名前 | Type | Description |
---|---|---|
events | array | イベントのパラメータのキーと値のペアのリスト |
event_time | string | リソースの作成日時 日時の入力形式は以下のISO 8601形式です。 CCYY-MM-DDThh:mm:ss±hh:mm 例:2015-08-27T09:49:58-05:00 |
id | string | イベントのUUID |
links | array | イベントのURLのリスト 各URLはhrefとrelのキーペアを含めるJSONのオブジェクトです。 relは対象のイベントとの関係を示します。 |
logical_resource_id | string | スタックの論理リソースのID |
physical_resource_id | string | スタックの物理リソースのID |
resource_name | string | リソース名 |
resource_properties | object | イベントに関連付けられているリソースのパラメータを含めるリスト |
resource_status | string | リソースのステータス |
resource_status_reason | string | リソースのステータスの理由 |
resource_type | string | リソースのタイプの名前 |
レスポンス例#
{ "events": [ { "event_time": "2014-07-23T08:14:47Z", "id": "474bfdf0-a450-46ec-a78a-0c7faa404073", "links": [ { "href": "http://192.168.123.200:8004/v1/dc4b074874244f7693dd65583733a758/stacks/aws_port/db467ed1-50b5-4a3e-aeb1-396ff1d151c5/resources/port/events/474bfdf0-a450-46ec-a78a-0c7faa404073", "rel": "self" }, { "href": "http://192.168.123.200:8004/v1/dc4b074874244f7693dd65583733a758/stacks/aws_port/db467ed1-50b5-4a3e-aeb1-396ff1d151c5/resources/port", "rel": "resource" }, { "href": "http://192.168.123.200:8004/v1/dc4b074874244f7693dd65583733a758/stacks/aws_port/db467ed1-50b5-4a3e-aeb1-396ff1d151c5", "rel": "stack" } ], "logical_resource_id": "port", "physical_resource_id": null, "resource_name": "port", "resource_status": "CREATE_FAILED", "resource_status_reason": "NotFound: Subnet f8a699d0-3537-429e-87a5-6b5a8d0c2bf0 could not be found" }, { "event_time": "2014-07-23T08:14:47Z", "id": "66fa95b6-e6f8-4f05-b1af-e828f5aba04c", "links": [ { "href": "http://192.168.123.200:8004/v1/dc4b074874244f7693dd65583733a758/stacks/aws_port/db467ed1-50b5-4a3e-aeb1-396ff1d151c5/resources/port/events/66fa95b6-e6f8-4f05-b1af-e828f5aba04c", "rel": "self" }, { "href": "http://192.168.123.200:8004/v1/dc4b074874244f7693dd65583733a758/stacks/aws_port/db467ed1-50b5-4a3e-aeb1-396ff1d151c5/resources/port", "rel": "resource" }, { "href": "http://192.168.123.200:8004/v1/dc4b074874244f7693dd65583733a758/stacks/aws_port/db467ed1-50b5-4a3e-aeb1-396ff1d151c5", "rel": "stack" } ], "logical_resource_id": "port", "physical_resource_id": null, "resource_name": "port", "resource_status": "CREATE_IN_PROGRESS", "resource_status_reason": "state changed" } ] }