UpdateIncidentAssign
「UOMポータル」の「チケット管理」と同様に、現在のインシデント情報の担当者の割り当てを更新できます。
| HTTPメソッド | Action | 名称 |
|---|---|---|
| POST | UpdateIncidentAssign | インシデント担当者割当更新 |
1： リクエストパラメータ
| パラメータ | タイプ | 必須 | 意味 | 最大文字数 | リクエスト例 | 備考 | ||
|---|---|---|---|---|---|---|---|---|
| OfficeId | String | ○ | 事業者コード | 11 | IIJ00000001 | 固定 | ||
| ServiceCode | String | ○ | サービスコード | 15 | uom12345678 | ご契約のサービスコードを指定してください | ||
| MasterId | String | ○ | 申請者マスターID | 15 | SA9876543 | マスターIDを指定してください | ||
| IncidentId | String[] | ○ | チケット番号 | 15 | UTM123456 | 担当者を割り当てるチケット番号を指定してください | ||
| AssignUserId | String | ○ | 担当者ID | 15 | SA1234567 | チケットに割り当てる担当者のマスターIDを指定してください | ||
| AssignUserName | String | ○ | 担当者氏名 | 50 | IIJ太郎 | 割り当てられた担当者の氏名を指定してください | ||
| RelateIncidentUpdateFlg | String | ○ | 関連チケット更新フラグ | 1 | 1 | 関連付けされたチケットの担当者の変更有無を指定してください
| ||
| Locale | String | ○ | 表示言語 | 1 | 0 | 下記のみ利用可能です 0：日本語 | ||
2： レスポンス
正常終了
| フィールド | タイプ | 意味 | 備考 | |||||
|---|---|---|---|---|---|---|---|---|
| StatusCode | String | ステータスコード | 成功時200が返却されます | |||||
| Result | − | 結果 | ||||||
| RequestId | String | リクエストID | APIリクエストごとに割り当てられる一意なIDです | |||||
| IncidentIdSuccessList | Array | チケット番号成功リスト | ||||||
| IncidentId | String | チケット番号 | 更新が成功したチケット番号です | |||||
| IncidentIdFailureList | Array | チケット番号失敗リスト | ||||||
| IncidentId | String | チケット番号 | 更新が失敗したチケット番号です | |||||
異常終了
| フィールド | タイプ | 意味 | 備考 | |
|---|---|---|---|---|
| Result | − | 結果 | ||
| RequestId | String | リクエストID | APIリクエストごとに割り当てられる一意なIDです | |
| ErrorType | String | エラータイプ | 異常終了となったエラータイプです | |
| ErrorMessage | String | エラーメッセージ | 異常終了となったエラーメッセージです | |
3： エラーメッセージ
| エラー | HTTP Status Code | ErrorType | ErrorMessage | 説明 |
|---|---|---|---|---|
| パラメータエラー | 200 | UOMParameterError | UOM parameter error occurred. | 指定されたパラメータが誤っています
など |
| 例外エラー | 200 | UOMExceptionError | UOM system exception error occurred. | UOM-API設備のシステム障害 |
- 共通エラーについて詳しくは、「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 = "UpdateIncidentAssign"
PARAMS = '{
"OfficeId" : "IIJ00000001",
"ServiceCode" : "uom12345678",
"MasterId" : "SA9876543",
"IncidentId" : ["UTM123456","UTM123457","UTM123458"],
"AssignUserId" : "SA1234567",
"AssignUserName" : "IIJ太郎"
"RelateIncidentUpdateFlg" : "1",
"Locale" : "0"
}'
レスポンス（XML）
本APIでは、XMLでのリクエストを許可していません。
レスポンス（JSON）
正常終了
{
"UpdateIncidentAssignResponse":{
"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."
}
}