Monitorings - Super OCN Flexible Connect API リファレンス (1.1.0-BGP-1)
Download OpenAPI specification:Download
Routings Traffic bps Trend API
Routings リソースの トラフィックトレンド を取得する API
レポート期間と粒度の指定の注意点
- レポート期間: startTime 以上, endTime 未満のデータをレポート対象とする
- 指定したレポート期間の範囲が古すぎる or 新しすぎる場合はエラー
- 万が一途中にデータ欠損した時間帯が含まれてもエラーとはならない一方、ゼロ埋め等の補正も行われない
- データ発生時間からそれがレポートされるまでにはシステム制約によりタイムラグが発生する
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
routingId | string ^ox[0-9]{10}$ Example: routingId=ox1234567890 Routings リソースのID.
|
startTime | string <date-time> Example: startTime=2019-07-31T18:00:00+09:00 レポート期間の開始時刻
|
endTime | string <date-time> Example: endTime=2019-07-31T18:00:00+09:00 レポート期間の終了時刻
|
interval | string Default: "5m" Enum: "5m" "1d" データ粒度
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "trends": [
- {
- "routingId": "ox1234567890",
- "timestamp": [
- "2019-05-21T10:05:00+09:00",
- "2019-05-21T10:10:00+09:00",
- "2019-05-21T10:15:00+09:00"
], - "bpsIn": [
- 561607,
- 560,
- 25617
], - "bpsOut": [
- 1123214,
- 1120,
- 51234
]
}, - {
- "routingId": "ox1234567891",
- "timestamp": [
- "2019-05-21T10:05:00+09:00",
- "2019-05-21T10:10:00+09:00",
- "2019-05-21T10:15:00+09:00"
], - "bpsIn": [
- 5616070,
- 5601,
- 256127
], - "bpsOut": [
- 11232143,
- 11204,
- 512345
]
}
]
}
Aggregated Routings Traffic bps Trend API
Routings リソースの テナント内合計トラフィックトレンド を取得する API
レポート期間と粒度の指定の注意点
- レポート期間: startTime 以上, endTime 未満のデータをレポート対象とする
- 指定したレポート期間の範囲が古すぎる or 新しすぎる場合はエラー
- 指定したインターバルに対してレポート期間範囲が整合しない場合もエラー
- 万が一途中にデータ欠損した時間帯が含まれてもエラーとはならない一方、ゼロ埋め等の補正も行われない
- データ発生時間からそれがレポートされるまでにはシステム制約によりタイムラグが発生する
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
startTime | string <date-time> Example: startTime=2019-07-31T18:00:00+09:00 レポート期間の開始時刻
|
endTime | string <date-time> Example: endTime=2019-07-31T18:00:00+09:00 レポート期間の終了時刻
|
interval | string Default: "5m" Enum: "5m" "1d" データ粒度
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "timestamp": [
- "2019-05-21T10:05:00+09:00",
- "2019-05-21T10:10:00+09:00",
- "2019-05-21T10:15:00+09:00"
], - "bpsIn": [
- 1561607,
- 1560,
- 125617
], - "bpsOut": [
- 11123214,
- 11120,
- 151234
]
}
Routings Traffic bps Forecast API
Routings リソースの トラフィック予測 を取得する API
レポート期間の指定の注意点
- レポート期間: 現在時刻 以上, endTime 未満のデータをレポート対象とする
- endTimeを現在時刻から366日以降の日時を指定した場合はエラー
- 最低1日平均データが2つ存在していれば、出力される
- 万が一途中にデータ欠損した時間帯が含まれてもエラーとはならない一方、ゼロ埋め等の補正も行われない
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
routingId | string ^ox[0-9]{10}$ Example: routingId=ox1234567890 Routings リソースのID.
|
endTime | string <date-time> Example: endTime=2019-07-31T18:00:00+09:00 レポート期間の終了時刻
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "forecasts": [
- {
- "routingId": "ox1234567890",
- "timestamp": [
- "2019-05-21T10:05:00+09:00",
- "2019-05-21T10:10:00+09:00",
- "2019-05-21T10:15:00+09:00"
], - "bpsInUpper": [
- 561607,
- 560,
- 25617
], - "bpsOutUpper": [
- 1123214,
- 1120,
- 51234
], - "bpsInLower": [
- 561607,
- 560,
- 25617
], - "bpsOutLower": [
- 1123214,
- 1120,
- 51234
], - "bpsOut": [
- 1123214,
- 1120,
- 51234
], - "bpsIn": [
- 561607,
- 560,
- 25617
]
}, - {
- "routingId": "ox1234567891",
- "timestamp": [
- "2019-05-21T10:05:00+09:00",
- "2019-05-21T10:10:00+09:00",
- "2019-05-21T10:15:00+09:00"
], - "bpsInUpper": [
- 561607,
- 560,
- 25617
], - "bpsOutUpper": [
- 1123214,
- 1120,
- 51234
], - "bpsInLower": [
- 561607,
- 560,
- 25617
], - "bpsOut": [
- 1123214,
- 1120,
- 51234
], - "bpsIn": [
- 561607,
- 560,
- 25617
]
}
]
}
Aggregated Routings Traffic bps Forecast API
Routings リソースの テナント内合計トラフィック予測 を取得する API
レポート期間の指定の注意点
- レポート期間: 現在時刻 以上, endTime 未満のデータをレポート対象とする
- endTimeを現在時刻から366日以降の日時を指定した場合はエラー
- 最低1日平均データが2つ存在していれば、出力される
- 万が一途中にデータ欠損した時間帯が含まれてもエラーとはならない一方、ゼロ埋め等の補正も行われない
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
endTime | string <date-time> Example: endTime=2019-07-31T18:00:00+09:00 レポート期間の終了時刻
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "timestamp": [
- "2019-05-21T10:05:00+09:00",
- "2019-05-21T10:10:00+09:00",
- "2019-05-21T10:15:00+09:00"
], - "bpsInUpper": [
- 561607,
- 560,
- 25617
], - "bpsOutUpper": [
- 1123214,
- 1120,
- 51234
], - "bpsInLower": [
- 561607,
- 560,
- 25617
], - "bpsOutLower": [
- 561607,
- 560,
- 25617
], - "bpsOut": [
- 1123214,
- 1120,
- 51234
], - "bpsIn": [
- 561607,
- 560,
- 25617
]
}
Routings Traffic Peak Mbps API
Routings リソースの 課金指標値と同等のピークトラフィック量を取得する API
注意点
- 計算ロジック
- テナント内の全 Routings リソースのトラフィックを 5分毎に合計する (in, out それぞれ)
- in, out の総トラフィックトレンドの 1ヶ月単位で 95 パーセンタイル値 を算出し、より大きい値を採用
- 単位は Mbps で、小数点以下は切り上げ
- ピーク値は当月を含む過去6ヶ月分を保持する (UTC基準)
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "months": [
- "2020-01",
- "2020-02",
- "2020-03",
- "2020-04",
- "2020-05",
- "2020-06"
], - "peaks": [
- 10,
- 23,
- 30,
- 41,
- 52,
- 67
]
}
Routings Current Health Status API
Routings リソースの 最新の健全性情報を取得する API
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
routingId | string ^ox[0-9]{10}$ Example: routingId=ox1234567890 Routings リソースのID.
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "statuses": [
- {
- "routingId": "ox0000000000",
- "timestamp": "2019-05-21T10:05:48+09:00",
- "ipv4Ping": {
- "status": "ok"
}, - "ipv6Ping": {
- "status": "ok"
}, - "ipv4BgpPeer": {
- "status": "up"
}, - "ipv6BgpPeer": {
- "status": "up"
}
}, - {
- "routingId": "ox0000000001",
- "timestamp": "2019-05-21T10:05:48+09:00",
- "ipv4Ping": {
- "status": "ng",
- "info": "unreachable"
}, - "ipv6Ping": {
- "status": "ok"
}, - "ipv4BgpPeer": {
- "status": "down",
- "info": "Cease - Maximum Number of Prefixes Reached"
}, - "ipv6BgpPeer": {
- "status": "up"
}
}, - {
- "routingId": "ox0000000002",
- "timestamp": "2019-05-21T10:05:48+09:00",
- "ipv4Ping": {
- "status": "ok"
}
}
]
}
Health Events API
全リソースの健全性に関するイベント履歴を一覧情報を取得する API。
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
routingId | string Example: routingId=ox1234567890 Routings リソースのID.
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "events": [
- {
- "timestamp": "2019-05-21T10:05:50+09:00",
- "resource": "routings",
- "resourceId": "ox0000000000",
- "event": "ipv4-ping-ok",
- "eventId": "4a2ad3c6455441658016a8815b62e0ce"
}, - {
- "timestamp": "2019-05-21T10:05:52+09:00",
- "resource": "routings",
- "resourceId": "ox0000000000",
- "event": "ipv4-bgp-down",
- "eventId": "72d0abdf5fbd4ea2b5540d0bb26226da",
- "info": "bgp-max-prefix-exceeded"
}
]
}
BGP stats list API
OCN 装置から見た BGP 送受信経路数を一覧参照する API
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
routingId | string ^ox[0-9]{10}$ Example: routingId=ox1234567890 Routings リソースのID.
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "stats": [
- {
- "routingId": "ox0000000000"
}, - {
- "routingId": "ox0000000001",
- "ipv4Stats": {
- "operation": "refresh",
- "requestTime": "2021-01-18T10:05:48+09:00",
- "status": "completed",
- "result": {
- "lastUpdated": "2021-01-18T10:15:48+09:00",
- "receivingRoutes": 30,
- "acceptedRoutes": 25,
- "advertisingRoutes": 100
}
}, - "ipv6Stats": {
- "operation": "refresh",
- "requestTime": "2021-01-18T10:05:48+09:00",
- "status": "processing"
}
}, - {
- "routingId": "ox0000000002",
- "ipv6Stats": {
- "operation": "refresh",
- "requestTime": "2021-01-18T10:05:48+09:00",
- "status": "failed",
- "result": {
- "lastUpdated": "2021-01-12T09:05:48+09:00",
- "receivingRoutes": 10,
- "acceptedRoutes": 9,
- "advertisingRoutes": 100
}
}
}
]
}
BGP sessions list API
BGP セッションリセットの実行結果を一覧参照する API
path Parameters
tenantId required | string ^[0-9a-f]{32}$ Example: 550e8400e29b41d4a716446655440000 SDPF のテナントに一意に与えられる ID. UUID 形式 |
query Parameters
routingId | string ^ox[0-9]{10}$ Example: routingId=ox1234567890 Routings リソースのID.
|
header Parameters
X-Auth-Token required | string ^[0-9a-f]{32}$ Example: dc03494823a841338430052e9ee95e07 クライアントが Keystone を利用して取得した認証 Token |
Responses
OK
Response samples
- 200
{- "tenantId": "550e8400e29b41d4a716446655440000",
- "sessions": [
- {
- "routingId": "ox0000000000"
}, - {
- "routingId": "ox0000000001",
- "ipv4Session": {
- "operation": "reset",
- "requestTime": "2021-01-23T10:05:48+09:00",
- "status": "processing"
}, - "ipv6Session": {
- "operation": "reset",
- "requestTime": "2021-01-21T10:05:48+09:00",
- "status": "completed",
- "result": {
- "lastUpdated": "2021-01-18T10:10:48+09:00"
}
}
}, - {
- "routingId": "ox0000000002",
- "ipv6Session": {
- "operation": "reset",
- "requestTime": "2021-01-22T10:05:48+09:00",
- "status": "failed"
}
}
]
}