Arcstar Universal One API

概要

 ■ Arcstar Universal One(国内回線)に関連し、下記のAPIを提供します。
  ・Arcstar Universal One 契約詳細情報取得API
  ・Arcstar Universal One 設備情報取得API
  ・Arcstar Universal One トラフィック情報取得API
  ・Arcstar Universal One 回線アラーム情報取得API
  ・Arcstar Universal One ギャランティ 工事情報取得API
   ‐ ギャランティ 工事情報更新一覧取得API
   ‐ ギャランティ 工事詳細情報取得API
  ・Arcstar Universal One ベストエフォート 工事情報取得API
  ・Arcstar Universal One 回線監視停止情報API
   ‐ 回線監視停止情報取得API
   ‐ 回線監視停止情報登録API
   ‐ 回線監視停止情報更新API
   ‐ 回線監視停止情報削除API

 ■ 本APIのご利用に際して
   当該APIサービスを導入していただくため、
 詳細仕様、利用条件(制約等)、利用開始予定日等について
 弊社当該サービス担当者より別途、ご案内させて頂きますので、
 事前にinfo-uno-api@ntt.com宛にてご連絡頂きますようお願い致します。

 【件名】
   (問合せ)Arcstar Universal One APIの利用について

 【記載必要項目】
   - 利用者情報(会社名、組織名、ご担当者名等)
   - 利用開始希望日
   - 利用用途
   - 連絡先(電話番号、メールアドレス等)

Resource URL

 グローバル共通ドメイン、または個別リージョンドメインをご利用ください。
 グローバル共通ドメインを利用する場合、お客様のご利用箇所の状況に応じて、一番近いAPIゲートウェイに接続します。1

1.Base Path(Global Load Balance)

https://api.ntt.com/v3/uno

2.Base Path(Region)

https://{region}.api.ntt.com/v3/uno
  • region is jp|us|uk
  • e.g. https://us.api.ntt.com/v3/uno
  • 指定できるregionは、将来拡充予定

Resource Information  

Key Value
レスポンスフォーマット JSON
認証(OAuth) YES
帯域制御#1 YES

契約詳細情報取得

 VPNグループID及び契約ID(N番)を指定し、契約詳細情報をJSON形式にて返却するAPIです。

 * 国内回線のみ対象です。

契約詳細情報取得

GET /v3/uno/contracts/{vpnGroupId}/{contractId}  

Request Parameters

Name Description Type Mandatory
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId 契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes

Example Request

Host: api.ntt.com  
GET /v3/uno/contracts/V12345678/N123456789 
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。  

Response Parameters

Name Description Type Mandatory
addressType 住所区分
住所を住所情報に保持するにあたり、住所種別を判別する区分
KYS:契約者住所 STB:設置場所住所
String No
postalNumber 郵便番号 Int No
address 住所
日本語/英語表記の住所情報
String No
addressCode 住所コード
住所を特定するコード
String No
banchi1 番地等1
番地情報1
String No
banchi2 番地等2
番地情報2
String No
banchi3 番地等3
番地情報3
String No
building1 建物等1
建物の情報1
String No
building2 建物等2
建物の情報2
String No
building3 建物等3
建物の情報3
String No
samakata 様方等
様方に関する情報
String No
productName 商品名
商品コードの名称
String No
productTypeName 商品種別名
商品種別コードの名称
String No
itemNameProduct 項目名 契約商品詳細
項目ID 契約商品詳細の名称
String No
detailItemValue 詳細項目値
詳細項目の値
String No

Example Result

{
    "addressInfo": [
    {
        "addressType": "KYS",
        "postalNumber": "1000011",
        "address": "東京都千代田●●1丁目",
        "addressCode": "12345678901",
        "banchi1": "1番6号",
        "banchi2": "",
        "banchi3": "",
        "building1": "●●●日比谷ビル",
        "building2": "",
        "building3": "",
        "samakata": ""
    },{
        "addressType": "STB",
        "postalNumber": "1000011",
        "address": "東京都千代田区●●1丁目",
        "addressCode": "12345678901",
        "banchi1": "1番6号",
        "banchi2": "",
        "banchi3": "",
        "building1": "●●●日比谷ビル",
        "building2": "1F",
        "building3": "",
        "samakata": ""
    }],
    "productInfo": [
    {
        "productName": "Universal One",
        "productTypeName": "サービス",
        "productDetailInfo": []
    },{
        "productName": "L2",
        "productTypeName": "レイヤー",
        "productDetailInfo": []
    },{
        "productName": "ギャランティ",
        "productTypeName": "プラン",
        "productDetailInfo": []
    },{
        "productName": "メイン(主回線)",
        "productTypeName": "回線利用用途",
        "productDetailInfo": [
        {
            "itemNameProduct": "冗長化グループ番号",
            "detailItemValue": ""
        },{
            "itemNameProduct": "VPN番号",
            "detailItemValue": "V12345678"
        }]
    },{
        "productName": "ギャランティアクセス",
        "productTypeName": "アクセス",
        "productDetailInfo": []
    },{
        "productName": "イーサタイプ(NTTCom光アクセス)",
        "productTypeName": "タイプ",
        "productDetailInfo": []
    },{
        "productName": "Ether",
        "productTypeName": "イーサネット種別",
        "productDetailInfo": []
    },{
        "productName": "全二重",
        "productTypeName": "通信方式",
        "productDetailInfo": []
    },{
        "productName": "10M",
        "productTypeName": "品目",
        "productDetailInfo": []
    },{
        "productName": "設置場所情報",
        "productTypeName": "部材",
        "productDetailInfo": [
        {
            "itemNameProduct": "設置場所事業所名",
            "detailItemValue": "●●●日比谷ビル"
        }]
    },{
        "productName": "L2 設置無",
        "productTypeName": "UNO-T",
        "productDetailInfo": []
    }]
}

設備情報取得

 VPNグループID、契約ID(N番)、処理種別と情報種別を指定し、設備情報をJSON形式にて返却するAPIです。

設備情報取得

POST /v3/uno/nwInfo/{vpnGroupId}/{contractId}?ifType=20&infoType=vUnoapiUnoMain

Request Parameters

Name Description Type Mandatory
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
ifType 取得する情報の種類(本 API では 20 のみ利用)
例: 20 ※個別情報
path variable Yes
infoType 取得する情報の種別
代表契約情報:vUnoapiUnoMain
代表契約アドレス情報:vUnoapiUnoMainAddress
V間情報:vUnoapiVcon
V間アドレス情報:vUnoapiVconAddress
V間フィルタ情報:vUnoapiVconFilter
マルチキャスト情報:vUnoapiMcBase
MC送信端末アドレス情報:vUnoapiMcBaseAddress
マルチキャストRPユーザアドレス情報:vUnoapiMcMainAddress
拠点契約情報:vUnoapiUnoBase
拠点契約アドレス情報:vUnoapiUnoBaseAddress
拠点契約DHCPアドレス情報:vUnoapiUnoBaseDhcp
拠点契約IPフィルタリングインターネット向け情報:vUnoapiUnoBaseFilter
拠点契約NAT変換情報:vUnoapiUnoBaseNat
拠点契約ToSビット書き換え情報:vUnoapiUnoBaseTos
ASPMSE利用機能情報:vUnoapiAspmseUtil
ASPMSE利用機能アドレス情報:vUnoapiAspmseUtilAddress
ASPMSE利用機能NATフィルタリング情報:vUnoapiAspmseUtilFilter
ASPMSE利用機能NAT端末情報:vUnoapiAspmseUtilNat

例: vUnoapiUnoMain ※代表契約情報
path variable Yes

Example Request

Host: api.ntt.com
POST /v3/uno/nwInfo/V12345678/N123456789?ifType=20&infoType=v_unoapi_uno_main     
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
ifType リクエストした処理種別を返却 String No
contractId リクエストした契約 ID を返却 String No
resultCode 異常応答時、エラー種別を表すコードを返却
※ただし、正常応答時は "00000000" を返却
String No
contractId 代表契約情報:契約ID(N番)
情報種別が「代表契約情報」の場合に返却
String No
addressBorrowingPlan 代表契約情報:アドレス借用プラン
情報種別が「代表契約情報」の場合に返却
String No
ipv4PlanFreeExists 代表契約情報:アドレス設計フリー利用有無(IPv4)
情報種別が「代表契約情報」の場合に返却
String No
vpnConnectionExists 代表契約情報:VPN間通信有無
情報種別が「代表契約情報」の場合に返却
String No
internetConnectionExists 代表契約情報:インターネットコネクト有無
情報種別が「代表契約情報」の場合に返却
String No
internetConnectBand 代表契約情報:インターネットコネクト帯域値
情報種別が「代表契約情報」の場合に返却
String No
contractId 代表契約アドレス情報:契約ID(N番)
情報種別が「代表契約アドレス情報」の場合に返却
String No
addressCodeKind 代表契約アドレス情報:アドレス種別コード
情報種別が「代表契約アドレス情報」の場合に返却
String No
addressNameKind 代表契約アドレス情報:アドレス種別名
情報種別が「代表契約アドレス情報」の場合に返却
String No
address 代表契約アドレス情報:アドレス値
情報種別が「代表契約アドレス情報」の場合に返却
String No
mask 代表契約アドレス情報:アドレスマスク値
情報種別が「代表契約アドレス情報」の場合に返却
String No
contractId V間情報:契約ID(N番)
情報種別が「V間情報」の場合に返却
String No
vconContractNumber V間情報:V間契約番号
情報種別が「V間情報」の場合に返却
String No
connectMainContractNumber V間情報:通信先代表契約番号
情報種別が「V間情報」の場合に返却
String No
connectContractNumber V間情報:通信先契約番号
情報種別が「V間情報」の場合に返却
String No
connectVpnNumber V間情報:通信先VPN番号
情報種別が「V間情報」の場合に返却
String No
vpnConnectionType V間情報:V間接続タイプ
情報種別が「V間情報」の場合に返却
String No
contractId V間アドレス情報:契約ID(N番)
情報種別が「V間アドレス情報」の場合に返却
String No
addressCodeKind V間アドレス情報:アドレス種別コード
情報種別が「V間アドレス情報」の場合に返却
String No
addressNameKind V間アドレス情報:アドレス種別名
情報種別が「V間アドレス情報」の場合に返却
String No
address V間アドレス情報:アドレス値
情報種別が「V間アドレス情報」の場合に返却
String No
mask V間アドレス情報:アドレスマスク値
情報種別が「V間アドレス情報」の場合に返却
String No
vconContractNumber V間アドレス情報:V間契約番号
情報種別が「V間アドレス情報」の場合に返却
String No
connectMainContractNumber V間アドレス情報:通信先代表契約番号
情報種別が「V間アドレス情報」の場合に返却
String No
connectContractNumber V間アドレス情報:通信先契約番号
情報種別が「V間アドレス情報」の場合に返却
String No
contractId V間フィルタ情報:契約ID(N番)
情報種別が「V間フィルタ情報」の場合に返却
String No
vconContractNumber V間フィルタ情報:V間契約番号
情報種別が「V間フィルタ情報」の場合に返却
String No
connectMainContractNumber V間フィルタ情報:通信先代表契約番号
情報種別が「V間フィルタ情報」の場合に返却
String No
connectContractNumber V間フィルタ情報:通信先契約番号
情報種別が「V間フィルタ情報」の場合に返却
String No
filterSerialNumber V間フィルタ情報:フィルタ通番
情報種別が「V間フィルタ情報」の場合に返却
String No
lanAddress V間フィルタ情報:お客様LANアドレス(変換前アドレス)
情報種別が「V間フィルタ情報」の場合に返却
String No
lanAddressMask V間フィルタ情報:お客様LANアドレス(変換前アドレス) マスク
情報種別が「V間フィルタ情報」の場合に返却
String No
conversionType V間フィルタ情報:変換タイプ
情報種別が「V間フィルタ情報」の場合に返却
String No
afterConversionAddress V間フィルタ情報:変換後アドレス
情報種別が「V間フィルタ情報」の場合に返却
String No
afterConversionAddressMask V間フィルタ情報:変換後アドレス マスク
情報種別が「V間フィルタ情報」の場合に返却
String No
protocol V間フィルタ情報:プロトコル
情報種別が「V間フィルタ情報」の場合に返却
String No
startPortNumber V間フィルタ情報:ポート番号(開始)
情報種別が「V間フィルタ情報」の場合に返却
String No
endPortNumber V間フィルタ情報:ポート番号(終了)
情報種別が「V間フィルタ情報」の場合に返却
String No
contractId マルチキャスト情報:契約ID(N番)
情報種別が「マルチキャスト情報」の場合に返却
String No
multicastBand マルチキャスト情報:送信マルチキャスト帯域
情報種別が「マルチキャスト情報」の場合に返却
String No
contractId MC送信端末アドレス情報:契約ID(N番)
情報種別が「MC送信端末アドレス情報」の場合に返却
String No
addressCodeKind MC送信端末アドレス情報:アドレス種別コード
情報種別が「MC送信端末アドレス情報」の場合に返却
String No
addressNameKind MC送信端末アドレス情報:アドレス種別名
情報種別が「MC送信端末アドレス情報」の場合に返却
String No
address MC送信端末アドレス情報:アドレス値
情報種別が「MC送信端末アドレス情報」の場合に返却
String No
mask MC送信端末アドレス情報:アドレスマスク値
情報種別が「MC送信端末アドレス情報」の場合に返却
String No
serialNumber MC送信端末アドレス情報:送信端末アドレス通番
情報種別が「MC送信端末アドレス情報」の場合に返却
String No
contractId マルチキャストRPユーザアドレス情報:契約ID(N番)
情報種別が「マルチキャストRPユーザアドレス情報」の場合に返却
String No
addressCodeKind マルチキャストRPユーザアドレス情報:アドレス種別コード
情報種別が「マルチキャストRPユーザアドレス情報」の場合に返却
String No
addressNameKind マルチキャストRPユーザアドレス情報:アドレス種別名
情報種別が「マルチキャストRPユーザアドレス情報」の場合に返却
String No
address マルチキャストRPユーザアドレス情報:アドレス値
情報種別が「マルチキャストRPユーザアドレス情報」の場合に返却
String No
mask マルチキャストRPユーザアドレス情報:アドレスマスク値
情報種別が「マルチキャストRPユーザアドレス情報」の場合に返却
String No
contractId 拠点契約情報:契約ID(N番)
情報種別が「拠点契約情報」の場合に返却
String No
ipFilterFunctionExists 拠点契約情報:IPフィルタ機能利用有無
情報種別が「拠点契約情報」の場合に返却
String No
useNatNapt 拠点契約情報:NAT/NAPT利用
情報種別が「拠点契約情報」の場合に返却
String No
useTosConversion 拠点契約情報:ToS変換利用有無
情報種別が「拠点契約情報」の場合に返却
String No
baseGrouping 拠点契約情報:拠点区分
情報種別が「拠点契約情報」の場合に返却
String No
multcastExists 拠点契約情報:マルチキャスト有無
情報種別が「拠点契約情報」の場合に返却
String No
unoTerminalExists 拠点契約情報:UniversalOneターミナル有無
情報種別が「拠点契約情報」の場合に返却
String No
unoTerminalKind 拠点契約情報:UniversalOneターミナル種別
情報種別が「拠点契約情報」の場合に返却
String No
csExists 拠点契約情報:CS機有無
情報種別が「拠点契約情報」の場合に返却
String No
ipv4PlanFree 拠点契約情報:お客様LANアドレスv4設計フリー
情報種別が「拠点契約情報」の場合に返却
String No
useTerminalSpeed 拠点契約情報:UNO-T_LAN側インターフェース速度
情報種別が「拠点契約情報」の場合に返却
String No
asNumber 拠点契約情報:AS番号(WAN側)
情報種別が「拠点契約情報」の場合に返却
String No
maximRoute 拠点契約情報:申込み上限経路数
情報種別が「拠点契約情報」の場合に返却
String No
redundancy 拠点契約情報:冗長種別
情報種別が「拠点契約情報」の場合に返却
String No
priorityControlExists 拠点契約情報:優先制御(下り)利用有無(NW)
情報種別が「拠点契約情報」の場合に返却
String No
priorityControlMenu 拠点契約情報:優先制御(下り)メニュー(NW)
情報種別が「拠点契約情報」の場合に返却
String No
internetConnection 拠点契約情報:インターネット接続
情報種別が「拠点契約情報」の場合に返却
String No
contractId 拠点契約アドレス情報:契約ID(N番)
情報種別が「拠点契約アドレス情報」の場合に返却
String No
addressCodeKind 拠点契約アドレス情報:アドレス種別コード
情報種別が「拠点契約アドレス情報」の場合に返却
String No
addressNameKind 拠点契約アドレス情報:アドレス種別名
情報種別が「拠点契約アドレス情報」の場合に返却
String No
address 拠点契約アドレス情報:アドレス値
情報種別が「拠点契約アドレス情報」の場合に返却
String No
mask 拠点契約アドレス情報:アドレスマスク値
情報種別が「拠点契約アドレス情報」の場合に返却
String No
serialNumber 拠点契約アドレス情報:END-END監視アドレス通番
情報種別が「拠点契約アドレス情報」の場合に返却
String No
serialNumber 拠点契約アドレス情報:お客様拠点サマライズ NWアドレス通番v4
情報種別が「拠点契約アドレス情報」の場合に返却
String No
serialNumber 拠点契約アドレス情報:お客様拠点NWアドレス通番v4
情報種別が「拠点契約アドレス情報」の場合に返却
String No
contractId 拠点契約DHCPアドレス情報:契約ID(N番)
情報種別が「拠点契約DHCPアドレス情報」の場合に返却
String No
serialNumber 拠点契約DHCPアドレス情報:契約ID(N番)
情報種別が「拠点契約DHCPアドレス情報」の場合に返却
String No
startAddressRange 拠点契約DHCPアドレス情報:DHCPアドレスレンジ始
情報種別が「拠点契約DHCPアドレス情報」の場合に返却
String No
endAddressRange 拠点契約DHCPアドレス情報:DHCPアドレスレンジ終
情報種別が「拠点契約DHCPアドレス情報」の場合に返却
String No
contractId 拠点契約IPフィルタリングインターネット向け情報:契約ID(N番)
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
priority 拠点契約IPフィルタリングインターネット向け情報:優先順位 v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
senderAddress 拠点契約IPフィルタリングインターネット向け情報:フィルタ送信元情報 IPアドレス v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
senderMask 拠点契約IPフィルタリングインターネット向け情報:フィルタ送信元情報 サブネットマスク v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
senderPortNumber 拠点契約IPフィルタリングインターネット向け情報:フィルタ送信元情報 ポート番号 v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
receiverAddress 拠点契約IPフィルタリングインターネット向け情報:フィルタ宛先情報 IPアドレス v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
receiverMask 拠点契約IPフィルタリングインターネット向け情報:フィルタ宛先情報 サブネットマスク v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
receiverProtocol 拠点契約IPフィルタリングインターネット向け情報:フィルタ宛先情報 プロトコル v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
receiverProtocolNumber 拠点契約IPフィルタリングインターネット向け情報:フィルタ宛先情報 プロトコル番号 v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
receiverPortNumber 拠点契約IPフィルタリングインターネット向け情報:フィルタ宛先情報 ポート番号 v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
action 拠点契約IPフィルタリングインターネット向け情報:アクション v4
情報種別が「拠点契約IPフィルタリングインターネット向け情報」の場合に返却
String No
contractId 拠点契約NAT変換情報:契約ID(N番)
情報種別が「拠点契約NAT変換情報」の場合に返却
String No
serialNumber 拠点契約NAT変換情報:NAT通番
情報種別が「拠点契約NAT変換情報」の場合に返却
String No
beforeAddressConversion 拠点契約NAT変換情報:NAT 変換前NWアドレス
情報種別が「拠点契約NAT変換情報」の場合に返却
String No
afterAddressConversion 拠点契約NAT変換情報:NAT 変換後NWアドレス
情報種別が「拠点契約NAT変換情報」の場合に返却
String No
afterMaskConversion 拠点契約NAT変換情報:NAT 変換後マスク
情報種別が「拠点契約NAT変換情報」の場合に返却
String No
afterMaskConversion 拠点契約NAT変換情報:NAT 変換後マスク
情報種別が「拠点契約NAT変換情報」の場合に返却
String No
contractId 拠点契約ToSビット書き換え情報:契約ID(N番)
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
serialNumber 拠点契約ToSビット書き換え情報:ToSビット書き換え通番 v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
tosBit 拠点契約ToSビット書き換え情報:ToSビット v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
senderAddress 拠点契約ToSビット書き換え情報:ToS書換 送信元情報 IPアドレス v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
senderMask 拠点契約ToSビット書き換え情報:ToS書換 送信元情報 プレフィックス v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
senderPortNumber 拠点契約ToSビット書き換え情報:ToS書換 送信元情報 ポート番号 v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
receiverAddress 拠点契約ToSビット書き換え情報:ToS書換 宛先情報 IPアドレス v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
receiverMask 拠点契約ToSビット書き換え情報:ToS書換 宛先情報 プレフィックス v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
receiverProtocol 拠点契約ToSビット書き換え情報:ToS書換 宛先情報 プロトコル v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
receiverProtocolNumber 拠点契約ToSビット書き換え情報:ToS書換 宛先情報 プロトコル番号 v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
receiverPortNumber 拠点契約ToSビット書き換え情報:ToS書換 宛先情報 ポート番号 v4
情報種別が「拠点契約ToSビット書き換え情報」の場合に返却
String No
contractId ASPMSE利用機能情報:契約ID(N番)
情報種別が「ASPMSE利用機能情報」の場合に返却
String No
bgpRouteAdvertisementKind ASPMSE利用機能情報:BGP経路広告種別
情報種別が「ASPMSE利用機能情報」の場合に返却
String No
bgpFilterEgressDefault ASPMSE利用機能情報:BGPフィルタEgress(Default)
情報種別が「ASPMSE利用機能情報」の場合に返却
String No
vlanNumber ASPMSE利用機能情報:ASP側IF VLAN番号
情報種別が「ASPMSE利用機能情報」の場合に返却
String No
contractId ASPMSE利用機能アドレス情報:契約ID(N番)
情報種別が「ASPMSE利用機能アドレス情報」の場合に返却
String No
addressCodeKind ASPMSE利用機能アドレス情報:アドレス種別コード
情報種別が「ASPMSE利用機能アドレス情報」の場合に返却
String No
addressNameKind ASPMSE利用機能アドレス情報:アドレス種別名
情報種別が「ASPMSE利用機能アドレス情報」の場合に返却
String No
address ASPMSE利用機能アドレス情報:アドレス値
情報種別が「ASPMSE利用機能アドレス情報」の場合に返却
String No
mask ASPMSE利用機能アドレス情報:アドレスマスク値
情報種別が「ASPMSE利用機能アドレス情報」の場合に返却
String No
contractId ASPMSE利用機能NATフィルタリング情報:契約ID(N番)
情報種別が「ASPMSE利用機能NATフィルタリング情報」の場合に返却
String No
protocol ASPMSE利用機能NATフィルタリング情報:プロトコル
情報種別が「ASPMSE利用機能NATフィルタリング情報」の場合に返却
String No
serialNumber ASPMSE利用機能NATフィルタリング情報:NATフィルタリング通番
情報種別が「ASPMSE利用機能NATフィルタリング情報」の場合に返却
String No
maximumPort ASPMSE利用機能NATフィルタリング情報:ポート上限Dist
情報種別が「ASPMSE利用機能NATフィルタリング情報」の場合に返却
String No
minimumPort ASPMSE利用機能NATフィルタリング情報:ポート下限Dist
情報種別が「ASPMSE利用機能NATフィルタリング情報」の場合に返却
String No
contractId ASPMSE利用機能NAT端末情報:契約ID(N番)
情報種別が「ASPMSE利用機能NAT端末情報」の場合に返却
String No
serialNumber ASPMSE利用機能NAT端末情報:NAT端末通番
情報種別が「ASPMSE利用機能NAT端末情報」の場合に返却
String No
natConversionAddressAct ASPMSE利用機能NAT端末情報:NAT変換アドレス
情報種別が「ASPMSE利用機能NAT端末情報」の場合に返却
String No
natConversionAddressSby ASPMSE利用機能NAT端末情報:NAT変換アドレス(SBY)
情報種別が「ASPMSE利用機能NAT端末情報」の場合に返却
String No
natAddress ASPMSE利用機能NAT端末情報:NAT端末アドレス
情報種別が「ASPMSE利用機能NAT端末情報」の場合に返却
String No

Example Result

{   
  "ifType": "20",   
  "contractId": "N111288775",   
  "vUnoapiUnoMain": [   
    {   
      "contractId": "N111288775",
      "addressBorrowingPlan": "シンプル",   
      "ipv4PlanFreeExists": "無",    
      "vpnConnectionExists": "無",   
      "internetConnectExists": "無", 
      "internetConnectBand": null   
    }   
  ],    
  "resultCode": "00000000"  
}


* レスポンス形式・項目等はご契約内容によって異なります。
 詳細については別途お問い合わせください。  

トラフィック情報取得

 VPNグループID、契約ID(N番)及びデータ項目(回線使用率/回線情報量)を指定し、JSONもしくはPNGファイル形式にて返却するAPIです。

トラフィック情報取得 

GET /v3/uno/traffic/{vpnGroupId}/{contractId}?dataType={dataType}&from={from}&to={to}&direction={direction}&interval={interval}&format={format}

Request Parameters

Name Description Type Mandatory
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
dataType データ項目を指定
utilization:国内 回線使用率(%)
traffic:国内 回線情報量(bps)
query argument Yes
from 表示開始日時を指定 #1#2 query argument Yes
to 表示終了日時を指定 #1#2 query argument Yes
direction データ送受信経路種別を指定
in:上り[受信]、out:下り[送信]、inout:上り[受信]・下り[送信] (両方)
query argument Yes
interval プロット間隔を指定
realtime:5分 daily:日 
query argument Yes
format 戻り値フォーマットを指定
json:JSON形式、png:PNG形式グラフ画像
query argument Yes

 #1.JSTを指定
 #2.realtimeである時のみ有効

Example Request

Host: api.ntt.com 
GET /v3/uno/traffic/V12345678/N123456789?dataType=utilization&from=201808090000&to=201808202359&direction=in&interval=realtime&format=json 
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
version バージョン String Yes
from 期間 (From)
yyyy-MM-dd HH:mm形式
String No
to 期間 (To)
yyyy-MM-dd HH:mm形式
String No
utilization / traffic 回線使用率/回線情報量の情報
リクエストパラメータのdataField(データ項目)により切り替えて出力
utilization:dataTypeがutilizationの場合を出力
traffic:dataTypeがtrafficの場合を出力
String No
prefecture 都道府県 String No
companyName 事業者名 String No
lineUseRateDayMax 回線使用率日最大 String No
in 受信最大量
リクエストパラメータのdirection(種別)が、in(受信)、inout(受信・送信)の場合のみ出力
String No
out 送信最大量
リクエストパラメータのdirection(種別)が、out(送信)、inout(受信・送信)の場合のみ出力
String No
lineUseRate / trafficVolume トラフィックデータの種別
リクエストパラメータのdataField(データ項目)により切り替えて出力
lineUseRate:dataTypeがutilizationの場合を出力
trafficVolume:dataTypeがtrafficの場合を出力
String No
in 回線使用率(%)/回線情報量(bps)
リクエストパラメータのdirection(種別)が、in(受信)、inout(受信・送信)の場合のみ出力
String No
out 回線使用率(%)/回線情報量(bps)
リクエストパラメータのdirection(種別)が、out(送信)、inout(受信・送信)の場合のみ出力
String No
datetime 対象年月日時
yyyy-MM-dd HH:mm形式
String No
value 回線使用率(%)/回線情報量(bps) String No
requestDateFrom 表示開始日時 (From)
yyyy-MM-ddTHH:mm+0900形式
String Yes
requestDateTo 表示開始日時 (To)
yyyy-MM-ddTHH:mm+0900形式
String Yes

Example Result

{
    "version": "1.00",
    "contractState": {
        "period": {
            "from": "2018-08-31 00:00",
            "to": ""
        }
    },
    "utilization": {
        "prefecture": "神奈川県",
        "companyName": "●●●●",
        "lineUseRateDayMax": {
            "in": "100.0",
            "out": "100.0"
        },
        "lineUseRate": {
            "in": [
            {
                "datetime": "2018-11-01 00:00",
                "value": "0.00466543888888888963"
            },{
                "datetime": "2018-11-02 00:00",
                "value": "0.00938773518518518958"
            },{
                "datetime": "2018-11-03 00:00",
                "value": "0.00471911851851852023"
            }],
            "out": [
            {
                "datetime": "2018-11-01 00:00",
                "value": "0.00544012592592593019"
            },{
                "datetime": "2018-11-02 00:00",
                "value": "0.00545079814814814975"
            },{
                "datetime": "2018-11-03 00:00",
                "value": "5.41481481481481009e-06"
            }]
        }
    },
    "requestDateFrom": "2018-11-01T12:00+0900",
    "requestDateTo": "2018-11-03T13:00+0900"
}

回線アラーム情報取得

  指定されたVPNグループID、契約IDに紐づくArcstrar Universal Oneの回線アラームを取得するAPIです。
  最大過去90日前までのアラーム履歴を取得することができます。

回線アラーム情報取得

GET /v3/uno/circuitalarms/{vpnGroupId}?contractId={contractId}&originalEventTimeFrom={originalEventTimeFrom}&originalEventTimeTo={originalEventTimeTo}&eventTimeFrom={eventTimeFrom}&eventTimeTo={eventTimeTo}&clearanceTimeFrom={clearanceTimeFrom}&clearanceTimeTo={clearanceTimeTo}&lastModificationTimeFrom={lastModificationTimeFrom}&lastModificationTimeTo={lastModificationTimeTo}&top={top}&skip={skip}&maxPageSize={maxPageSize}&orderBy={orderBy}  

Request Parameters

Name Description Type Mandatory
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
query argument No
originalEventTimeFrom アラーム発生開始日時を指定 #1
日時指定例:201901010000
query argument No
originalEventTimeTo アラーム発生終了日時を指定 #1
日時指定例:201912312359
query argument No
eventTimeFrom アラーム重要度更新開始日時を指定 #1
日時指定例:201901010000
query argument No
eventTimeTo アラーム重要度更新終了日時を指定 #1
日時指定例:201912312359
query argument No
clearanceTimeFrom アラーム回復開始日時を指定 #1
日時指定例:201901010000
query argument No
clearanceTimeTo アラーム回復終了日時を指定 #1
日時指定例:201912312359
query argument No
lastModificationTimeFrom レコード更新開始日時を指定 #1
日時指定例:201901010000
query argument No
lastModificationTimeTo レコード更新終了日時を指定 #1
日時指定例:201912312359
query argument No
top 上位出力件数を指定 #2 query argument No
skip 読み飛ばし件数を指定 #2 query argument No
maxPageSize 出力件数を指定 #3 query argument No
orderBy ソート順を指定 #4
例:originalEventTimeFrom desc
query argument No

 #1.JSTを指定
 #2.別途指定がない場合は0を指定したとみなす
 #3.別途指定がない場合は10を指定したとみなす
 #4.alarmIdをソート順とKEYとして指定する場合はidとすること

Example Request

GET /v3/uno/circuitalarms/V12345678?contractId=N123456789&originalEventTimeFrom=201901010000&originalEventTimeTo=201901312359&eventTimeFrom=201901010000&eventTimeTo=201901312359&clearanceTimeFrom=201901010000&clearanceTimeTo=201901312359&lastModificationTimeFrom=201901010000&lastModificationTimeTo=20190131&top=10&skip=1&maxPageSize=1&orderBy=alarmName desc,optionService     
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
contractId サービスの契約ID(N番) String Yes
vpnGroupId VPNグループID String Yes
originalAlarmName 原アラーム名 String Yes
originalEventTime アラーム発生時刻(JST)
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String Yes
alarmDescription アラーム説明 String No
rootCauseDescription 根本原因説明 String No
requestDescription お客様対応依頼内容 String No
plannedOutage 計画工事フラグ
true:計画工事期間内 false:計画工事期間外
Boolean Yes
plannedOutageDescription 計画工事フラグ説明 String Yes
noManageReason 静観(お客様工事)フラグ
true:静観期間内 false:静観期間外
Boolean Yes
noManageReasonDescription 静観(お客様工事)フラグ説明 String Yes
alarmId アラームID Int Yes
clearanceReportFlag 故障回復フラグ
true:故障回復 false:故障発生
Boolean Yes
clearanceReportFlagDescription 故障回復フラグ説明 String Yes
alarmName アラーム名 String Yes
originalSeverity 原アラーム重要度
5:Critical 4:Waring 3:Major 2:Minor 1:Indeterminate 0:Clear
Int Yes
originalSeverityName 原アラーム重要度説明 String Yes
perceivedSeverity アラーム重要度
 5:Critical 4:Waring 3:Major 2:Minor 1:Indeterminate 0:Clear
Int Yes
perceivedSeverityName アラーム重要度説明 String Yes
eventTime アラーム重要度更新時刻(JST)
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String Yes
clearanceTime アラーム回復時刻(JST)
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
lastModificationTime レコード更新時刻(JST)
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String Yes
* オブジェクト内のデータの並び順は不定です。
* 値がない項目は、レスポンスされません。

Example Result

{
    "value": [
    {
        "contractId" : "N123456789",
        "vpnGroupId" : "V12345678",
        "originalAlarmName" : "UNO(L3) eeNMS(WAN_MAIN) Ping_status NG (/) (from:eeNMS)",
        "originalEventTime" : "2019-03-01T18:07:32+0900"
        "alarmDescription" : "There was no ping response from WAN side of UniverasalOne terminal",
        "plannedOutage" : false,
        "plannedOutageDescription" : "計画工事期間外",
        "noManageReason" : false,
        "noManageReasonDescription" : "静観期間外",
        "alarmId" : 10784000,
        "clearanceReportFlag" : false,
        "clearanceReportFlagName" : "故障発生",
        "alarmName" : "UNO(L3) eeNMS(WAN_MAIN) Ping_status NG (/) (from:eeNMS)",
        "originalSeverity" : 5,
        "originalSeverityName" : "Critical",
        "perceivedSeverity" : 5,
        "perceivedSeverityName" : "Critical",
        "eventTime" : "2019-03-02T18:07:32+0900",
        "clearanceTime" : "2019-03-0418:07:32+0900",
        "lastModificationTime" : "2019-03-04T04:00:02+0900"
    }]
}   

ギャランティ工事情報更新一覧取得

  取得対象の工事情報の最終更新日時を指定し、工事情報の更新一覧をJSON形式にて返却します。

ギャランティ工事情報更新一覧取得

GET /v3/uno/maintenance?plan=guarantee&updateTimeFrom={updateTimeFrom}&updateTimeTo={updateTimeTo} 

Request Parameters

Name Description Type Mandatory
plan 工事情報プランを指定
固定値:guarantee
query argument Yes
updateTimeFrom 最終更新日時(from)を指定
日付指定例:20180101
日時指定例:201801010000
query argument Yes
updateTimeTo 最終更新日時(to)を指定
日付指定例:20181231
日時指定例:201812312359
query argument Yes

Example Request

Host: api.ntt.com 
GET /v2/uno/maintenance?plan=guarantee&updateTimeFrom=20180803&updateTimeTo=20180827
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
totalCount 検索結果件数 Int Yes
pageNumber 検索結果ページの番号 Int No
pageSize 検索結果1ページ当たりの総表示件数 Int No
prePageNumber 検索結果ページの1ページ前のページ番号 Int No
nextPageNumber 検索結果ページの1ページ次のページ番号 Int No
firstPageNumber 検索結果ページの1ページ最初のページ番号 Int No
lastPageNumber 検索結果ページの1ページ最後のページ番号 Int No
lineContractId 契約ID(N番) String No
agmUuid 借用回線UUID String No
lastModifiedAc 最終更新日時
yyyy-MM-ddTHH:mm:ss.SSS+0900形式(JST時間)
String No
* 検索結果ページの件数が2以上であった場合は、該当データを全て取得できていない可能性があるため
 条件を絞り込み再度APIを実行してください。

Example Result

{
    "totalCount": 3,
    "pageNumber": "1",
    "pageSize": "1000",
    "prePageNumber": "1",
    "nextPageNumber": "1",
    "firstPageNumber": "1",
    "lastPageNumber": "1",
    "items": [
    {
        "lineContractId": "N123456780",
        "amgUuid": "5F123456789012345678901234567890",
        "lastModifiedAc": "2018-01-22T16:34:12.059+0900"
    },{
        "lineContractId": "N123456781",
        "amgUuid": "5F123456789012345678901234567890",
        "lastModifiedAc": "2018-01-22T16:34:12.180+0900"
    },{
        "lineContractId": "N123456782",
        "amgUuid": "5F123456789012345678901234567890",
        "lastModifiedAc": "2018-01-22T16:34:12.633+0900"
    }]
}

ギャランティ工事詳細情報取得

  VPNグループID及び契約ID(N番)を指定し、工事情報をJSON形式にて返却するAPIです。

ギャランティ工事詳細情報取得

GET /v3/uno/maintenance/{vpnGroupId}/{contractId}?plan=guarantee&agmUuid={agmUuid}

Request Parameters

Name Description Type Mandatory
vpnGroupId VPN番号を指定
VPN番号:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
plan 工事情報プランを指定
固定値:guarantee
query argument Yes
agmUuid 借用回線UUIDを指定 query argument No

Example Request

Host: api.ntt.com 
GET /v3/uno/maintenance/V1245678/N123456789?plan=guarantee&agmUuid=x23fd9dae90adbewefdwe482000000000000001 
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
totalCount 検索結果件数 Int Yes
pageNumber 検索結果ページの番号 Int No
pageSize 検索結果1ページ当たりの総表示件数 Int No
prePageNumber 検索結果ページの1ページ前のページ番号 Int No
nextPageNumber 検索結果ページの1ページ次のページ番号 Int No
firstPageNumber 検索結果ページの1ページ最初のページ番号 Int No
lastPageNumber 検索結果ページの1ページ最後のページ番号 Int No
lastModifiedAc 最終更新日時
yyyy-MM-ddTHH:mm:ss.SSS+0900形式(JST時間)
String No
agmUuid 借用回線UUID String No
agmMngNo 借用管理番号 String No
circuitId 回線ID String No
atmOnlyCircuitId ATM契約専用回線ID String No
lineContractId 契約ID(N番) String No
lineDescription 回線種別 String No
correspondGroupId グループ番号 String No
serviceName サービス種別 String No
contractSpeed 回線速度 String No
upOfficeName お客様事業所名(上位) String No
lowOfficeName お客様事業所名(下位) String No
tocWorkerDivision TOC担当部署 String No
tocWorkerTel TOC担当TEL String No
startDay 開始年月日-時間
yyyy-MM-ddTHH:mm:ss.SSS+0900形式(JST時間)
String No
endDay 終了年月日-時間
yyyy-MM-ddTHH:mm:ss.SSS+0900形式(JST時間)
String No
startDay2 開始年月日-時間②
yyyy-MM-ddTHH:mm:ss.SSS+0900形式(JST時間)
String No
endDay2 終了年月日-時間②
yyyy-MM-ddTHH:mm:ss.SSS+0900形式(JST時間)
String No
way 工事方法 String No
impactTime 影響時間 Int No
timeUnit 影響時間の単位 String No
count 影響回数 Int No
aopImportance AOP重要度 String No
customerImpact お客様への影響 String No
circuitContactMatter お客様連絡事項【回線単位】 String No
customerConstReason お客様工事理由 String No
customerContactMatter お客様連絡事項【借用単位】 String No
* レスポンス形式・項目等はご契約内容によって異なります。
 詳細については別途お問い合わせください。  

Example Result

{   
    "totalCount": "1",  
    "pageNumber": "1",  
    "pageSize": "10",   
    "prePageNumber": "1",   
    "nextPageNumber": "1",  
    "firstPageNumber": "1", 
    "lastPageNumber": "1",  
    "items": [  
    {   
       "lastModifiedAc": "2019-03-19T13:30:32.536+0900",
       "agmMngNo": "C00167-0",
       "agmUuid": "7A35EC89AAF56013E053E40112AC644A",
       "lineContractId": "N123456789",
       "aopImportance": "2",
       "circuitId": "N180123456",
       "atmOnlyCircuitId": "999999999",
       "lineDescription": "1",
       "correspondGroupId": "V12345678",
       "serviceName": "Universal One",
       "contractSpeed": "100",
       "upOfficeName": "○×会社",
       "lowOfficeName": "○×■会社",
       "tocWorkerDivision": "TOC担当部署",
       "tocWorkerTel": "0312345678",
       "startDay": "2018-11-20T02:00:00.000+0900",
       "endDay": "2018-11-20T05:00:00.000+0900",
       "way": "2",
       "impactTime": "1",
       "timeUnit": "0",
       "count": "1",
       "circuitContactMatter": "〇〇〇",
       "customerConstReason": "計画停電のため",
       "customerContactMatter": "×××"
    }]    
}   

ベストエフォート工事情報取得

  指定されたVPNグループID、契約ID(N番)、エリアコード及び商品コードに紐づく工事情報をJSON形式にて返却するAPIです。

ベストエフォート工事情報取得

GET /v3/uno/maintenance?plan=besteffort&vpnGroupId={vpnGroupId}&contractid={contractid}&areacode={areacode}&goodscode={goodscode} 

Request Parameters

Name Description Type Mandatory
plan 工事情報プランを指定
固定値:besteffort
query argument Yes
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
query argument Yes #1#2
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
query argument Yes #1#2
areaCode エリアコードを指定
エリアコード:3桁の数字
query argument Yes #1
goodsCode 商品コードを指定
固定値:vpn-besteffort
query argument No

 #1.VPNグループIDと契約ID(N番)、もしくはエリアコードのみ指定可能とし、
    VPNグループID、契約ID(N番)とエリアコードの3つを指定した場合はエラーとなる。

 #2.VPNグループID、契約ID(N番)は2つ指定しない場合はエラーとなる。

     

エリアコード

地域コード 都道府県コード
301:北海道 401:北海道
302:東北 402:青森 , 403:岩手 , 404:宮城 , 405:秋田 , 406:山形 , 407:福島
303:関東 408:東京 , 409:神奈川 , 410:埼玉 , 411:千葉 , 412茨城 , 413:栃木 , 414:群馬
304:東海 421:愛知 , 422:岐阜 , 423:静岡 , 424:三重
305:甲信越 415:山梨 , 416:新潟 , 417:長野
306:北陸 418:富山 , 419:石川 , 420:福井
307:近畿 425:大阪 , 426:兵庫 , 427:京都 , 428:滋賀 , 429:奈良 , 430:和歌山
308:中国 431:鳥取 , 432:島根 , 433:岡山 , 434:広島 , 435:山口
309:四国 436:徳島 , 437:香川 , 438:愛媛 , 439:高知
310:九州 440:福岡 , 441:佐賀 , 442:長崎 , 443:熊本 , 444:大分 , 445:宮崎 , 446:鹿児島 , 447:沖縄

Example Request

Host: api.ntt.com 
GET /v3/uno/maintenance?plan=besteffort&vpnGroupId=V12345678&contractId=N123456789&areaCode=408&goodsCode=vpn-besteffort     
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
title 工事・故障タイトル String No
kind 工事・故障種別
1:工事 2:故障
Int No
kindDescription 工事・故障種別名 String No
code 工事・故障ID String No
displayUpdateDate 表示用更新年月日(JST)
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
displayUpdateDateUtc 表示用更新年月日(UTC)
yyyy-MM-ddTHH:mmZ形式(UTC時間)
String No
maintenanceStatus 工事ステータス
1:工事前 2:工事中 3:完了
Int No
maintenanceStatusDescription 工事ステータス名 String No
troubleStatus 故障ステータス
1:故障中 2:復旧済み
Int No
troubleStatusDescription 故障ステータス名 String No
importantFlg 重要フラグ
0:通常(故障の場合0固定) 1:重要
Int No
importantDescription 重要名 String No
maintenanceStartDate 工事開始日時
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
maintenanceEndDate 工事終了日時
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
troubleOccuredDate 発生日時
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
troubleRestoreDate 復旧日時
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
maintenanceStartDateUtc 工事開始日時(UTC)
yyyy-MM-ddTHH:mmZ形式(UTC時間)
String No
maintenanceEndDateUtc 工事終了日時(UTC)
yyyy-MM-ddTHH:mmZ形式(UTC時間)
String No
troubleOccuredDateUtc 発生日時(UTC)
yyyy-MM-ddTHH:mmZ形式(UTC時間)
String No
troubleRestoreDateUtc 復旧日時(UTC)
yyyy-MM-ddTHH:mmZ形式(UTC時間)
String No
targetArea 工事対象エリアコード String No
mainTextPc PCサイト用本文 String No
influencedPlanDisplay 影響のあるサービス(画面表示用)
工事・故障登録時、実際画面表示される影響のあるサービス
String No
targetFacilityDisplay 影響のある設備(画面表示用)
工事・故障登録時、実際画面表示される影響のある設備
String No
targetAreaDisplay 工事対象エリア(画面表示用)
工事・故障登録時、実際画面表示されるエリア
String No
matchParamType 合致したパラメータ
1:商品コード 2:N番 3:エリアコード
String No

Example Result

{
    "items": [
    {
        "title": "【L3 ベストエフォート】青森県エリア地域IP網メンテナンス工事のお知らせ",
        "kind": 1,
        "kindDescription": "工事",
        "code": "12001",
        "displayUpdateDate":"2018-10-19T15:04+0900",
        "displayUpdateDateUtc":"2018-10-19T06:04Z",
        "maintenanceStatus": 3,
        "maintenanceStatusDescription": "完了",
        "troubleStatus": "",
        "troubleStatusDescription": "",
        "importantFlg": 0,
        "importantDescription": "通常",
        "maintenanceStartDate": "2018-10-26T00:00+0900",
        "maintenanceEndDate": "2018-10-26T06:00+0900",
        "troubleOccuredDate": "",
        "troubleRestoreDate": "",
        "maintenanceStartDateUtc": "2018-10-25T15:00Z",
        "maintenanceEndDateUtc": "2018-10-25T21:00Z",
        "troubleOccuredDateUtc": "",
        "troubleRestoreDateUtc": "",
        "targetArea": "402",
        "mainTextPc": "特定加入者回線部分のアクセスポイントで、工事時間帯において一時的にご利用できなくなる場合がございます。",
        "influencedPlanDisplay": "特定加入者回線部分(光ネクスト)",
        "targetFacilityDisplay": "",
        "targetAreaDisplay": "青森県エリアの全域",
        "matchParamType": 3
    }]
}

回線監視停止情報取得

  指定されたVPNグループID、契約ID、お客様システムID、工事開始日時及び工事終了日時に紐づく回線監視停止情報を返却するAPIです。

回線監視停止情報取得

GET /v2/uno/monitoringsuspension/{customerSysId}/{vpnGroupId}/{contractId}?workDateFrom={workDateFrom}&workDateTo={workDateTo} 

Request Parameters

Name Description Type Mandatory
customerSysId お客様システムID(A番)を指定
A番:A+9ケタの数字
path variable Yes
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
workDateFrom 工事開始日時を指定 #1 #2 #3
日時指定例:201901010000
query argument No
workDateTo 工事終了日時を指定 #1 #3 #4
日時指定例:201912312359
query argument No

 #1.JSTを指定
 #2.別途指定がない場合は現在時刻を指定したとみなす
 #3.秒は「00秒」もしくは「59秒」のみ指定可能
 #4.別途指定がない場合は現在時刻の1年後を指定したとみなす

Example Request

Host: api.ntt.com 
GET /v3/uno/monitoringsuspension/A123456789/V12345678/N123456789?workDateFrom=20190101130000&workDateTo=20191231235959     
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

Name Description Type Mandatory
insertDate 作成年月日時分秒(JST)
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
workId 工事ID Int No
workDiv 工事区分
01:SO Maint(オーダ工事) 02:Com Maint(NTTCom工事) 03:Cust Maint(お客様工事) 04:Testing(回線試験) 05:Urgent Maint(緊急メンテナンス) 99:Others(その他)
Int No
workDivDescription 工事区分名 String No
workTargetId 工事対象ID String No
workTargetDiv 工事対象区分
01:Customer System(お客様システム) 02:Network(バックボーン通信グループ) 03:Site(拠点) 04:Circuit(回線) 05:CPE/LAN Equipments(宅内機器)
Int No
workTargetDivDescription 工事対象区分名 String No
workRepeatDiv 工事繰り返し区分
00:No(繰り返しなし) 10:Every day(毎日) 20:Weekly(毎週) 30:Monthly(毎月) 40:Holiday(祝日) 90:Permanent(恒久)
Int No
workRepeatDivDescription 工事繰り返し区分名 String No
workDateFrom 工事開始日時
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
workDateTo 工事終了日時
yyyy-MM-ddTHH:mm+0900形式(JST時間)
String No
workTimeFrom 工事開始時刻(JST)
HH24:MM:SS形式(JST時間)
String No
workTimeTo 工事終了時刻(JST)
HH24:MM:SS形式(JST時間)
String No
workWeekdayFrom 工事開始曜日コード
01:Sun(日) 02:Mon(月) 03:Tue(火) 04:Wed(水) 05:Thu(木) 06:Fri(金) 07:Sat(土)
Int No
workWeekdayFromName 工事開始曜日コード名 String No
workWeekdayTo 工事終了曜日コード
01:Sun(日) 02:Mon(月) 03:Tue(火) 04:Wed(水) 05:Thu(木) 06:Fri(金) 07:Sat(土)
Int No
workWeekdayToName 工事終了曜日コード名 String No
workDayFrom 工事開始日コード
01~31:1日~31日 98:月末前日 99:月末日
Int No
workDayFromName 工事開始日コード名 String No
workDayTo 工事終了日コード
01~31:1日~31日 98:月末前日 99:月末日
Int No
workDayToName 工事終了日コード名 String No
workHolidayFrom 工事開始祝日コード
01:Yesterday Before Holiday(祝前々日) 02:Before Holiday(祝前日) 03:Holiday(祝日) 04:After Holiday(祝翌日) 05:Tommorow After Holiday(祝翌々日)
Int No
workHolidayFromName 工事開始祝日コード名 String No
workHolidayTo 工事終了祝日コード
01:Yesterday Before Holiday(祝前々日) 02:Before Holiday(祝前日) 03:Holiday(祝日) 04:After Holiday(祝翌日) 05:Tommorow After Holiday(祝翌々日)
Int No
workHolidayToName 工事終了祝日コード名 String No
remarks 備考 String No
receiptNo 受付番号 Int No
parentWorkId 親工事ID Int No
workEndIssue 工事終了時起票有無 
0:アラートのチケットを起票しない 1:アラートのチケットを起票する
Int No
workEndIssueDescription 工事終了時起票有無説明 String No

Example Result

{           
    "hitCount":1,       
    "items":[       
            {   
            "insertDate":"2018-11-10T05:42:00+0900",
            "workId":"0001458914",
            "workDiv":"04",
            "workDivDescription":"Testing(回線試験)",
            "workTargetId":"N160116028",
            "workTargetDiv":"04",
            "workTargetDivDescription":"Circuit(回線)",
            "workRepeatDiv":"20",
            "workRepeatDivDescription":"Weekly(毎週)",
            "workDateFrom":"2018-12-10T05:42:00+0900",
            "workDateTo":"2018-12-10T06:12:00+0900",
            "workTimeFrom":"110000",
            "workTimeTo":"200000",
            "workWeekdayFrom":"06",
            "workWeekdayFromName":"Fri(金)",
            "workWeekdayTo":"01",
            "workWeekdayToName":"SUN(日)",
            "workDayFrom":"",
            "workDayFromName":"",
            "workDayTo":"",
            "workDayToName":"",
            "workHolidayFrom":"",
            "workHolidayFromName":"",
            "workHolidayTo":"",
            "workHolidayToName":"",
            "remarks":"",
            "receiptNo":"",
            "parentWorkId":"",
            "workEndIssue":"0",
            "workEndIssueDescription":"アラートチケットを起票しない"
        }   
    ]       
}           

回線監視停止情報登録

  指定されたVPNグループID、契約ID及びお客様システムIDに紐づく回線監視停止情報を登録するAPIです。

回線監視停止情報登録

POST /v3/uno/monitoringsuspension/{customerSysId}/{vpnGroupId}/{contractId}  

Request Parameters

Name Description Type Mandatory
customerSysId お客様システムID(A番)を指定
A番:A+9ケタの数字
path variable Yes
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
workDiv 工事区分を指定
01:SO Maint(オーダ工事) 02:Com Maint(NTTCom工事) 03:Cust Maint(お客様工事) 04:Testing(回線試験) 05:Urgent Maint(緊急メンテナンス) 99:Others(その他)
JSON Yes
workTargetDiv 工事対象区分を指定
04:Circuit(回線) 05:CPE/LAN Equipments(宅内機器)
JSON Yes
workRepeatDiv 工事繰り返し区分を指定
00:No(繰り返しなし) 10:Every day(毎日) 20:Weekly(毎週) 30:Monthly(毎月) 40:Holiday(祝日) 90:Permanent(恒久)
JSON Yes
workDateFrom 工事期間開始日時を指定 #1#2
例:2019-04-01T10:00:00+0900
JSON No
workDateTo 工事期間終了日時を指定 #1#2
例:2019-04-30T23:59:59+0900
JSON No
workTimeFrom 工事開始時刻を指定 #1#2
例:10:00:00
JSON No
workTimeTo 工事終了時刻を指定 #1#2
例:23:59:59
JSON No
workWeekdayFrom 工事開始曜日コードを指定 #1
01:Sun(日) 02:Mon(月) 03:Tue(火) 04:Wed(水) 05:Thu(木) 06:Fri(金) 07:Sat(土)
JSON No
workWeekdayTo 工事終了曜日コードを指定 #1
01:Sun(日) 02:Mon(月) 03:Tue(火) 04:Wed(水) 05:Thu(木) 06:Fri(金) 07:Sat(土)
JSON No
workDayFrom 工事開始日コードを指定 #1
01~31:1日~31日 99:月末日
JSON No
workDayTo 工事終了日コードを指定 #1
01~31:1日~31日 99:月末日
JSON No
workHolidayFrom 工事開始祝日コードを指定 #1
02:Before Holiday(祝前日) 03:Holiday(祝日) 04:After Holiday(祝翌日) 05:Tommorow After Holiday(祝翌々日)
JSON No
workHolidayTo 工事終了祝日コードを指定 #1
02:Before Holiday(祝前日) 03:Holiday(祝日) 04:After Holiday(祝翌日) 05:Tommorow After Holiday(祝翌々日)
JSON No
remarks 備考を指定
例:計画停電を予定
JSON No
workEndIssue 工事終了時起票有無を指定
0:アラートのチケットを起票しない 1:アラートのチケットを起票する
JSON Yes

 #1.JSTを指定
 #2.秒は「00秒」もしくは「59秒」のみ指定可能

Example Request

Content-Type: application/json; charset=utf-8
Host: api.ntt.com
POST /v3/uno/monitoringsuspension/A123456789/V12345678/N123456789     
{
  "workDiv":"01",
  "workTargetDiv":"04",
  "workRepeatDiv":"10",
  "workDateFrom":"2019-04-01T10:00:00+0900",
  "workDateTo":"2019-12-31T23:59:59+0900",
  "workTimeFrom":"100000",
  "workTimeTo":"235959",
  "remarks":"計画停電を予定",
  "workEndIssue":1
}
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

なし ※HTTPヘッダーのみ返却されます。

Example Result

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 0
Date: Sun, 1 Sep 2019 09:00:00 GMT

回線監視停止情報更新

  指定されたVPNグループID、契約ID及びお客様システムIDに紐づく回線監視停止情報を更新するAPIです。

回線監視停止情報更新

PUT /v3/uno/monitoringsuspension/{customerSysId}/{vpnGroupId}/{contractId}  

Request Parameters

Name Description Type Mandatory
customerSysId お客様システムID(A番)を指定
A番:A+9ケタの数字
path variable Yes
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
insertDate 作成年月日時分秒を指定 #1
例:2019-01-01T00:00:00+0900
JSON Yes
workId 工事IDを指定
例:0001234567
JSON Yes
workDateFrom 工事期間開始日時を指定 #1#2
例:2019-04-30T23:59:59+0900
JSON No
workDateTo 工事期間終了日時を指定 #1#2
例:2019-04-30T23:59:59+0900
JSON No
remarks 備考を指定
例:計画停電を予定
JSON No
workEndIssue 工事終了時起票有無を指定
0:アラートのチケットを起票しない 1:アラートのチケットを起票する
JSON Yes

 #1.JSTを指定
 #2.秒は「00秒」もしくは「59秒」のみ指定可能

Example Request

Content-Type: application/json; charset=utf-8
Host: api.ntt.com
PUT /v3/uno/monitoringsuspension/A123456789/V12345678/N123456789     
{
  "insertDate":"2019-01-01T00:00:00+0900",
  "workId":"0001234567",
  "workDateFrom":"2019-04-01T10:00:00+0900",
  "workDateTo":"2019-12-31T23:00:00+0900",
  "remarks":"計画停電を予定",
  "workEndIssue":"1"
}
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

なし ※HTTPヘッダーのみ返却されます。

Example Result

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 0
Date: Sun, 1 Sep 2019 09:00:00 GMT

回線監視停止情報削除

  指定されたVPNグループID、契約ID及びお客様システムIDに紐づく回線監視停止情報を削除するAPIです。

回線監視停止情報削除

DELETE /v3/uno/monitoringsuspension/{customerSysId}/{vpnGroupId}/{contractId}  

Request Parameters

Name Description Type Mandatory
customerSysId お客様システムID(A番)を指定
A番:A+9ケタの数字
path variable Yes
vpnGroupId VPNグループIDを指定
VPNグループID:'V'+8桁の数字
path variable Yes
contractId サービスの契約ID(N番)を指定
N番:'N'+9桁の数字
path variable Yes
insertDate 作成年月日時分秒を指定 #1
例:2019-01-01T00:00:00+0900
JSON Yes
workId 工事IDを指定
例:0001234567
JSON Yes

 #1.JSTを指定

Example Request

Content-Type: application/json; charset=utf-8
Host: api.ntt.com
DELETE /v2/uno/monitoringsuspension/A123456789/V12345678/N123456789     
{
  "insertDate":"2019-01-01T00:00:00+0900",
  "workId":"0001234567"
}
HEADER Authorization: Bearer [YOUR_ACCESS_TOKEN]*
* トークンの取得についてはOAuth APIのページをご参照ください。

Response Parameters

なし ※HTTPヘッダーのみ返却されます。

Example Result

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 0
Date: Sun, 1 Sep 2019 09:00:00 GMT

-以上-


  1. 2014/12現在、DNSラウンドロビン運用。準備出来次第、お客さまの地理的に近いAPIゲートウェイに自動接続予定です。別途アナウンスします。