AIP復元¶
AIP復元は、ストレージサービス管理者が破損したAIPの保存されたバージョンを正しいバージョンと置き換えることを可能にします。このプロセスでは、AIPの破損していないバックアップコピーを持っている必要があります。回復プロセスを利用してAIPを置き換えることで、回復されたAIPのバージョンがArchivematicaダッシュボードを通じてユーザーに利用可能になります。
このページについて：
AIP復元の実行¶
*AIP復元*ディレクトリのパスを決定します。ストレージサービスのユーザーインターフェースの**ロケーション**タブをクリックすることで、このディレクトリのパスを見つけることができます。そこで、「AIP復元」を目的とするパスを見つけます。これがAIP復元のロケーションです。
復元されたAIPのバージョンをAIP復元場所にコピーします。
ストレージサービスのREST APIを利用して、 リカバリーリクエスト を行います。
ストレージサービスのユーザーインターフェースで**パッケージ**タブに移動し、**復元リクエストを表示**をクリックしてAIPの復元リクエストを承認します。復元の理由を記入して**承認**をクリックします。
復元が承認されたら、ストレージサービスは次の操作を行います：
復元されたAIPの固定性データを確認します。この初期の固定性チェックに失敗した場合、復元は失敗します。
破損したAIPを復元場所内のバックアップディレクトリにコピーします。
復元されたAIPをAIPストレージにコピーします。
保存されたAIPの固定性データをチェックします。この二番目の固定性チェックに失敗した場合、復元は失敗するでしょう。
AIPは、ストレージサービスのユーザーインターフェースのパッケージタブ、およびArchivematicaダッシュボードのアーカイブストレージタブからダウンロードできるようになります。
復元リクエストの例¶
復元されたAIPが配置されると、ストレージサービスのREST APIを使ってAPIリクエストを行わなければなりません。例は以下の通りです：
curl --data="event_reason=<description>&pipeline=<pipeline UUID>&user_id=<int>&user_email=<email>" http://127.0.0.1:8000/api/v2/file/<package UUID>/recover_aip/?format=json
以下の情報でプレースホルダーを置き換えてください：
<description>: 回復リクエストの理由についての説明。<int>: 数値のユーザーIDです。ユーザーIDを検索するには、管理**タブに移動し、左側のサイドバーの**ユーザー**をクリックします。リクエストを行っているユーザーの**編集**をクリックします。ユーザーIDは、ユーザー編集ページのURLに表示されます。例えば、「 ``http://my-site:8000/administration/users/1/edit/`` 」のユーザーIDは **1 です。<email>: リクエストを行うユーザーのメールアドレス。
Binder を使用している場合、Binderは置き換えられるAIPが回復の準備ができていることをストレージサービスに通知する能力を持っています。詳しくは Binder 回復ドキュメント をご覧ください。
回復の進行状況を外部システムに報告¶
AIP回復は、REST POSTコールを通じて別のシステムに進捗を報告するようにオプションで設定することができます。そのコールには、AIP回復タスクが承認されたか、拒否されたか、または失敗したかが報告されます。送信される情報には、回復リクエストのID、回復リクエストが正常に処理されたか、および回復リクエストの状態（「承認」または「拒否」）と決定に対する管理者の理由を含むテキストメッセージが含まれます。
以下は、このPOSTコールによって送信されるJSONの例です：
{
"event_id": 127,
"message": "APPROVE: Request approved, files look good.",
"success": true
}
ストレージサービスがAIPリストアの進行状況を他のシステムに報告するように設定するには、ストレージサービスのユーザーインタフェースで**管理**をクリックし、RESTエンドポイントのURLを**リカバリーリクエスト：通知するURL**フィールドに入力してください。
エンドポイントに認証が必要な場合は、ユーザーネームとパスワードをそれ以下の2つのフィールドに入力する必要があります。入力が完了したら**保存**をクリックしてください。