Domain Transfer で Vault データを移行する

Google Workspace Domain Transfer サービスは Google Vault の案件や記録保持を移行できません。代わりに、移行元と移行先の環境を担当する管理者が、次の手順を行って Vault のアイテムを確実に移行してください。

始める前に

Vault の案件と記録保持を移行するには、Vault API を使用する必要があります。この手順は、Vault のユーザー インターフェースを使用して完了することはできません。

Google Apps Manager（GAM）は、Vault API に対応しているサードパーティ製のコマンドライン ツールです。このツールは GitHub にあります。

ステップ 1: 案件や記録保持をダウンロードする

移行後は、移行元の環境で Vault の案件と記録保持にアクセスできなくなります。引き続きアクセスできるようにするには、移行前処理で、移行元の環境から案件と記録保持をダウンロードします。ダウンロードを完了するには、Google Workspace 特権管理者または Vault 管理者である必要があります。

ダウンロードは、移行の少なくとも 1 週間前に完了する必要があります。

案件

API メソッド	matters.list ユーザーがアクセスできる案件を一覧表示します。詳細
パラメータ	view: FULL レスポンスで案件のどの部分を返すか指定します。 state: OPEN 指定したステータスの案件のみを一覧表示します。デフォルトでは、すべてのステータスの案件を一覧表示します。

案件を CLOSED または DELETED のステータスで作成することはできません。そのような案件を含めたい場合は、OPEN のステータスで追加してからクローズまたは削除する必要があります。

記録保持

API メソッド	matters.holds.list ある案件内のすべての記録保持を一覧表示します。ListHoldsResponse のページトークンが空であれば、表示する記録保持がないことを示します。詳細
パラメータ	view: FULL_HOLD 記録保持のどの部分を返すかを指定します。

ステップ 2: ダウンロードした案件や記録保持をクリーンアップする

ダウンロードした案件と記録保持を検査して、最適化できるかどうかを判断します。

1. 組織部門で記録保持が設定されている場合は、Orgunits API を使用して、すべての組織部門を移行先環境の対応する移行組織部門にマッピングします。詳細

   グループや共有ドライブに対する記録保持については、移行ルート組織部門レベルでマッピングを行う必要があります。

2. （省略可）空の案件や記録保持を削除します。

（省略可）案件を異なるオーナーで作成する予定の場合は、matterPermissions[] フィールドですべての OWNER 権限を COLLABORATOR 権限に変換します。詳細

ステップ 3: 案件や記録保持をアップロードする

移行処理が完了したら、移行先環境に案件や記録保持をアップロードする必要があります。

また、Vault の保持ポリシーを適切に設定する必要があります。詳細

案件

API メソッド

matters.create 指定された名前と説明で案件を作成します。初期ステータスは「有効」で、オーナーはメソッドの呼び出し元になります。作成された案件はデフォルトのビューで返されます。詳細

その他の留意点

• 新しく作成された matterId は必ずメモしておいてください。これは、移行元環境の matterId と移行先環境の matterId の間のマッピングを維持するために必要です。
• 案件名が一意でなければならないという制約はありません。移行元の環境で失敗のステータスになった案件を移行先で（失敗ではないステータスで）再作成しようとしたときに、案件が重複して作成される可能性があります。
• 案件をアップロードする場合、アップロードを行うユーザーがオーナーになります。詳しくは、サービス アカウントを使ってユーザーを偽装する方法についての記事をご覧ください。

記録保持

API メソッド

matters.holds.create 指定された案件で記録保持を作成します。詳細

その他の留意点

• 記録保持の名前は案件内で一意に決められているので、重複してアップロードする心配はありません。
• 新しく作成された holdId は必ずメモしておいてください。これは、移行元環境の holdId と移行先環境の holdId のマッピングを維持するために必要です。
• 記録保持に含まれるアカウント数が、作成時に追加可能なアカウント数の上限を超えている場合は、記録保持の作成後にアカウントを個別に追加できます。これを行うには API メソッド matters.holding.accounts.create を使用します。詳細

ステップ 4: 24 時間待つ

アップロードの完了後、関連するすべてのユーザーに新しい記録保持が確実に反映されるには、24 時間ほどかかります。