公開
マニュアル一覧へ

ご契約者向け
マニュアル一覧へ

IIJ統合運用管理サービス API Reference

UpdateIncidentState

「UOMポータル」の「チケット管理」と同様に、現在のインシデント情報のステータスを変更できます。

HTTPメソッドAction名称
POSTUpdateIncidentStateインシデントステータス更新
1： リクエストパラメータ
パラメータタイプ必須意味最大文字数リクエスト例備考
OfficeIdString○事業者コード11IIJ00000001固定
ServiceCodeString○サービスコード15uom12345678ご契約のサービスコードを指定してください
MasterIdString○申請者マスターID15SA9876543マスターIDを指定してください
IncidentIdString[]○チケット番号15UTM123456担当者を割り当てるチケット番号を指定してください
StateCodeString○ステータスコード3000

変更後のステータスを指定してください

  • 000：未対応
  • 100：対応中
  • 200：クローズ
RelateIncidentUpdateFlgString○関連チケット更新フラグ11

関連付けされたチケットのステータスの変更有無を指定してください

  • 1：変更する
  • 0：変更しない
LocaleString○表示言語10

下記のみ利用可能です

0：日本語

2： レスポンス
正常終了
フィールドタイプ意味備考
StatusCodeStringステータスコード成功時200が返却されます
Result
−結果
RequestIdStringリクエストIDAPIリクエストごとに割り当てられる一意なIDです
IncidentIdSuccessList
Arrayチケット番号成功リスト
IncidentIdStringチケット番号更新が成功したチケット番号です
IncidentIdFailureList
Arrayチケット番号失敗リスト
IncidentIdStringチケット番号更新が失敗したチケット番号です

異常終了
フィールドタイプ意味備考
Result
−結果
RequestIdStringリクエストIDAPIリクエストごとに割り当てられる一意なIDです
ErrorTypeStringエラータイプ異常終了となったエラータイプです
ErrorMessageStringエラーメッセージ異常終了となったエラーメッセージです

3： エラーメッセージ
エラーHTTP Status CodeErrorTypeErrorMessage説明
パラメータエラー200UOMParameterErrorUOM parameter error occurred.

指定されたパラメータが誤っています

  • 最大文字数を超過している
  • 指定する形式が誤っている
  • 必須パラメータが指定されていない

など

例外エラー200UOMExceptionErrorUOM system exception error occurred.UOM-API設備のシステム障害
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 = "20161003"

# Content-Type の設定
CONTENTTYPEVALUE = "application/json; charset=utf-8"

# インシデントステータス更新
# 以下の内容は、適宜修正してください。
ACTION = "UpdateIncidentState"
PARAMS = '{
	"OfficeId" : "IIJ00000001",
	"ServiceCode" : "uom12345678",
	"MasterId" : "SA9876543",
	"IncidentId" : ["UTM123456","UTM123457","UTM123458"],
	"StateCode" : "000",
	"RelateIncidentUpdateFlg" : "1",
	"Locale" : "0"
}'
レスポンス（XML）

本APIでは、XMLでのリクエストを許可していません。

レスポンス（JSON）
正常終了
{
	"UpdateIncidentStateResponse":{
		"RequestId":"xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
		"IncidentIdSuccessList":[
			{"IncidentId":"UTM123456"}
		],
		"IncidentIdFailureList":[
			{"IncidentId":"UTM654321"}
		]
	}
}
異常終了
{
	"ErrorResponse":{
		"RequestId":" xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
		"ErrorType":"UOMWebSystemError",
		"ErrorMessage":"UOM Web System error occurred."
	}
}