ビジネス オブジェクトを更新する
変更、問題、インシデントなどのビジネス オブジェクトの詳細を更新できます。
ベース URL:
https://{tenant url}/api/odata/businessobject/{business object name}('{business object unique key}')
ビジネス オブジェクト名の末尾に「s」が付いていることを確認します。
以下は、一意の ID によって変更を更新する例です。
メールアドレス | https://{tenant url}/api/odata/businessobject/changes('02818A8426C9402E8DFE7C8D3132F783') |
|---|---|
方法 | 配置/パッチ PUT と PATCH メソッドは、異なる処理を実行しているにもかかわらず、同じ要求ペイロードを持ちます。 |
ヘッダー名 | 認証: JTW トークン/セッション キー/REST API キー |
ステータスコード | 200 |
レスポンスペイロード | { "@odata.context": "https://tatnet.ivanti.com/api/odata/change/$metadata#changes/$entity", "AcceptanceDueDate": "0001-01-01T00:00:00Z", "AcceptTimeout": "0001-01-01T00:00:00Z", "BackoutPlanAttached": false, "BallotCount": null, "BusinessFunction_Valid": "", "BusinessFunction": "", "Category_Valid": "E0234286776B43C39231635C7066F369", 「カテゴリ」:「ソフトウェア」、 "ChangeNumber": 10173, "ClosedBy": null, "ClosedCode_Valid": "", "ClosedCode": "", "ClosedDateTime": "0001-01-01T00:00:00Z", "CompletedBy": "", "CreatedBy": "Admin", "CreatedByRecID": "FB884D18F7B746A0992880F2DFFE749C", "CreatedDateTime": "2011-10-09T01:30:36+05:30", "DirectCost": 0, "Emergency": false, "EstimatedCost": 0, "ExternalCalendarLinkID": "", "ExternalTaskLinkID": "", "FinalState": "False", "Impact_Valid": "1AFFC174C7EA4AB79CCA6B15EB67006D", 「影響」:「中」、 "最終更新者": "RMatthews", "LastModDateTime": "2011-11-24T01:30:36 05:30", "Owner_Valid": "8C50BA8C88D04AFE8288F9931DCA7CE8", 「オーナー」: 「JSmith」、 "OwnerTeam_Valid": "2E4BABD54FB9420D94F836F0D9B80C47", "オーナーチーム": "サービスデスク", "OwnerType": "Profile.Employee", "ParentLink_Category": "", "ParentLink_RecID": "", 「親リンク」: null、 「優先度」: 「3」、 "理由有効": "", "理由": ""、 "RecId": "008E3506AF3F4CC190BC95523645D968", "リクエスト者": "ポール・H・チャン", "RequestorLink_Category": "Employee", "RequestorLink_RecID": "8A6EADA5906F4F4BBCC8F47CC126F374", "リクエストリンク": "8A6EADA5906F4F4BBCC8F47CC126F374", "予定終了日": "2011-12-04T01:30:36 05:30", "スケジュール開始日": "2011-11-29T01:30:36 05:30", "Service_Valid": null, "サービス": ""、 "Status_Valid": "F93826F7E4394B1E8C8A6CA2C3F07ED3", 「ステータス」:「承認待ち」、 「件名」: 「Office 2010 互換機能パックのインストール」 「ターゲット違反」: false、 "ターゲット日付": "0001-01-01T00:00:00Z", "TypeOfChange_Valid": "E7663AFB13CC47E6BB13DE2DFC66CD8D", "TypeOfChange": "重要", "Urgency_Valid": "44021B6CC6E44E598868C4B3306053AE", "スポンサー有効": "D844686D74224F159EAFA7F11D0792EA", 「スポンサー」:「アレン・W・コープ」、 "RiskLevel_Valid": "3548D4C1230B491DAB1D315AA93902B5", 「リスクレベル」: 「低」 "RiskCatalogLink_Category": "", "RiskCatalogLink_RecID": "", "RiskCatalogLink": null, "ReleaseLink_Category": "", "ReleaseLink_RecID": "", "リリースリンク": "", "CIへのトリガー変更": "0001-01-01T00:00:00Z", "RequesterLocation": "APAC - 中国", "依頼者電話番号": " 86 10 8520 0424", "Cost": 182, 「合計消費時間」: 160, "IsUnRead": false } |
失敗した応答
シナリオ: 変更を更新するには、指定されたオブジェクト ID が空または空白です。
例:
https://{tenant url}/api/odata/businessobject/changes(' ')
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | [ 「ビジネス オブジェクト キーが無効です」 ], |
HTTP ステータス コード | 400 |
シナリオ: 変更を更新するときに、指定されたオブジェクト ID が無効です。
例:
https://{teannt url}/api/odata/businessobject/changes('1234')
https://{tenant url}/api/odata/businessobject/changes('random')
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | [ "Record '1234' cannot be found in the business object 'change'" ], |
HTTP ステータス コード | 400 |
シナリオ: 有効なビジネス オブジェクト インスタンスを適切なキーで更新するときに、ビジネス オブジェクト フィールド定義の一部ではない無効な要求本文またはキー値のペアが提供されます。
例:
https://{tenant url}/api/odata/businessobject/changes('05B5CD2DFAE54D86A04C74DBF616C1DE')
ヘッダー名:
認証: セッションキー
HTTP PUT/パッチ | リクエストペイロードは次のとおりです: {"name": "test"} |
|---|---|
コード | ISM_4000 |
説明 | 無効なリクエストペイロード |
メッセージ | [ 「フィールド 'name' はビジネスオブジェクト 'Change' に存在しません ], |
HTTP ステータス コード | 400 |
シナリオ: 適切なキーと有効なリクエスト本文を使用して有効なビジネス オブジェクト インスタンスを更新しているときに、何らかの理由で処理されないコードが提供され、更新に失敗した場合。
ヘッダー名:
認証: セッションキー
コード | ISM_5000 |
|---|---|
説明 | 内部サーバーエラー |
メッセージ | [ 「サーバーに内部エラーが発生しました。 リクエストを再試行してください。" ], |
HTTP ステータス コード | 500 |
