本文へジャンプします。

ニフクラ ユーザーガイド

DescribeEventAttributes

処理概要

ニフクラサービスのイベント情報詳細を月単位で取得します。

リクエストURL

GET /events/attributes/{year_month}

指定するパラメーター

パスパラメーター
パラメーター 説明 必須
year_month string 表示する年月を yyyy-mm 形式で指定します。
クエリパラメーター
パラメーター 説明 必須
mode string イベントを表示する対象を以下から選択します。
値: user (顧客影響のあるイベント) | all (すべてのイベント)
Default: user
location string リージョンまたはゾーンを指定できます。
指定可能なリージョン・ゾーンについては、リージョン/ゾーンをご参照ください。
指定がない場合は利用可能なすべての region をリクエストします。

応答フィールド

フィールド (項目) 説明
requestID string リクエスト時に発行されるユニークキー
datetime string レスポンスを返した時刻
data object
mode string 指定した表示範囲。"all"または"user"が入ります。
targetDate string 指定した日時
event[] object[]
eventID string 障害/メンテナンス/お知らせのイベントID
eventStatus string イベントの現在のステータス
値: 0 (メンテナンス予定) | 1 (メンテナンス済) | 2 (メンテナンス中止) | 3 (障害発生中) | 4 (障害復旧済) | 5 (障害影響無し) | 6 (お知らせ)
startAt string イベントの開始(発生)時刻
endAt string イベントの終了(復旧)時刻
eventHistory[] object[]
date string 新規通知または更新通知された時間
message string 通知内容
affectedService[] object[]
number number 連番で番号を付与
location string 対象のロケーション( region,zone )
service string 対象のサービス名
menu string 対象のメニュー名
influence string 影響内容の説明文
resource[] object[]
resourceType string リソース種別
resourceName string リソース名称
diskName string 増設ディスク名称(あれば表示)
status string 現在のステータス
値: 0 (メンテナンス予定) | 1 (メンテナンス済) | 2 (メンテナンス中止) | 3 (障害発生中) | 4 (障害復旧済) | 5 (障害影響無し) | 6 (お知らせ)
startAt string 開始日時(yyyy-MM-ddTHH:mm:ss)
endAt string 終了日時(yyyy-MM-ddTHH:mm:ss)

リクエストサンプル

    curl -X GET https://service-activity.api.nifcloud.com/api/events/attributes/2020-11?mode=user&location=east-12
  -H "Authorization: NIFTY4-HMAC-SHA256 ..."

  

応答サンプル

    {
  "requestID": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
  "datetime": "2020-12-01T15:04:05+09:00",
  "data": {
      "targetDate": "2020-11-30",
      "mode": "all",
      "event": [
          {
              "eventID": "mnt-000001",
              "eventStatus": "1",
              "startAt": "2020-11-30T01:00:00+09:00",
              "endAt": "2020-11-30T02:00:00+09:00",
              "eventHistory": [
                  {
                      "date": "2020-11-16T16:00:00+09:00",
                      "message": "2020/11/30 01:00~02:00の時間帯において、\n信頼性向上の機器保守に伴うメンテナンスを実施いたします"
                  },
                  {
                      "date": "2020-11-30T01:30:00+09:00",
                      "message": "2020/06/30 02:00終了予定でしたが、2020/06/30 04:00終了予定に延長いたします。\nお客様にはご迷惑をおかけし申し訳ございません。"
                  },
                  {
                      "date": "2020-11-30T04:00:00+09:00",
                      "message": "メンテナンス作業は4:00をもちまして作業完了いたしました。\n現在は通常通りご利用いただけます。"
                  }
              ],
              "affectedService": [
                  {
                      "number": 1,
                      "location": "east-12",
                      "service": "コンピューティング",
                      "menu": "サーバー",
                      "influence": "コントロールパネルおよびAPI利用不可",
                      "resource": [
                          {
                              "resourceType": "サーバー",
                              "resourceName": "Myserv01",
                              "diskName": ""
                          },
                          {
                              "resourceType": "サーバー",
                              "resourceName": "Myserv02",
                              "diskName": ""
                          }
                      ],
                      "status": "1",
                      "startAt": "2020-11-30T01:00:00+09:00",
                      "endAt": "2020-11-30T04:00:00+09:00"
                  }
              ]
          },
          {
              "eventID": "trb-000001",
              "startAt": "2020-11-30T02:47:00+09:00",
              "eventHistory": [
                  {
                      "date": "2020-11-30T02:47:00+09:00",
                      "message": "ゾーンeast-12にて、一部のロードバランサーの振り分けが意図した通りに機能しない事象が確認されています。\n現在詳細について調査中のため、ご不便をお掛けいたしますが今しばらくお待ちください。"
                  }
              ],
              "affectedSercice": [
                  {
                      "number": 1,
                      "location": "east-12",
                      "service": "ネットワーク",
                      "menu": "ロードバランサー",
                      "influence": "ロードバランサーの信頼性低下",
                      "resource": [
                          {
                              "resourceType": "ロードバランサー",
                              "resourceName": "myLoadBalancer01",
                              "diskName": ""
                          },
                          {
                              "resourceType": "ロードバランサー",
                              "resourceName": "myLoadBalancer02",
                              "diskName": ""
                          }
                      ],
                      "status": "3",
                      "startAt": "2020-11-30T02:47:00+09:00"
                  }
              ]
          }
      ]
  }
}

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年9月13日時点の情報です。

推奨画面サイズ 1024×768 以上