Freigeben über

API-Verwaltung – weiches Löschen

GILT FÜR: Alle API Management-Ebenen

Mit dem Soft-Delete der API-Verwaltung können Sie eine kürzlich gelöschte API-Verwaltungsinstanz wiederherstellen. Dieses Feature schützt vor versehentlichem Löschen Ihrer API-Verwaltungsinstanz.

Unterstützende Schnittstellen

Sie können eine vorläufig gelöschte Instanz über REST API-Version 2020-06-01-preview oder höher, Azure CLI oder das Azure SDK für .NET, Go oder Python wiederherstellen und andere Vorgänge auf dieser Instanz ausführen.

Tipp

Operation Description API-Verwaltungsnamespace Mindest-API-Version
Erstellen oder Aktualisieren Erstellt oder aktualisiert einen API Management-Dienst. API Management-Dienst Beliebig
Erstellen oder Aktualisieren, wobei die restore-Eigenschaft auf true festgelegt ist. Stellt einen API Management-Dienst wieder her, wenn er vorläufig gelöscht wurde Wenn restore angegeben und auf true festgelegt ist, werden alle anderen Eigenschaften ignoriert. API Management-Dienst 2020-06-01-preview
Löschen Löscht einen vorhandenen API Management-Dienst. API Management-Dienst 2020-06-01-preview
Nach Name abrufen Einen vorläufig gelöschten API Management-Dienst über den Namen abrufen. Gelöschte Dienste 2020-06-01-preview
Nach Abonnement auflisten Listet alle vorläufig gelöschten Dienste auf, die für das Aufheben der Löschung für das angegebene Abonnement verfügbar sind. Gelöschte Dienste 2020-06-01-preview
Säubern Löscht den API-Verwaltungsdienst (löscht ihn dauerhaft ohne Option zum Rückgängigmachen). Gelöschte Dienste 2020-06-01-preview

Verhalten des vorläufigen Löschens

Sie können jede API-Version verwenden, um Ihre API-Verwaltungsinstanz zu erstellen. Wenn Sie das Azure-Portal, die Azure REST-API oder ein anderes Azure-Tool mit API-Version 2020-06-01-preview oder höher verwenden, um eine API-Verwaltungsinstanz zu löschen, wird die Instanz automatisch vorläufig gelöscht.

Wenn Sie eine API-Verwaltungsinstanz vorläufig löschen, wechselt der Dienst in einen gelöschten Zustand und kann nicht auf normale API-Verwaltungsvorgänge zugreifen.

Im Zustand "Vorläufig gelöscht":

  • Sie können nur die API-Verwaltungsinstanz auflisten, wiederherstellen oder löschen (endgültig löschen).
  • Azure plant die dauerhafte Löschung der zugrunde liegenden Daten für die API-Verwaltungsinstanz nach dem vordefinierten Aufbewahrungszeitraum von 48 Stunden.
  • Sie können den Namen der API-Verwaltungsinstanz nicht wiederverwenden.

Wenn Sie Ihre API-Verwaltungsinstanz nicht innerhalb von 48 Stunden wiederherstellen oder löschen, wird die Instanz endgültig gelöscht.

Gelöschte API-Verwaltungsinstanzen auflisten

Sie können überprüfen, ob eine vorläufig gelöschte API Management-Instanz zum Wiederherstellen verfügbar ist, indem Sie die Vorgänge Get By Name (Nach Name abrufen) oder List By Subscription (Nach Abonnement auflisten) des Features „Deleted Services“ („Gelöschte Dienste“) verwenden.

Abrufen einer vorläufig gelöschten Instanz über den Namen

Verwenden Sie den API Management Vorgang Get By Name, ersetzen Sie {subscriptionId}, {location} und {serviceName} mit Ihrem Azure-Abonnement, dem Namen des Ressourcenspeicherorts und dem API Management Instanznamen.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/locations/{location}/deletedservices/{serviceName}?api-version=2024-05-01

Wenn die API Management-Instanz zur Wiederherstellung verfügbar ist, gibt Azure einen Datensatz der Instanz zurück, der ihr deletionDate und scheduledPurgeDate zeigt. Die REST-API gibt zum Beispiel eine Ausgabe ähnlich der folgenden zurück:

{
    "id": "subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/providers/Microsoft.ApiManagement/locations/southcentralus/deletedservices/apimtest",
    "name": "apimtest",
    "type": "Microsoft.ApiManagement/deletedservices",
    "location": "South Central US",
    "properties": {
        "serviceId": "/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/resourceGroups/apimtestgroup/providers/Microsoft.ApiManagement/service/apimtest",
        "scheduledPurgeDate": "2024-11-26T19:40:26.3596893Z",
        "deletionDate": "2024-11-24T19:40:50.1013572Z"
    }
}

Auflisten aller vorläufig gelöschten Instanzen für ein bestimmtes Abonnement

Verwenden Sie die API Management List By Subscription-Operation, wobei {subscriptionId} durch Ihre Abonnement-ID ersetzt wird:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/deletedservices?api-version=2024-05-01

Dieser Befehl gibt eine Liste aller vorläufig gelöschten Dienste zurück, die Sie unter dem angegebenen Abonnement rückgängigmachen können. Es zeigt die deletionDate und scheduledPurgeDate für jeden Dienst an.

Wiederherstellen einer vorläufig gelöschten Instanz

Verwenden Sie die API Management-Operation Create Or Update, indem Sie {subscriptionId}, {resourceGroup} und {apimServiceName} mit Ihrem Azure-Abonnement, Ressourcengruppennamen und API Management-Namen ersetzen:

PUT
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.ApiManagement/service/{apimServiceName}?api-version=2024-05-01

Legen Sie im Anforderungstext die Eigenschaft restore auf true. (Wenn dieses Flag angegeben und auf "true" festgelegt ist, werden alle anderen Eigenschaften ignoriert.) Zum Beispiel:

{
  "properties": {
    "publisherEmail": "help@contoso.com",
    "publisherName": "Contoso",
    "restore": true
  },
  "sku": {
    "name": "Developer",
    "capacity": 1
  },
  "location": "South Central US"
}

Löschen einer vorläufig gelöschten Instanz

Hinweis

Um eine vorläufig gelöschte Instanz endgültig zu löschen, müssen Sie zusätzlich zur Zugriffsberechtigung „Mitwirkender“ für die API Management-Instanz über die folgenden Berechtigungen der rollenbasierten Zugriffssteuerung (RBAC) im Abonnementbereich verfügen: Microsoft.ApiManagement/locations/deletedservices/delete, Microsoft.ApiManagement/deletedservices/read.

Verwenden Sie die Purge-Operation der API-Verwaltung, indem Sie {subscriptionId}, {location}, und {serviceName} durch Ihr Azure-Abonnement, den Ressourcenspeicherort und den API-Verwaltungsnamen ersetzen.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/locations/{location}/deletedservices/{serviceName}?api-version=2024-05-01

Dieser Befehl löscht Ihre API-Verwaltungsinstanz endgültig aus Azure.

Wiederverwendung des Namens einer API-Verwaltungsinstanz nach deren Löschung

Sie können den Namen einer API-Verwaltungsinstanz in einer neuen Bereitstellung wiederverwenden:

  • Nachdem die Instanz endgültig aus Azure gelöscht (gelöscht) wurde.

  • Im selben Abonnement wie die ursprüngliche Instanz.

Sie können den Namen einer API-Verwaltungsinstanz nicht in einer neuen Bereitstellung wiederverwenden:

  • Während des vorläufigen Löschens einer Instanz

  • In einem anderen Abonnement als dem, das zum Bereitstellen der ursprünglichen Instanz verwendet wird, auch nachdem die ursprüngliche Instanz endgültig aus Azure gelöscht (gelöscht) wurde. Diese Einschränkung gilt, ob sich das neue Abonnement im selben oder einem anderen Microsoft Entra-Mandanten befindet. Die Einschränkung gilt für mehrere Tage oder länger nach dem Löschen, je nach Abonnementtyp.

    Diese Einschränkung besteht, da Azure den Diensthostnamen für einen Reservierungszeitraum für einen Kundenmandanten reserviert, um die Bedrohung einer Subdomänenübernahme mit schwebenden DNS-Einträgen (Domain Name System) zu verhindern. Weitere Informationen finden Sie unter Verhindern, dass DNS-Einträge ins Leere laufen, und vermeiden Sie die Subdomain-Übernahme. Informationen zum Anzeigen aller verwaisten DNS-Einträge für Abonnements in einem Microsoft Entra-Mandanten finden Sie unter Erkennen verwaister DNS-Einträge.

Verwandte Inhalte

Erfahren Sie mehr über langfristige SICHERUNGS- und Wiederherstellungsoptionen für die API-Verwaltung:

  • Last updated on