Freigeben über

Wiederherstellen eines gelöschten Wikis

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Wenn ein Benutzer versehentlich ein bereitgestelltes (Projekt) oder veröffentlichtes Wiki (Code) gelöscht hat, können Sie es wiederherstellen. Obwohl auf der Benutzeroberfläche keine Optionen zum Löschen eines Wikis vorhanden sind, können Benutzer die REST-API verwenden, um das dem Wiki zugeordnete Git-Repository zu löschen.

Anmerkung

Gelöschte Repositorys verbleiben 30 Tage im Papierkorb, danach werden sie endgültig gelöscht und können nicht wiederhergestellt werden.

Voraussetzungen

Kategorie Anforderungen
Projektzugriff Mitglied des Projekts, in dem sich das Wiki befindet. Wenn Sie keinen Zugriff haben, fordern Sie ihn von Ihrem Projektadministrator an. Jeder, der Zugriff auf das Teamprojekt hat, kann das Wiki einsehen, einschließlich den Projektbeteiligten.
Erlaubnisse - Um Wiki-Seiten hinzuzufügen oder zu bearbeiten: Mitglied der Contributors Gruppe.
- Um Code als Wiki zu veröffentlichen: Berechtigung Repository erstellen. Diese Berechtigung ist standardmäßig für Mitglieder der Gruppe Projektadministratorenfestgelegt.
Zugriffsebenen Mindestens Grundlegender Zugriff.

Wiederherstellen eines vollständigen Wikis

Wikis, sowohl Projekt als auch Code, werden als Repositorys in Ihrem Projekt in Azure DevOps gespeichert. Führen Sie die folgenden Schritte aus, um ein vollständiges Wiki mit REST-API wiederherzustellen.

  1. Git-Repositorys abrufen: Repositorys auflisten.

    Verwenden Sie den parameter includeHidden=true, um die Wiki-Repositorys anzuzeigen.

    GET https://dev.azure.com/christiechurch/fabrikamfiber/_apis/git/repositories?includeHidden=true&api-version=7.1-preview.1

            {
            "id": "978e3886-64a8-4b6f-96da-6afc2936b04b",
            "name": "fabrikamfiber.wiki",
            "url": https://dev.azure.com/christiechurch/052a83ac-af70-4194-b53f-df073e5f1786/_apis/git/repositories/978e3886-64a8-4b6f-96da-6afc2936b04b,
            "project": {
                "id": "052a83ac-af70-4194-b53f-df073e5f1786",
                "name": "fabrikamfiber",
                "url": https://dev.azure.com/christiechurch/_apis/projects/052a83ac-af70-4194-b53f-df073e5f1786,
                "state": "wellFormed",
                "revision": 421800049,
                "visibility": "organization",
                "lastUpdateTime": "2023-07-18T12:25:29.3Z"
            },
            "defaultBranch": "refs/heads/wikiMaster",
            "size": 193,
            "remoteUrl": https://christiechurch@dev.azure.com/christiechurch/fabrikamfiber/_git/fabrikamfiber.wiki,
            "sshUrl": git@ssh.dev.azure.com:v3/christiechurch/fabrikamfiber/fabrikamfiber.wiki,
            "webUrl": https://dev.azure.com/christiechurch/fabrikamfiber/_git/fabrikamfiber.wiki,
            "isDisabled": false,
            "isInMaintenance": false
        }

  2. Durchsuchen Sie den Papierkorb nach Ihrem Repository.

    GET https://dev.azure.com/christiechurch/fabrikamfiber/_apis/git/recycleBin/repositories?api-version=7.1-preview.1

    Wenn Sie Ihr Repository finden, das häufig als .wikibezeichnet wird, notieren Sie sich die Repository-ID.

    {
    "value": [
        {
            "id": "978e3886-64a8-4b6f-96da-6afc2936b04b",
            "name": "fabrikamfiber.wiki",
            "project": {
                "id": "052a83ac-af70-4194-b53f-df073e5f1786",
                "name": "fabrikamfiber",
                "url": https://dev.azure.com/christiechurch/_apis/projects/052a83ac-af70-4194-b53f-df073e5f1786,
                "state": "wellFormed",
                "revision": 421800049,
                "visibility": "organization",
                "lastUpdateTime": "2023-07-18T12:25:29.3Z"
            },
            "deletedBy": {
                "displayName": "Christie Church",
                "url": https://spsprodeus23.vssps.visualstudio.com/A1df9d653-bdfb-459b-a0c7-725052b2f944/_apis/Identities/0a0a4b55-9671-440d-87bf-26644f200d8a,
                "_links": {
                    "avatar": {
                        "href": https://dev.azure.com/christiechurch/_apis/GraphProfile/MemberAvatars/aad.MDY4MDk2OGQtYWU5OS03Y2M5LTgxZTEtNTBjMDk4ZTllZTlh
                    }
                },
                "id": "0a0a4b55-9671-440d-87bf-26644f200d8a",
                "uniqueName": christiechurch@fabrikam.com,
                "imageUrl": https://dev.azure.com/christiechurch/_api/_common/identityImage?id=0a0a4b55-9671-440d-87bf-26644f200d8a,
                "descriptor": "aad.MDY4MDk2OGQtYWU5OS03Y2M5LTgxZTEtNTBjMDk4ZTllZTlh"
            },
            "createdDate": "2023-07-18T12:23:55.64Z",
            "deletedDate": "2023-07-18T12:41:38.737Z"
        }
    ],
    "count": 1
}

  3. Wiederherstellen des Wikis aus dem Repository-Papierkorb.

    PATCH https://dev.azure.com/christiechurch/fabrikamfiber/_apis/git/recycleBin/repositories/978e3886-64a8-4b6f-96da-6afc2936b04b?api-version=7.1-preview.1

    {
    "deleted": false
}

Die Inhalte des Repositorys werden wiederhergestellt. Wenn die Wiki-Benutzeroberfläche nicht automatisch wieder angezeigt wird, veröffentlichen Sie das wiederhergestellte Repository als Wiki oder erstellen Sie ein Wiki über die Wiki-REST-API, um es erneut beim Projekt zu registrieren.

Wiederherstellen einer Wiki-Seite

  1. Navigieren Sie zur URL Ihres Repositorys: https://dev.azure.com/<OrgName>/<ProjectName>/_git/classicreleaseoption.wiki.

  2. Suchen Sie nach dem Verlauf für den Mainbranch wikiMain.

  3. Suchen Sie den Commit, der die gelöschten Dateien enthält, und wählen Sie ihn aus.

  4. Wählen Sie Weitere Aktionen und anschließend Zurücksetzen aus.

  5. Erstellen und Abschließen einer Pull-Anforderung.

Ihre Wiki-Seite wird wiederhergestellt.

Wiederherstellen einer Wiki-Seite mit CLI

Wenn Sie Befehlszeilenoptionen bevorzugen, führen Sie die folgenden Schritte aus.

  1. Klonen Sie das Wiki auf Ihrem lokalen Computer.
  2. Suchen Sie nach dem Commit, durch den die Seite gelöscht wurde.
  3. Überprüfen Sie den Commit.
  4. Kopieren Sie die Seite, um einen neuen Commit zu erstellen.

Ihre Wiki-Seite wird wiederhergestellt.

Löschen eines Repositorys

DELETE https://dev.azure.com/christiechurch/fabrikamfiber/_apis/git/repositories/052a83ac-af70-4194-b53f-df073e5f1786?api-version=7.1-preview.1

Erneutes Verknüpfen eines wiederhergestellten Wikis

Das Wiederherstellen aus dem Papierkorb stellt das Git-Repository (Wiki-Seiten und -Verlauf) wieder her, stellt jedoch nicht immer die Wiki-Registrierung oder die Dateinamenzuordnung in der Benutzeroberfläche erneut her.

Wenn das Wiki nach dem Wiederherstellen des Repositorys nicht angezeigt wird, haben Sie zwei Optionen:

Option 1: Erneutes Veröffentlichen über die Benutzeroberfläche

  1. Wechseln Sie zu "Übersichtswiki>" in Ihrem Projekt.
  2. Wenn kein Wiki angezeigt wird, wählen Sie "Code veröffentlichen" als Wiki aus.
  3. Wählen Sie das wiederhergestellte Repository und den Branch (in der Regel wikiMaster) aus.
  4. Geben Sie bei Bedarf einen Wiki-Namen und einen Ordnerpfad an.
  5. Wählen Sie Veröffentlichen aus.

Ausführliche Schritte finden Sie unter Veröffentlichen eines Git-Repositorys in einem Wiki.

Option 2: Erneutes Erstellen der Wiki-Registrierung mit REST-API

  1. Erstellen Sie ein neues Wiki mithilfe der Wikis – REST-API erstellen :

    POST https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis?api-version=7.1-preview.2

    Anforderungstext:

    {
    "type": "codeWiki",
    "name": "Fabrikam Fiber Wiki",
    "projectId": "052a83ac-af70-4194-b53f-df073e5f1786",
    "repositoryId": "978e3886-64a8-4b6f-96da-6afc2936b04b",
    "mappedPath": "/",
    "version": {
        "version": "wikiMaster"
    }
}

    Ersetzen Sie die folgenden Werte:

    • {organization}: Name Ihrer Azure DevOps-Organisation
    • {project}: Ihr Projektname oder Ihre ID
    • name: Anzeigename für das Wiki
    • projectId: Projekt-ID aus Schritt 2
    • repositoryId: Repository-ID aus Schritt 2
    • mappedPath: Stammordnerpfad (in der Regel /)
    • version: Verzweigungsname (in der Regel wikiMaster)

  2. Überprüfen Sie die Wiki-Registrierung, indem Sie Wikis mithilfe der Wikis – List REST-API auflisten:

    GET https://dev.azure.com/{organization}/{project}/_apis/wiki/wikis?api-version=7.1-preview.2

Überprüfung nach der Wiederherstellung

Nach der Verwendung einer der beiden Optionen:

  1. Vergewissern Sie sich, dass das Repository und die Verzweigungen in Ihrem Projekt in Repos vorhanden sind.
  2. Überprüfen Sie, ob das Wiki in Ihrem Projekt unter "Übersichtswiki>" angezeigt wird.
  3. Überprüfen Sie Berechtigungen, Links und alle Widgets, auf die auf das alte Wiki verwiesen wurde.

Anmerkung

  • Der Papierkorb und einige Wiki-Registrierungs-APIs befinden sich in der Vorschau und können sich ändern – testen Sie in einer Nichtproduktionsumgebung und verwenden Sie die für Ihre Umgebung dokumentierte API-Version.
  • Verwenden Sie type: "projectWiki" für Projektwikis (bereitgestellte Wikis) anstelle des "codeWiki" REST-API-Aufrufs, und lassen Sie die und repositoryId die mappedPath Eigenschaften weg.

Nächster Schritt

Hinzufügen und Bearbeiten von Wiki-Seiten

Verwandte Inhalte

  • Last updated on