> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# リテンションポリシー

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

リテンションポリシーは、指定した期間にわたってコンテンツが完全に削除されるのを防止します。管理者はリテンションポリシーを作成して特定のフォルダや会社全体に割り当てることができます。リテンションポリシーを使用すると、データを必要な期間保持し、法的にデータの保持が必要なくなったときに自動的にコンテンツを完全に削除することができます。

<Info>
  リテンションポリシーは、Business PlusアカウントまたはEnterpriseアカウントに追加できる、[Box Governance][governance]パッケージの機能です。
</Info>

## ポリシー、割り当て、およびリテンション

リテンションポリシーを操作するには、開発者は3つの異なるリソースを使用する必要があります。

* **ポリシー:** <Link href="/reference/resources/retention-policy">リテンションポリシー</Link>には、リテンションポリシーの一般的な動作が記載されています。これにより、リテンションを保持する期間、リテンションの延長が可能かどうか、およびリテンションポリシーの終了条件が決まります。
* **割り当て:** <Link href="/reference/resources/retention-policy-assignment">リテンションポリシー割り当て</Link>は、ポリシーとフォルダや会社の関係です。割り当てを作成すると、そのフォルダや会社に属するすべてのファイルバージョンにリテンションが適用されます。たとえば、フォルダに割り当てが作成されると、ポリシーはそのフォルダ内にあるすべてのファイルバージョンに適用されます。
* **リテンション**: <Link href="/reference/resources/file-version-retention">ファイルバージョンリテンション</Link>は、特定のファイルバージョンに割り当てられているすべてのポリシーを表します。各ファイルバージョンに設定できるファイルバージョンのリテンションは最大1つで、このリソースには、割り当てられた各ポリシーのリストが含まれていることに注意してください。

<Warning>
  Box APIの<Link href="/reference/resources/file-version-retention">ファイルバージョンリテンション</Link>セクションは非推奨になりました。代わりに、<Link href="/reference/get-retention-policy-assignments-id-files-under-retention">リテンションの対象となるファイル</Link>エンドポイントまたは<Link href="/reference/get-retention-policy-assignments-id-file-versions-under-retention">リテンションの対象となるファイルバージョン</Link>エンドポイントを使用できます。
</Warning>

## リテンションポリシーによるファイルの削除

リテンションの対象となっているファイルは、フォルダから削除することはできますが、リテンションが期限切れるまではごみ箱に残ります。リテンションが期限切れになると、コンテンツが自動的に削除されるようにするか、ポリシーを削除するかを選択できます。

## ファイルのリテンション期間の延長

リテンションの対象となっているファイルのリテンション期間は、`disposition_at`フィールドの値を将来の日付で<Link href="/reference/put-files-id/#param-disposition_at">更新</Link>することで延長できます。一度延長した期間は、元に戻すことも、新しい日付より前に変更することもできません。

## 必須のスコープ

リテンションポリシーAPIのいずれかを使用する前に、アプリケーションでは次の<Link href="/guides/api-calls/permissions-and-errors/scopes">スコープ</Link>を有効にしておく必要があります。

* \[<Link href="/guides/api-calls/permissions-and-errors/scopes#manage-retention-policies">リテンションポリシーを管理する</Link>] は、開発者コンソールの \[**構成**] > \[**アプリケーションスコープ**] にあります
* \[<Link href="/guides/api-calls/permissions-and-errors/scopes#global-content-manager-gcm">グローバルコンテンツマネージャ (GCM)</Link>] は、カスタマーサポートに連絡して有効化します

[governance]: https://www.box.com/security/governance-and-compliance
