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"
        }
    ]
}