ChangeMonitoringTargetIPAddressSegmentApplication
「UOMポータル」の「サービス設定」から「監視ネットワーク設定」 を実施するのと同様に、設定を行えます。
GetMonitoringTargetIPAddressSegmentInfo(監視ネットワーク設定設定内容取得)で取得した結果をもとに、変更したいレコード、または新規レコードを設定します。
なお、変更の場合は、変更の必要がないカラム(ApplicationList)もリクエストパラメータに指定してください。
| HTTPメソッド | Action | 名称 |
|---|---|---|
| POST | ChangeMonitoringTargetIPAddressSegmentApplication | 監視ネットワーク設定設定更新 |
1: リクエストパラメータ
| パラメータ | タイプ | 必須 | 意味 | 最大文字数 | リクエスト例 | 備考 | |
|---|---|---|---|---|---|---|---|
| ServiceCode | String | ○ | サービスコード | 15 | uom12345678 | ご契約のサービスコードを指定してください | |
| Application MailAdress Add | String | ○ | 設定時メール送付先 | 500 | iij-taro@example.jp | 登録済みの「お問い合わせ連絡先グループ」以外に設定時のメールを送付したい場合は、「設定時メール送付先」にアドレスを入力します | |
| MasterId | String | ○ | 設定者マスターID | 15 | SA9876543 | マスターIDを指定してください | |
| Locale | int | ○ | 表示言語 | 1 | 0 | 下記のみ利用可能です 0:日本語 | |
| Application List | Array | ○ | 設定リスト | − | − | 設定情報を格納したリストです | |
| Update Type | int | ○ | 設定タイプ | 1 | 0 | 以下から指定してください
※ 選択がない場合は設定更新対象になりません | |
| IpSegment MasterId | int | ○ | 監視ネットワークマスタID | 9 | 123 | 設定レコードごとに割り当てられたマスタIDを指定してください。新規の受理待ち、受理の場合は指定不要です | |
| IpSegment | String | ○ | 監視ネットワーク | 64 | 192.0.2.128 | IPv4、またはIPv6アドレスを指定してください ※ IPv4では第4オクテットが、"0"、"255"は指定できません | |
| Subnet Mask | String | ○ | サブネットマスク | 2 | 26 | 24~64の範囲で指定してください ※ IPv4では24~32までです | |
| Notes | String | ○ | 補足 | 1000 | memo | 補足事項があれば入力してください | |
2: レスポンス
正常終了
| フィールド | タイプ | 意味 | 備考 | |
|---|---|---|---|---|
| StatusCode | String | ステータスコード | 成功時 200が返却されます | |
| Result | − | 結果 | ||
| RequestId | String | リクエストID | APIリクエストごとに割り当てられる一意なIDです | |
| ResultCode | String | 結果コード | 以下が返却されます
| |
| ReceptionNumber | String | 受付番号 | 設定を受け付けた番号が返却されます (例)KUOM1303-0828 | |
異常終了
| フィールド | タイプ | 意味 | 備考 | |
|---|---|---|---|---|
| Result | − | 結果 | ||
| RequestId | String | リクエストID | APIリクエストごとに割り当てられる一意なIDです | |
| ErrorType | String | エラータイプ | 異常終了となったエラータイプです | |
| ErrorMessage | String | エラーメッセージ | 異常終了となったエラーメッセージです | |
3: エラーメッセージ
| エラー | HTTP Status Code | ErrorType | ErrorMessage | 説明 | 備考 |
|---|---|---|---|---|---|
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Input 500 characters or less in ApplicationMailAdressAdd field. | 設定時メール送付先の最大文字数超過 | APPLICATION_EMAIL_CHARACTER_OVER |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Enter the Email Address in the proper email address format. | 設定時メール送付先のメールアドレス形式が不正 | NOT_EMAIL_ADDRESS_FORMAT |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. IpSegmentMasterId is a required. | 監視ネットワークマスタIDが不正 | KANSHI_MASTER_ID_REQUIRED_FIELD |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. IpSegment is a required. | 監視ネットワーク情報が不正 | IP_SEGMENT_REQUIRED_FIELD |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Input 128 characters or less in IpSegment. | 監視ネットワーク最大文字数超過 | IP_SEGMENT_CHARACTER_OVER |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Specify IpSegment in IPv4 or IPv6 format. | 監視ネットワーク入力形式不正 | IP_ADDRESS_WRONG_FORMAT_KANSHI |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. You have specified a network address or a broadcast address in IpSegment. | 監視ネットワークアドレス不正 | IP_ADDRESS_TYPE_NG |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. The ranges specified by IpSegment and SubnetMask are overlapping. | 監視ネットワーク入力値重複 | IP_ADDRESS_OVER_LAPPING |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. The IpSegment has already been registered. Specify the correct IpSegment which has no duplicate. | 監視ネットワーク重複 | IP_ADDRESS_ALREADY_REGISTED_KANSHI |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. You cannot submit the application since it is not the private segment specified by us. Specify a IpSegment that can be entered. | プライベートIPアドレスセグメント指定不可アドレス | PRIVATE_IP_ADDRESS_NOT_ENTERED |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. SubnetMask is a required. | サブネットマスク不正 | SUBNET_MASK_REQUIRED_FIELD |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Select a value of 32 or less in SubnetMask if IpSegment is in IPv4 format, or select a value of 64 or less if it is in IPv6 format. | サブネットマスク指定不正 | IP_ADDRESS_SEGMENT_NG |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Input 1000 characters or less in Notes field. | 最大文字数超過 | NOTES_CHARACTER_OVER |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. ServiceCode is a required. | サービスコードが不正 | SERVICE_CODE_REQUIRED_FIELD |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. MasterID is a required. | マスターIDが不正 | MASTER_ID_REQUIRED_FIELD |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. There is no MasterID. | マスターIDが登録されていない | MASTER_ID_NONE |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. There is no UOM contract. | UOMの契約が存在しない | UOM_CONTRACT_NONE |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. There is no monitoring contract. | UOMの監視契約が存在しない | MONITORING_CONTRACT_NONE |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. UpdateType is a required. | 設定タイプ不正 | UPDATE_TYPE_REQUIRED_FIELD |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. UpdateType must be Update, Delete, or Nochange. | 設定タイプ指定数値不正 | UPDATE_TYPE_WRONG_FORMAT |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. The records are old. Update to the latest records. | 設定更新対象レコードが削除・受理・受理待ちのため更新不可 | APPLICATION_REGISTER_CHECK |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Input 100 items or less for updating and deleting. | 1度に100件を超える設定は不可 | APPLICATION_MORE_UPDATABLE |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. There is no change you can apply. | 設定更新可能なレコード変更がない | NO_ITEM_IS_READY |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. The Details have not been updated. | 設定更新対象のレコードがない | DETAILS_NOT_UPDATE |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. You cannot submit the application since there is no Monitoring Target IP Address Segment. | 監視ネットワークの全レコード削除 | SINCE_NO_IP_SEGMENT |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Specified parameters there is a problem, you can not apply. | 設定内容不正により申請不可 | APPLICATION_PARAMETER_ERROR |
| パラメータエラー | 200 | UOM Parameter Error | UOM parameter error occurred. Application is denied, because apply IpSegment is disabled. Apply IpSegment which is available. | 利用可能なネットワーク以外が指定されている | APPLICATION_SEGMENT_DISABLED |
| 例外エラー | 200 | UOM Exception Error | UOM system exception error occurred. | UOM-API設備のシステム障害 | SYSTEM_EXCEPTION_ERROR |
| Webシステムエラー | 200 | UOM WebSystem Error | UOM Web System error occurred. | その他のシステム障害 |
4:警告メッセージ
なし
5:制限
なし
6:サンプル(REST形式)
config.rb
##
## 個別設定
##
# API のキー設定
IIJAPI_ACCESS_KEY = "1234567890ABCDEFGHIJ"
IIJAPI_SECRET_KEY = "1234567890ABCDEFGHIJabcdefghijklmnopqr+1"
##
## API の基本設定
##
# API の ENDPOINT 設定
IIJAPI_ENDPOINT = https://uom.api.iij.jp
IIJAPI_SSL_NO_VERIFY = true
# API バージョンの設定
APIVERSION = "20150912"
# Content-Type の設定
CONTENTTYPEVALUE = "application/json; charset=utf-8"
# 監視ネットワーク設定設定更新
# 以下の内容は、適宜修正してください。
ACTION = "ChangeMonitoringTargetIPAddressSegmentApplication"
PARAMS = '{
"ServiceCode" : "uom12345678",
"MasterId" : "SA9876543",
"ApplicationMailAdressAdd" : "iij-taro@example.jp",
"Locale" : "0",
"ApplicationList" : [
{ "UpdateType" : "1",
"IpSegmentMasterId" : "40001",
"IpSegment" : "192.0.2.128",
"SubnetMask" : "26",
"Notes" : "memo" },
{ "UpdateType" : "3",
"IpSegmentMasterId" : "40002",
"IpSegment" : "192.0.2.32",
"SubnetMask" : "28",
"Notes" : "memo" }
]
}'
レスポンス(XML)
正常終了 <?xml version="1.0" encoding="UTF-8"?> <methodResponse xmlns:ex="http://ws.apache.org/xmlrpc/namespaces/extensions"> <params> <param> <value> <struct> <member> <name>StatusCode</name> <value>200</value> </member> <member> <name>Result</name> <value> <struct> <member> <name>RequestId</name> <value>xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx</value> </member> <member> <name>ReceptionNumber</name> <value>KUOM1303-0828</value> </member> <member> <name>ResultCode</name> <value>0</value> </member> </struct> </value> </member> </struct> </value> </param> </params> </methodResponse> 異常終了 <?xml version="1.0" encoding="UTF-8"?> <methodResponse xmlns:ex="http://ws.apache.org/xmlrpc/namespaces/extensions"> <params> <param> <value> <struct> <member> <name>StatusCode</name> <value>400</value> </member> <member> <name>RequestId</name> <value>xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx</value> </member> <member> <name>ErrorType</name> <value>UOMParameterError</value> </member> <member> <name>ErrorMessage</name> <value>UOM parameter error occurred.Specified parameters there is a problem, you can not apply.</value> </member> </struct> </value> </param> </params> </methodResponse>
レスポンス(JSON)
正常終了
{
"ChangeMonitoringTargetIPAddressSegmentApplicationResponse": {
"StatusCode":"200",
"Result":{
"RequestId":"xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
"ReceptionNumber":"KUOM1303-0828",
"ResultCode":"0"
}
}
}
異常終了
{
"ErrorResponse": {
"Result":{
"RequestId":"xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
"ErrorType":"UOMParameterError",
"ErrorMessage":"UOM parameter error occurred.Specified parameters there is a problem, you can not apply."
}
}
}