# パッケージを削除および復元する パッケージの削除と復元の方法を学びます。 ## GitHub でのパッケージの削除と復元への対応 必要なアクセス権がある場合は、 GitHub で以下を削除できます。 * プライベート パッケージ全体 * パッケージのいずれかのバージョンのダウンロード数が5000より多くない場合、パブリックパッケージ全体がその対象となります。 * プライベート パッケージの特定のバージョン * パッケージ バージョンのダウンロード数が 5,000 以下の場合、パブリック パッケージの特定のバージョン > \[!NOTE] > > * パッケージのいずれかのパージョンでダウンロード数が 5,000 を超えている場合は、パブリック パッケージを削除できません。 この場合は、さらにサポートが必要な場合は[GitHub Support ポータル](https://support.github.com/)からお問い合わせください。 > * パブリックパッケージを削除する場合、そのパッケージに依存するプロジェクトを破壊する可能性があることに注意してください。 GitHubでは、次の場合にパッケージまたはパッケージのバージョン全体を復元することもできます。 * 削除後30日以内にパッケージを復元する。 * 同じパッケージ名前空間が現在も使用可能であり、新しいパッケージに使用されていない場合。 ## パッケージAPIのサポート > \[!NOTE] > GitHub Packages では、 personal access token (classic)を使用した認証のみがサポートされます。 詳しくは、「[個人用アクセス トークンを管理する](/ja/enterprise-server@3.22/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)」をご覧ください。 REST APIを使用してパッケージを管理できます。 詳細については、「[パッケージの REST API エンドポイント](/ja/enterprise-server@3.22/rest/packages)」を参照してください。 > \[!NOTE] > REST API を使ってパッケージを削除および復元する GitHub Actions ワークフローの機能は、現在 パブリック プレビュー 段階であり、変更される可能性があります。 詳細なアクセス許可をサポートするレジストリでは、`GITHUB_TOKEN` ワークフローのGitHub Actionsを使用して、REST API を使用してパッケージを削除または復元できます。 トークンには、パッケージに対する `admin` アクセス許可が必要です。 ワークフローによってパッケージが発行される場合は、ワークフローが格納されているリポジトリに既定で `admin` ロールが付与されます。 ワークフローによって発行されていない既存のパッケージの場合は、`admin` ワークフローを使用して REST API を使用してパッケージを削除または復元できるように、GitHub Actions ロールをリポジトリに付与する必要があります。 詳しくは、「[パッケージのアクセス制御と可視性の設定](/ja/enterprise-server@3.22/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)」をご覧ください。 特定のレジストリでは、GraphQL を使ってプライベート パッケージのバージョンを削除できます。 詳細なアクセス許可をサポートするレジストリでは、GitHub Packages GraphQL API を使用できません。 リポジトリ スコープのアクセス許可**のみ**をサポートし、GraphQL API で使用できるレジストリについては、「[GitHub Packagesの権限について](/ja/enterprise-server@3.22/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」をご覧ください。 ## パッケージの削除や復元に必要な権限 詳細なアクセス許可をサポートするレジストリでは、パッケージをユーザーまたは organization にスコープ指定するか、リポジトリにリンクすることを許可できます。 リポジトリとは別の詳細なアクセス許可を持つパッケージ ( `https://containers.HOSTNAME/NAMESPACE/PACKAGE-NAME` に格納されているパッケージなど) を削除するには ( `NAMESPACE` は、パッケージのスコープが設定されている個人アカウントまたは組織の名前)、パッケージへの管理者アクセス権が必要です。 詳しくは、「[GitHub Packagesの権限について](/ja/enterprise-server@3.22/packages/learn-github-packages/about-permissions-for-github-packages)」をご覧ください。 リポジトリからアクセス許可を継承するパッケージの場合、リポジトリに対する管理者アクセス許可があれば、パッケージを削除できます。 一部のレジストリは、リポジトリがスコープ指定されたパッケージ**のみ**をサポートします。 これらのレジストリの一覧については、「[GitHub Packagesの権限について](/ja/enterprise-server@3.22/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」を参照してください。 ## パッケージのバージョンを削除する ### GitHub 上のリポジトリ スコープのパッケージのバージョンの削除 リポジトリ スコープ パッケージのバージョンを削除するには、パッケージが発行されているリポジトリに対する管理者アクセス許可が必要です。 詳細については、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. GitHub で、リポジトリのメイン ページに移動します。 2. リポジトリの右側のサイドバーで、 **\[パッケージ]** をクリックします。 ![リポジトリ ページのサイド バーのスクリーンショット。 \[パッケージ\] セクションが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/package-registry/packages-from-repo.png) 3. 検索したら、管理するパッケージの名前をクリックします。 4. パッケージの種類のバージョンを管理できる場所に移動します。 * \_パッケージがコンテナーの場合\_は、\[最近のバージョン] セクションの下にある **\[すべてのバージョンの表示と管理]** をクリックします。 ![パッケージの \[最近のバージョン\] セクションのスクリーンショット。 下の \[すべてのバージョンの表示と管理\] リンクが、オレンジ色の枠線で強調されています。](/assets/images/help/package-registry/packages-recent-versions-manage-link.png) * *コンテナー以外のパッケージの種類の場合*: 1. 右側にある **\[ Package settings]** をクリックします。 ![パッケージのランディング ページのスクリーンショット。 右下隅の \[パッケージの設定\] がオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/package-settings.png) 2. 左側の **\[バージョンの管理]** をクリックします。 ![パッケージの \[バージョンの管理\] メニューのスクリーンショット。 右下隅の \[バージョンの管理\] がオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/packages-settings-manage-versions-menu.png) 5. パッケージの一覧で、削除するパッケージのバージョンを見つけます。 * "パッケージがコンテナーの場合"、パッケージ バージョンの右側にある をクリックし、次にドロップダウン メニューから **\[Delete version]** を選びます。\_\_ ![展開されてメニューが表示されているパッケージ バージョンのケバブ ボタンのスクリーンショット。 メニューの \[Delete version\] リンクがオレンジ色で囲まれています。](/assets/images/help/package-registry/delete-container-package-version.png) * *コンテナー以外の種類のパッケージの場合*、パッケージのバージョンの右側にある **\[削除]** をクリックします。 ![\[削除\] ボタンが表示されたパッケージ バージョンのスクリーンショット。 ボタンがオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/delete-noncontainer-package-version.png) 6. 削除を確認するために、パッケージ名を入力し、 **[I understand the consequences, delete this version](影響を理解したうえで、このバージョンを削除します)** をクリックします。 ### GraphQLでリポジトリのスコープが付いたパッケージのバージョンを削除する 特定のレジストリでは、GraphQL を使ってプライベート パッケージのバージョンを削除できます。 詳細なアクセス許可をサポートするレジストリでは、GitHub Packages GraphQL API を使用できません。 リポジトリ スコープのアクセス許可**のみ**をサポートし、GraphQL API で使用できるレジストリについては、「[GitHub Packagesの権限について](/ja/enterprise-server@3.22/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)」をご覧ください。 代わりに REST API を使用する方法については、 [パッケージの REST API エンドポイント](/ja/enterprise-server@3.22/rest/packages) を参照してください。 GraphQL API の `deletePackageVersion` ミューテーションを使ってください。 `read:packages`、`delete:packages`、および`repo`スコープでは、personal access token (classic)を使用する必要があります。 personal access tokens (classic) の詳細については、「[GitHub Packages の概要](/ja/enterprise-server@3.22/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages)」を参照してください。 以下の例では、`packageVersionId` の `MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg` を使用して、パッケージ バージョンを削除する方法を示します。 ```shell curl -X POST \ -H "Accept: application/vnd.github.package-deletes-preview+json" \ -H "Authorization: bearer TOKEN" \ -d '{"query":"mutation { deletePackageVersion(input:{packageVersionId:\"MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg==\"}) { success }}"}' \ HOSTNAME/graphql ``` GitHub Packagesに発行したすべてのプライベート パッケージとパッケージのバージョン ID を検索するには、`packages` オブジェクトを介して`repository`接続を使用できます。 `read:packages` と `repo` のスコープを持つ personal access token (classic) が必要です。 詳細については、[`packages`](/ja/enterprise-server@3.22/graphql/reference/repos#object-repository) コネクションまたは [`PackageOwner`](/ja/enterprise-server@3.22/graphql/reference/packages#interface-packageowner) インターフェイスを参照してください。 `deletePackageVersion` ミューテーションの詳細については、「[パッケージ](/ja/enterprise-server@3.22/graphql/reference/packages#mutation-deletepackageversion)」を参照してください。 GraphQL を使用してパッケージ全体を直接削除することはできませんが、パッケージのすべてのバージョンを削除すると、パッケージは GitHubに表示されなくなります。 ## パッケージ全体を削除する ### GitHub でリポジトリ スコープのパッケージ全体を削除 リポジトリのスコープが付いたパッケージ全体を削除するには、パッケージを所有するリポジトリの管理者権限が必要です。 詳細については、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. GitHub で、リポジトリのメイン ページに移動します。 2. リポジトリの右側のサイドバーで、 **\[パッケージ]** をクリックします。 ![リポジトリ ページのサイド バーのスクリーンショット。 \[パッケージ\] セクションが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/package-registry/packages-from-repo.png) 3. 検索したら、管理するパッケージの名前をクリックします。 4. パッケージのランディング ページの右側にある、**\[ Package settings]** をクリックします。 ![パッケージのランディング ページのスクリーンショット。 右下隅の \[パッケージ設定\] がオレンジ色の枠線で強調表示されています。](/assets/images/help/package-registry/package-settings.png) 5. ページの下部にある \[危険なゾーン] で **\[このパッケージを削除する]** をクリックします。 6. 確認のために、確認メッセージを確認して、パッケージ名を入力し、 **\[影響を理解したうえで、このパッケージを削除します]** をクリックします。 ### GitHub でユーザー スコープ パッケージ全体を削除する。 パッケージを削除できるユーザーを確認するには、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. GitHub で、個人アカウントのメイン ページに移動します。 2. GitHub の右上隅にあるプロフィール画像をクリックしてから、**\[Your profile]** をクリックします。 ![@octocat のプロファイル写真の下にあるドロップダウン メニューのスクリーンショット。 \[自分のプロファイル\] が濃いオレンジ色の枠線で囲まれています。](/assets/images/help/profile/profile-button-avatar-menu-global-nav-update.png) 3. プロファイル ページのヘッダーで、**\[ Packages]** タブをクリックします。 4. 検索したら、管理するパッケージの名前をクリックします。 5. パッケージのランディング ページの右側にある、**\[ Package settings]** をクリックします。 ![パッケージのランディング ページのスクリーンショット。 右下隅の \[パッケージ設定\] がオレンジ色の枠線で強調表示されています。](/assets/images/help/package-registry/package-settings.png) 6. 左側の **\[オプション]** をクリックします。 ![パッケージの \[オプション\] メニューのスクリーンショット。 右下隅の \[オプション\] がオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/packages-settings-options-menu.png) 7. ページの下部にある \[危険なゾーン] で **\[このパッケージを削除する]** をクリックします。 8. 確認ボックスにパッケージの名前を入力して、それを削除することを確認します。 9. **\[影響を理解したうえで、このパッケージを削除します]** をクリックします。 ### 組織全体を対象範囲にしたパッケージの削除 GitHub パッケージを削除できるユーザーを確認するには、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. GitHubで、Organizationのメインページにアクセスしてください。 2. Organization 名の下にある **\[ Packages]** タブをクリックします。 ![@octo-org のプロファイル ページのスクリーンショット。 \[パッケージ\] タブがオレンジ色の枠線で強調表示されています。](/assets/images/help/package-registry/org-tab-for-packages-with-overview-tab.png) 3. 検索したら、管理するパッケージの名前をクリックします。 4. パッケージのランディング ページの右側にある、**\[ Package settings]** をクリックします。 ![パッケージのランディング ページのスクリーンショット。 右下隅の \[パッケージ設定\] がオレンジ色の枠線で強調表示されています。](/assets/images/help/package-registry/package-settings.png) 5. 左側の **\[オプション]** をクリックします。 ![パッケージの \[オプション\] メニューのスクリーンショット。 右下隅の \[オプション\] がオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/packages-settings-options-menu.png) 6. ページの下部にある \[危険なゾーン] で **\[このパッケージを削除する]** をクリックします。 7. 確認ボックスにパッケージの名前を入力して、それを削除することを確認します。 8. **\[影響を理解したうえで、このパッケージを削除します]** をクリックします。 ## パッケージを復元する 以下の場合、削除したパッケージまたはバージョンを復元できます。 * 削除後30日以内にパッケージを復元する。 * 同じパッケージ名前空間とバージョンは依然として利用可能であり、新しいパッケージには再利用されていません。 たとえば、ユーザー `octocat` で、リポジトリ `my-package` にスコープが設定された `octocat/my-repo` という名前の RubyGems パッケージを削除した場合、パッケージ名前空間 `rubygem.pkg.github.com/octocat/my-repo/my-package` がまだ使用可能で、30 日経過していない場合にのみ、そのパッケージを復元できます。 パッケージを削除するには、パッケージが発行されているリポジトリに対する管理者アクセス許可も必要です。 詳細については、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 パッケージが復元されると、そのパッケージは以前使用していたものと同じ名前空間を使用します。 同一のパッケージ名前空間が使用可能でない場合、パッケージを復元できません。 この場合、削除したパッケージを復元するには、まず削除したパッケージの名前空間を使用する新しいパッケージを削除する必要があります。 ### Organization内のパッケージを復元する 削除されたパッケージは、そのパッケージが organization が所有するリポジトリにあるか、詳細なアクセス許可を持っており、organization アカウントにスコープが設定されている限り、organization アカウント設定から復元できます。 Organization でパッケージを復元できるユーザーを確認するには、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. GitHub で、organization のメイン ページに移動します。 2. Organization 名の下で、**\[ Settings]** をクリックします。 \[設定] タブが表示されない場合は、 **\[]** ドロップダウン メニューを選び、 **\[設定]** をクリックします。 ![組織のプロファイルのタブのスクリーンショット。 \[設定\] タブが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/discussions/org-settings-global-nav-update.png) 3. 左側の **\[パッケージ]** をクリックします。 4. [Deleted Packages](削除されたパッケージ) の、復元するパッケージの隣にある **\[復元]** をクリックします。 5. 確認のため、パッケージ名を入力し、 **[I understand the consequences, restore this package](影響を理解したうえで、このパッケージを復元します)** をクリックします。 ### ユーザアカウントに関連付けられたパッケージを復元する パッケージが所有するリポジトリにあったか、個人アカウントのスコープが付いていた場合、削除されたパッケージを個人アカウント設定から復元できます。 詳細については、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. GitHub の任意のページの右上隅にあるプロフィール写真をクリックし、**\[ Settings]** をクリックします。 2. 左側のサイドバーで、 **\[パッケージ]** をクリックします。 3. [Deleted Packages](削除されたパッケージ) の、復元するパッケージの隣にある **\[復元]** をクリックします。 4. 確認のため、パッケージ名を入力し、 **[I understand the consequences, restore this package](影響を理解したうえで、このパッケージを復元します)** をクリックします。 ### パッケージのバージョンを復元する パッケージのバージョンは、パッケージのランディング ページから復元できます。 パッケージを復元できるユーザーを確認するには、「[必要なアクセス許可](#required-permissions-to-delete-or-restore-a-package)」を参照してください。 1. パッケージのランディングページに移動します。 2. 検索したら、管理するパッケージの名前をクリックします。 3. パッケージのランディング ページの右側にある、**\[ Package settings]** をクリックします。 ![パッケージのランディング ページのスクリーンショット。 右下隅の \[パッケージ設定\] がオレンジ色の枠線で強調表示されています。](/assets/images/help/package-registry/package-settings.png) 4. パッケージの種類のバージョンを管理できる場所に移動します。 * \_パッケージがコンテナーの場合\_は、\[最近のバージョン] セクションの下にある **\[すべてのバージョンの表示と管理]** をクリックします。 ![パッケージの \[最近のバージョン\] セクションのスクリーンショット。 下の \[すべてのバージョンの表示と管理\] リンクが、オレンジ色の枠線で強調されています。](/assets/images/help/package-registry/packages-recent-versions-manage-link.png) * *コンテナー以外のパッケージの種類の場合*: 1. 右側にある **\[ Package settings]** をクリックします。 ![パッケージのランディング ページのスクリーンショット。 右下隅の \[パッケージの設定\] がオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/package-settings.png) 2. 左側の **\[バージョンの管理]** をクリックします。 ![パッケージの \[バージョンの管理\] メニューのスクリーンショット。 右下隅の \[バージョンの管理\] がオレンジ色の枠線で強調されています。](/assets/images/help/package-registry/packages-settings-manage-versions-menu.png) 5. パッケージ バージョン一覧の右上隅にある **\[バージョンの表示の選択]** ドロップダウンを使って、 **\[削除済み]** を選びます。 ![パッケージ バージョンの一覧のスクリーンショット。 バージョンの表示の \[削除済み\] の選択が、オレンジ色の枠線で強調されています。](/assets/images/help/package-registry/versions-drop-down-menu.png) 6. 復元する削除済みパッケージのバージョンの横にある **\[復元]** をクリックします。 7. 確認のために、 **\[影響を理解したうえで、このバージョンを復元します]** をクリックします。