Sdílet prostřednictvím

Měkké odstranění v API Management

PLATÍ PRO: Všechny úrovně služby správy rozhraní API

Pomocí zmírněného odstranění (soft-delete) v API Management můžete získat zpět a obnovit nedávno odstraněnou instanci. Tato funkce chrání před náhodným odstraněním vaší instance služby API Management.

Podpůrná rozhraní

Obnovení a další operace s měkce smazanou instancí můžete provést prostřednictvím verze REST API nebo novější, Azure CLI nebo Azure SDK pro .NET, Go nebo Python.

Návod

Operation Description Názvový prostor služby API Management Minimální verze rozhraní API
Vytvoření nebo aktualizace Vytvoří nebo aktualizuje službu API Management. Služba API Management Jakýkoliv
Vytvořit nebo aktualizovat s vlastností nastavenou restore na true Obnoví službu API Management, pokud byla dříve měkce smazána. Pokud restore je zadána a nastavena na true, všechny ostatní vlastnosti jsou ignorovány. Služba API Management 2020-06-01-preview
Vymazat Odstraní existující službu API Management. Služba API Management 2020-06-01-preview
Získat podle názvu Získejte službu API Management, která byla měkce odstraněna, podle názvu. Odstraněné služby 2020-06-01-preview
Seznam podle předplatného Zobrazí seznam všech obnovitelně odstraněných služeb, které jsou pro dané předplatné k dispozici pro obnovení. Odstraněné služby 2020-06-01-preview
Čistka Vyprázdní službu API Management (trvale ji odstraní bez možnosti zrušení odstranění). Odstraněné služby 2020-06-01-preview

Chování měkkého odstranění

K vytvoření instance služby API Management můžete použít libovolnou verzi rozhraní API. Při použití webu Azure Portal, rozhraní Azure REST API nebo jiného nástroje Azure s verzí 2020-06-01-preview rozhraní API nebo novějším k odstranění instance služby API Management se instance automaticky automaticky odstraní.

Při obnovitelném odstranění instance služby API Management služba přejde do odstraněného stavu a stane se nepřístupnou normálním operacím služby API Management.

Ve stavu obnovitelného odstranění:

  • Instanci služby API Management můžete vypsat, obnovit nebo vyprázdnit (trvale odstranit).
  • Azure naplánuje trvalé odstranění podkladových dat pro instanci služby API Management po předem určené 48hodinové době uchovávání.
  • Nemůžete znovu použít název instance služby API Management.

Pokud instanci služby API Management neobnovíte nebo vyprázdníte do 48 hodin, instance se trvale odstraní.

Výpis odstraněných instancí služby API Management

Pomocí operací Deleted Services Get By Name nebo operace List By Subscription můžete ověřit, že je dostupná k obnovení měkkě odstraněná instance API Management.

Získání dočasně smazané instance podle názvu

Použijte operaci Získání podle názvu služby API Management, nahraďte {subscriptionId}, {location}, a {serviceName} předplatným Azure, názvem umístění prostředku, a názvem instance služby API Management:

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

Pokud je instance API Management k dispozici pro obnovení, Azure vrátí záznam instance, která zobrazuje její deletionDate a scheduledPurgeDate. Rozhraní REST API například vrátí výstup podobný tomuto:

{
    "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"
    }
}

Výpis všech dočasně smazaných instancí pro dané předplatné

Použijte operaci API Management List By Subscription (Seznam podle předplatného) a nahraďte {subscriptionId} ID předplatného.

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

Tento příkaz vrátí seznam všech obnovitelně odstraněných služeb, které můžete v rámci daného předplatného zrušit. Zobrazuje deletionDate a scheduledPurgeDate pro každou službu.

Obnovení dočasně smazané instance

Použijte operaci Vytvoření nebo aktualizace v rámci služby API Management a nahraďte {subscriptionId}, {resourceGroup}, a {apimServiceName} vaším předplatným Azure, názvem skupiny prostředků a názvem služby API Management.

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

V textu požadavku nastavte restore vlastnost na true. (Pokud je tento příznak zadán a nastaven na true, všechny ostatní vlastnosti jsou ignorovány.) Například:

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

Trvale odstranit měkkým způsobem smazanou instanci

Poznámka:

Pokud chcete trvale odstranit instanci smazanou s možností obnovení, musíte mít kromě přístupu typu Contributor k instanci Azure API Management také následující oprávnění řízení přístupu na základě role (RBAC): Microsoft.ApiManagement/locations/deletedservices/delete, Microsoft.ApiManagement/deletedservices/read.

Použijte operaci Purge služby API Management, nahraďte {subscriptionId}, {location} a {serviceName} vaším předplatným Azure, umístěním prostředků a názvem služby API Management.

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

Tento příkaz trvale odstraní instanci služby API Management z Azure.

Opakované použití názvu instance služby API Management po odstranění

Název instance služby API Management můžete znovu použít v novém nasazení:

  • Po trvalém odstranění instance (vyprázdnění) z Azure

  • Ve stejném předplatném jako původní instance.

V novém nasazení nemůžete znovu použít název instance služby API Management:

  • Pokud je instance soft smazána.

  • V jiném předplatném než v předplatném použitém k nasazení původní instance, i když se původní instance trvale odstraní (vyprázdní) z Azure. Toto omezení platí bez ohledu na to, jestli je nové předplatné ve stejném nebo jiném tenantovi Microsoft Entra. Omezení platí po dobu několika dnů nebo déle po odstranění v závislosti na typu předplatného.

    Toto omezení existuje, protože Azure si vyhrazuje název hostitele služby pro tenanta zákazníka po dobu rezervace, aby se zabránilo hrozbě převzetí subdomény pomocí položek systému DNS (Dangling Domain Name System). Další informace najdete v tématu Zabránění překrývání položek DNS a zabránění převzetí subdomény. Chcete-li zobrazit všechny neplatné položky DNS pro předplatná na tenantu Microsoft Entra, viz Identifikace neplatných položek DNS.

Související obsah

Další informace o dlouhodobých možnostech zálohování a obnovení služby API Management:

  • Last updated on