https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/index.html Recent content in 1.3 APIの詳細と実行例 on JP1 Cloud Service 運用統合 APIリファレンス Hugo -- gohugo.io ja https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/person_change/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/person_change/index.html （1）ワークフローのコンテキストIDを取得する <% ctx().st2.action_execution_id %>※で取得したワークフローのExecution IDを使用して、実行中のワークフローのコンテキストIDを取得します。API実行例を以下に示します。 ＜実行例＞ api/v1/practice-contexts # curl -XGET "Ops IのURL/api/v1/practice-contexts?filterBy=executionId%3Aeq%3AワークフローのExecution ID" ¥ -H "X-OpsI-Token: Ops Iトークン" コンテキストIDはAPIのレスポンスに含まれる「id」から取得できます。詳細は「標準提供API（v1）」のAPIの詳細「GET /practice-contexts」のレスポンスの詳細「dtos.ContextDTO」を参照してください。 ※詳細についてはStackStorm公式ページを参照してください。 https://docs.stackstorm.com/3.8/orquesta/stackstorm.html#stackstorm-context （2）ワークフローの詳細情報を取得する コンテキストIDを使ってワークフローの詳細情報を取得し親のscheduleオブジェクトのIDを取得します。API実行例を以下に示します。 ＜実行例＞ api/v1/practice-contexts/{id} # curl -XGET "Ops IのURL/api/v1/practice-contexts/コンテキストID" ¥ -H "X-OpsI-Token: Ops Iトークン" 親のscheduleオブジェクトのIDはAPIのレスポンスに含まれる「schedule」から取得できます。詳細は「標準提供API（v1）」のAPIの詳細「GET /practice-contexts/{id}」のレスポンスの詳細「dtos.ContextDTO」を参照してください。 （3）スケジュールの情報を取得する 親のscheduleオブジェクトのIDを使ってスケジュールの詳細情報を取得します。 親のscheduleオブジェクトはワークフローにひもづいたスケジュールで、親アクティビティと呼ばれるものです。 スケジュールの詳細情報には、各ステップのアクティビティに対応する子スケジュールの情報も含まれます。担当者を更新したいステップに対応する子スケジュールを特定し、IDを取得します。API実行例を以下に示します。 ＜実行例＞ /api/v1/schedules/{id} # curl -XGET "Ops IのURL/api/v1/schedules/親のscheduleオブジェクトのID" ¥ -H "X-OpsI-Token: Ops Iトークン" 親のscheduleオブジェクトの詳細に含まれる、更新対象のスケジュールの詳細はAPIのレスポンスに含まれる「children」で取得できます。 担当者を更新したいステップを特定するには、レスポンスの「children」の配下にある「dtos.ChildSchedule」の「activity」が更新対象のアクティビティ名になっていることを確認してください。特定したステップの「dtos.ChildSchedule」の「id」が更新対象のscheduleオブジェクトのIDです。詳細は「標準提供API（v1）」のAPIの詳細「GET /schedules/{id}」のレスポンスの詳細「dtos.ScheduleDTO」、「dtos.ChildSchedule」を参照してください。 （4）スケジュールの情報からワークフローの担当者を変更する 変更対象のscheduleオブジェクトのIDを使って、変更対象スケジュールの担当者フィールドにユーザーIDをセットして、アクティビティの担当者を変更します。API実行例を以下に示します。 ＜実行例＞ api/v1/schedules/{id} # curl -XPUT "Ops IのURL/api/v1/schedules/更新対象のscheduleオブジェクトのID" ¥ -H "X-OpsI-Token: Ops Iトークン" ¥ https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/custom_acl/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/custom_acl/index.html （1）ACLの一覧を取得する ACLの名前の一覧を取得します。API実行例を以下に示します。 一覧の名前はACLのYAMLファイルのnameです。その中に作成したカスタムACLの名前があるかどうかを確認してください。 ＜実行例＞ /api/v1/acls # curl -XGET "Ops IのURL/api/v1/acls" ¥ -H "X-OpsI-Token: Ops Iトークン" （2）ACLの詳細情報を取得する 取得したカスタムACLの名前を指定してACLの詳細情報を取得します。API実行例を以下に示します。 ＜実行例＞ /api/v1/acls/{name} # curl -XGET "Ops IのURL/api/v1/acls/カスタムACL" ¥ -H "X-OpsI-Token: Ops Iトークン" （3）ロールにACLを割り当てる ロールにカスタムACLを割り当てます。API実行例を以下に示します。 指定するロールの名前は、システム管理画面から控えておいてください。 ＜実行例＞ /api/v1/acls/roles/{roleName} # curl -XPOST "Ops IのURL/api/v1/acls/roles/ロール名" ¥ -H "X-OpsI-Token: Ops Iトークン" ¥ -H "Content-Type: application/json" -d @sample.json （4）ロールに割り当てられたACLを取得する ACLが意図した通りのものかを確認します。API実行例を以下に示します。 ACLに含まれるstatementの情報も取得されますので、合わせて確認してください。 ＜実行例＞ /api/v1/acls/roles/{roleName} # curl -XGET "Ops IのURL/api/v1/acls/roles/ロール名" ¥ -H "X-OpsI-Token: Ops Iトークン" （5）ロールに割り当てられたACLを解除する ロールに割り当てられたカスタムACLを解除します。API実行例を以下に示します。 指定するロールの名前は、システム管理画面から控えておいてください。 ＜実行例＞ /api/v1/acls/roles/{roleName} https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/delete_repository/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM72029001/apireference/example/delete_repository/index.html 作成したリポジトリを修正したい場合は、削除して新たに作成し直すという作業が必要になります。 リポジトリの作成はOps Iのリポジトリ管理で行います。詳細については「JP1 Cloud Service 運用統合 利用ガイド」の「機能＞システム＞リポジトリ管理」を参照してください。 （1）リポジトリ一覧を取得する 作成したリポジトリのIDを確認します。API実行例を以下に示します。 クエリパラメータで絞り込みができます。 クエリパラメータの絞り込み例：GET /api/v1/repositories?search=test%20repo なお、このIDはUUID形式ではなく、GitLab上のリポジトリIDとなります。 ＜実行例＞ /api/v1/repositories # curl -XGET "Ops IのURL/api/v1/repositories" ¥ -H "X-OpsI-Token: Ops Iトークン" （2）リポジトリを削除する 取得したリポジトリIDで指定したリポジトリを削除します。API実行例を以下に示します。 ＜実行例＞ /api/v1/repositories/{id} # curl -XDELETE "Ops IのURL/api/v1/repositories/リポジトリID" ¥ -H "X-OpsI-Token: Ops Iトークン"