Löschen und Wiederherstellen eines Pakets

Wenn du über den erforderlichen Zugriff verfügst, kannst du unter Folgendes löschen:

• ein gesamtes privates Paket
• ein gesamtes öffentliches Paket, wenn eine Version des Pakets nicht mehr als 5.000 Downloads aufweist
• eine bestimmte Version eines privaten Pakets
• eine bestimmte Version eines öffentlichen Pakets, wenn die Paketversion nicht mehr als 5.000 Downloads aufweist

Unter kannst du auch ein gesamtes Paket oder eine gesamte Paketversion wiederherstellen, wenn Folgendes zutrifft:

• Du stellst das Paket innerhalb von 30 Tagen nach dem Löschen wieder her.
• Derselbe Paketnamespace ist weiterhin verfügbar und wird nicht für ein neues Paket verwendet.

Du kannst die REST-API verwenden, um deine Pakete zu verwalten. Weitere Informationen findest du unter REST-API-Endpunkte für Pakete.

Mithilfe von Registrierungen, die detaillierte Berechtigungen unterstützen, können Sie ein _TOKEN in einem Actions-Workflow verwenden, um Pakete mithilfe der REST-API zu löschen oder wiederherzustellen. Das Token muss über die admin-Berechtigung für das Paket verfügen. Wenn dein Workflow ein Paket veröffentlicht, wird die admin-Rolle standardmäßig dem Repository zugewiesen, in dem der Workflow gespeichert ist. Bei vorhandenen Paketen, die nicht von einem Workflow veröffentlicht werden, musst du dem Repository die admin-Rolle zuweisen, um einen Actions-Workflow zum Löschen oder Wiederherstellen von Paketen mithilfe der REST-API verwenden zu können. Weitere Informationen finden Sie unter Konfigurieren der Zugriffssteuerung und Sichtbarkeit von Paketen.

Bei bestimmten Registrierungen kannst du GraphQL zum Löschen einer Version eines privaten Pakets verwenden.

Du kannst die Packages-GraphQL-API nicht bei Registrierungen verwenden, die differenzierte Berechtigungen unterstützen. Informationen zu Registrierungen, die ausschließlich repositorybezogene Berechtigungen unterstützen und mit der GraphQL-API verwendet werden können, findest du unter Informationen zu Berechtigungen für -Pakete.

Bei Registrierungen, die differenzierte Berechtigungen unterstützen, kannst du festlegen, dass Pakete auf einen Benutzer oder eine Organisation ausgerichtet oder mit einem Repository verknüpft werden sollen.

Zum Löschen eines Pakets mit differenzierten Berechtigungen, die von einem Repository getrennt sind (beispielsweise unter https://ghcr.io/NAMESPACE/PACKAGE-NAME gespeicherte Containerimages oder unter https://npm.pkg..com/NAMESPACE/PACKAGE-NAME gespeicherte Pakete), wobei NAMESPACE der Name des persönlichen Kontos oder der Organisation ist, auf das bzw. die das Paket ausgerichtet ist, musst du über Administratorzugriff auf das Paket verfügen. Weitere Informationen finden Sie unter Informationen zu Berechtigungen für -Pakete.

Bei Paketen, die ihre Zugriffsberechtigungen von Repositorys erben, kannst du ein Paket löschen, wenn du über Administratorberechtigungen für das Repository verfügst.

Einige Registrierungen unterstützen nur repositorybezogene Pakete. Eine Liste dieser Registrierungen findest du unter Informationen zu Berechtigungen für -Pakete.

Um eine Version eines Pakets mit Repositorygeltungsbereich zu löschen, müssen Sie über Administratorberechtigungen für das Repository verfügen, in dem das Paket veröffentlicht wird. Weitere Informationen finden Sie unter Erforderliche Berechtigungen.

1. Navigieren Sie auf zur Hauptseite des Repositorys.

2. Wähle auf der rechten Randleiste deines Repositorys die Option Pakete aus.

   

3. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

4. Wähle in der Liste „Zuletzt verwendete Versionen“ die Option Alle Versionen anzeigen und verwalten aus.

   

5. Suche in der Liste der Pakete die Version des Pakets, das du löschen möchtest.

   • Wenn es sich bei deinem Paket um einen Container handelt, klicke rechts neben der Paketversion auf , und wähle dann im Dropdownmenü Version löschen aus.
     
   • Wähle für andere Pakettypen als Container rechts neben der Paketversion die Option Löschen aus.
     

6. Gib zum Bestätigen der Löschung den Paketnamen ein, und klicke auf Ich verstehe die Folgen, diese Version löschen.

Bei bestimmten Registrierungen kannst du GraphQL zum Löschen einer Version eines privaten Pakets verwenden.

Du kannst die Packages-GraphQL-API nicht bei Registrierungen verwenden, die differenzierte Berechtigungen unterstützen. Informationen zu Registrierungen, die ausschließlich repositorybezogene Berechtigungen unterstützen und mit der GraphQL-API verwendet werden können, findest du unter Informationen zu Berechtigungen für -Pakete. Informationen zur alternativen Verwendung der REST-API findest du unter REST-API-Endpunkte für Pakete.

Verwende die deletePackageVersion-Mutation in der GraphQL-API. Du musst ein personal access token (classic) mit den Bereichen read:packages, delete:packages und repo verwenden. Weitere Informationen zu personal access tokens (classic), findest du unter Einführung in -Pakete.

Im folgenden Beispiel wird veranschaulicht, wie eine Paketversion mithilfe einer packageVersionId von MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg gelöscht wird.

curl -X POST \
-H "Accept: application/vnd..package-deletes-preview+json" \
-H "Authorization: bearer TOKEN" \
-d '{"query":"mutation { deletePackageVersion(input:{packageVersionId:\"MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg==\"}) { success }}"}' \
HOSTNAME/graphql

Zum Finden aller privaten Pakete, die du unter Packages veröffentlicht hast, zusammen mit den Versions-IDs für die Pakete, kannst du die packages-Verbindung über das repository-Objekt verwenden. Du benötigst ein personal access token (classic) mit den Bereichen read:packages und repo. Weitere Informationen findest du in der packages-Verbindung oder der PackageOwner-Schnittstelle.

Weitere Informationen zur deletePackageVersion-Mutation findest du unter Mutationen.

Du kannst ein gesamtes Paket nicht direkt mithilfe von GraphQL löschen. Wenn du aber alle Versionen eines Pakets löschst, wird das Paket nicht mehr auf angezeigt.

Wenn du eine bestimmte Version eines benutzerbezogenen Pakets unter löschen möchtest, z. B. für ein Docker-Image unter ghcr.io, führe die folgenden Schritte aus. Informationen zum Löschen eines gesamten Pakets findest du unter Löschen eines gesamten benutzerbezogenen Pakets auf .

Informationen zum Überprüfen, wer eine Paketversion löschen kann, findest du unter Erforderliche Berechtigungen.

1. Navigiere auf zur Hauptseite deines persönlichen Kontos.

2. Klicke in der oberen rechten Ecke von auf dein Profilfoto und dann auf Dein Profil.

   

3. Wähle auf der Profilseite in der Kopfzeile die Registerkarte Pakete aus.

4. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

5. Wähle auf der Angebotsseite deines Pakets auf der rechten Seite die Option Paketeinstellungen aus.

   

6. Wähle in der Liste „Zuletzt verwendete Versionen“ die Option Alle Versionen anzeigen und verwalten aus.

   

7. Suche in der Liste der Pakete die Version des Pakets, das du löschen möchtest.

   • Wenn es sich bei deinem Paket um einen Container handelt, klicke rechts neben der Paketversion auf , und wähle dann im Dropdownmenü Version löschen aus.
     
   • Wähle für andere Pakettypen als Container rechts neben der Paketversion die Option Löschen aus.
     

8. Gib im Bestätigungsfeld den Namen des Pakets ein, um zu bestätigen, dass du die ausgewählte Version davon löschen möchtest.

9. Wähle Ich verstehe die Folgen, diese Version löschen aus.

Wenn du eine bestimmte Version eines organisationsbezogenen Pakets unter löschen möchtest, z. B. für ein Docker-Image unter ghcr.io, führe die folgenden Schritte aus. Informationen zum Löschen eines gesamten Pakets findest du unter Löschen eines gesamten organisationsbezogenen Pakets auf .

Informationen zum Überprüfen, wer eine Paketversion löschen kann, findest du unter Erforderliche Berechtigungen zum Löschen oder Wiederherstellen eines Pakets.

1. Navigiere auf zur Hauptseite deiner Organisation.

2. Wähle unter dem Namen deiner Organisation die Registerkarte Pakete aus.

   

3. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

4. Wähle auf der Angebotsseite deines Pakets auf der rechten Seite die Option Paketeinstellungen aus.

   

5. Wähle in der Liste „Zuletzt verwendete Versionen“ die Option Alle Versionen anzeigen und verwalten aus.

   

6. Suche in der Liste der Pakete die Version des Pakets, das du löschen möchtest.

   • Wenn es sich bei deinem Paket um einen Container handelt, klicke rechts neben der Paketversion auf , und wähle dann im Dropdownmenü Version löschen aus.
     
   • Wähle für andere Pakettypen als Container rechts neben der Paketversion die Option Löschen aus.
     

7. Gib im Bestätigungsfeld den Namen des Pakets ein, um zu bestätigen, dass du die ausgewählte Version davon löschen möchtest.

8. Wähle Ich verstehe die Folgen, diese Version löschen aus.

Zum Löschen eines gesamten repositorybezogenen Pakets musst du Administratorberechtigungen für das Repository besitzen, das das Paket besitzt. Weitere Informationen finden Sie unter Erforderliche Berechtigungen.

1. Navigieren Sie auf zur Hauptseite des Repositorys.

2. Wähle auf der rechten Randleiste deines Repositorys die Option Pakete aus.

   

3. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

4. Wähle auf der Angebotsseite deines Pakets auf der rechten Seite die Option Paketeinstellungen aus.

   

5. Wähle unten auf der Seite unter „Gefahrenzone“ die Option Dieses Paket löschen aus.

6. Lies die Bestätigungsmeldung, gib den Paketnamen ein, und wähle Ich verstehe die Folgen, dieses Paket löschen aus.

Informationen zum Überprüfen, wer ein Paket löschen kann, findest du unter Erforderliche Berechtigungen.

1. Navigiere auf zur Hauptseite deines persönlichen Kontos.

2. Klicke in der oberen rechten Ecke von auf dein Profilfoto und dann auf Dein Profil.

   

3. Wähle auf der Profilseite in der Kopfzeile die Registerkarte Pakete aus.

4. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

5. Wähle auf der Angebotsseite deines Pakets auf der rechten Seite die Option Paketeinstellungen aus.

   

6. Wähle unten auf der Seite unter „Gefahrenzone“ die Option Dieses Paket löschen aus.

7. Gib im Bestätigungsfeld den Namen des Pakets ein, um zu bestätigen, dass du es löschen möchtest.

8. Wähle Ich verstehe die Folgen, dieses Paket löschen aus.

Informationen zum Überprüfen, wer ein Paket löschen kann, findest du unter Erforderliche Berechtigungen.

1. Navigiere auf zur Hauptseite deiner Organisation.

2. Wähle unter dem Namen deiner Organisation die Registerkarte Pakete aus.

   

3. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

4. Wähle auf der Angebotsseite deines Pakets auf der rechten Seite die Option Paketeinstellungen aus.

   

5. Wähle unten auf der Seite unter „Gefahrenzone“ die Option Dieses Paket löschen aus.

6. Gib im Bestätigungsfeld den Namen des Pakets ein, um zu bestätigen, dass du es löschen möchtest.

7. Wähle Ich verstehe die Folgen, dieses Paket löschen aus.

Du kannst ein gelöschtes Paket oder eine Version wiederherstellen, wenn Folgendes zutrifft:

• Du stellst das Paket innerhalb von 30 Tagen nach dem Löschen wieder her.
• Derselbe Paketnamespace und die Version sind weiterhin verfügbar und werden nicht für ein neues Paket verwendet.

Wenn du beispielsweise der Benutzer octocat wärst und ein gelöschtes RubyGems-Paket namens my-package vorhanden wäre, das auf das Repository octocat/my-repo begrenzt war, kannst du das Paket nur wiederherstellen, wenn der Paketnamespace rubygem.pkg..com/octocat/my-repo/my-package noch verfügbar ist und noch nicht mehr als 30 Tage vergangen sind.

Zum Wiederherstellen eines gelöschten Pakets musst du auch eine der folgenden Berechtigungsanforderungen erfüllen:

• Für repositorybezogene Pakete: Du verfügst über Administratorberechtigungen für das Repository, in dem das gelöschte Paket veröffentlicht wird.
• Für benutzerkontobezogene Pakete: Das gelöschte Paket wird deinem persönlichen Konto zugeordnet.
• Für organisationsbezogene Pakete: Du verfügst über Administratorberechtigungen für das gelöschte Paket in der Organisation, der das Paket zugeordnet wird.

Weitere Informationen finden Sie unter Erforderliche Berechtigungen.

Sobald das Paket wiederhergestellt wurde, verwendet das Paket denselben Namespace, den es zuvor verwendet hat. Wenn derselbe Paketnamespace nicht verfügbar ist, kannst du dein Paket nicht wiederherstellen. In diesem Szenario musst du zum Wiederherstellen des gelöschten Pakets zuerst das neue Paket löschen, das den Namespace des gelöschten Pakets verwendet.

Du kannst ein gelöschtes Paket über deine Organisationskontoeinstellungen wiederherstellen, solange sich das Paket in einem Repository befand, das der Organisation gehörte, oder über granulare Berechtigungen verfügte und sich auf dein Organisationskonto bezog.

Informationen zum Überprüfen, wer ein Paket in einer Organisation wiederherstellen kann, findest du unter Erforderliche Berechtigungen.

1. Navigieren Sie auf zur Hauptseite der Organisation.

2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke auf der linken Seite auf Pakete.

4. Klicke unter „Gelöschte Pakete“ neben dem Paket, das du wiederherstellen möchtest, auf Wiederherstellen.

5. Gib zum Bestätigen den Paketnamen ein, und klicke auf Ich verstehe die Folgen, dieses Paket wiederherstellen.

Du kannst ein gelöschtes Paket über die Einstellungen deines persönlichen Kontos wiederherstellen, wenn sich das Paket in einem deiner Repositorys befand oder auf dein persönliches Konto bezogen war. Weitere Informationen finden Sie unter Erforderliche Berechtigungen.

1. Klicken Sie auf einer beliebigen Seite auf oben rechts auf Ihr Profilfoto und dann auf Einstellungen.
2. Klicke auf der linken Randleiste auf Pakete.
3. Klicke unter „Gelöschte Pakete“ neben dem Paket, das du wiederherstellen möchtest, auf Wiederherstellen.
4. Gib zum Bestätigen den Paketnamen ein, und klicke auf Ich verstehe die Folgen, dieses Paket wiederherstellen.

Sie können eine Paketversion auf der Landing Page Ihres Pakets wiederherstellen. Informationen zum Überprüfen, wer ein Paket wiederherstellen kann, findest du unter Erforderliche Berechtigungen.

1. Navigiere zur Startseite deines Pakets.

2. Suche nach dem Namen des Pakets, das du verwalten möchtest, und wähle es aus.

3. Wähle auf der Angebotsseite deines Pakets auf der rechten Seite die Option Paketeinstellungen aus.

   

4. Wähle in der Liste „Zuletzt verwendete Versionen“ die Option Alle Versionen anzeigen und verwalten aus.

   

5. Wähle in der rechten oberen Ecke der Liste der Paketversionen im Dropdownmenü Versionsansicht auswählen die Option Gelöscht aus.

   

6. Klicke neben der gelöschten Paketversion, die du wiederherstellen möchtest, auf Wiederherstellen.

7. Wähle zum Bestätigen Ich verstehe die Folgen, diese Version wiederherstellen aus.