Verschieben einer Azure Web PubSub-Ressource in eine andere Region

2023-06-01

Es gibt verschiedene Szenarios, in denen Sie Ihre vorhandene Web PubSub-Ressource aus einer Region in eine andere verschieben möchten. Die Azure Web PubSub-Ressource ist regionsspezifisch und kann nicht von einer Region in eine andere verschoben werden. Sie können jedoch eine Azure Resource Manager-Vorlage verwenden, um die vorhandene Konfiguration einer Azure Web PubSub-Ressource zu exportieren, die Parameter entsprechend der Zielregion zu ändern und dann eine Kopie Ihrer Web PubSub-Ressource in einer anderen Region zu erstellen. Weitere Informationen zu Resource Manager und Vorlagen finden Sie unter Schnellstart: Erstellen und Bereitstellen von Azure Resource Manager-Vorlagen über das Azure-Portal.

Voraussetzungen

Stellen Sie sicher, dass die verwendeten Dienste und Features in der Zielregion unterstützt werden.
Vergewissern Sie sich, dass Sie mit Ihrem Azure-Abonnement Web PubSub-Ressourcen in der verwendeten Zielregion erstellen können. Wenden Sie sich an den Support, um das erforderliche Kontingent zu aktivieren.
Stellen Sie für Previewfunktionen sicher, dass Ihr Abonnement für die Zielregion auf der Zulassungsliste steht.

Vorbereiten und Verschieben

Exportieren Sie zunächst eine Resource Manager-Vorlage und ändern Sie sie anschließend.

Exportieren der Vorlage und Bereitstellen im Portal

Mit den folgenden Schritten wird erläutert, wie Sie die Web PubSub-Ressource auf das Verschieben mithilfe einer Resource Manager-Vorlage vorbereiten und sie dann mit dem Portal in die Zielregion verschieben.

Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ressourcengruppen.
Wechseln Sie zur Ressourcengruppe, die die Web PubSub-Quellressource enthält, und klicken Sie darauf.
Wählen Sie >Automation>Vorlage exportieren aus.
Wählen Sie Bereitstellen auf dem Blatt Vorlage exportieren aus.
Klicken Sie auf VORLAGE>Parameter bearbeiten, um die Datei parameters.json im Online-Editor zu öffnen.

Um den Parameter für den Namen der Web PubSub-Ressource zu bearbeiten, ändern Sie unter parameters die Eigenschaft value:

      {
        "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
        "contentVersion": "1.0.0.0",
        "parameters": {
          "webpubsub_myWebPubSub_name": {
            "value": "<target-webpubsub-name>"
          }
        }
      }

Ändern Sie den für die Web PubSub-Zielressource angegebenen Namen im Editor in einen Namen Ihrer Wahl. Stellen Sie sicher, dass Sie den Namen in Anführungszeichen einschließen.
Klicken Sie im Editor auf Speichern.
Klicken Sie auf VORLAGE>Parameter bearbeiten, um die Datei parameters.json im Online-Editor zu öffnen.

Zum Bearbeiten der Zielregion ändern Sie im Online-Editor unter resources die Eigenschaft location:

    "resources": [
      {
        "type": "Microsoft.SignalRService/webPubSub",
        "apiVersion": "2021-10-01",
        "name": "[parameters('webpubsub_myWebPubSub_name')]",
        "location": "<target-region>",
        "properties": {
        }
      }
    ]

Informationen zum Abrufen von Regionsstandortcodes finden Sie unter Verfügbare Produkte nach Region. Der Code für eine Region ist der Regionsname ohne Leerzeichen, USA, Mitte = centralus.
Sie können wahlweise auch andere Parameter in der Vorlage ändern, die abhängig von Ihren Anforderungen optional sind.
Klicken Sie im Online-Editor auf Speichern.
Klicken Sie auf GRUNDEINSTELLUNGEN>Abonnement, um das Abonnement auszuwählen, in dem die Zielressource bereitgestellt wird.
Klicken Sie auf GRUNDEINSTELLUNGEN>Ressourcengruppe, um die Ressourcengruppe auszuwählen, in der die Zielressource bereitgestellt wird. Sie können auf Neu erstellen klicken, um eine neue Ressourcengruppe für die Zielressource zu erstellen. Stellen Sie sicher, dass der Name nicht mit dem Namen der Quellressourcengruppe der vorhandenen Ressource übereinstimmt.
Vergewissern Sie sich, dass GRUNDEINSTELLUNGEN>Standort auf den Zielstandort festgelegt ist, an dem die Ressource bereitgestellt werden soll.
Klicken Sie auf die Schaltfläche Überprüfen und erstellen, um die Azure Web PubSub-Zielressource bereitzustellen.

Exportieren der Vorlage und Bereitstellen mithilfe von Azure PowerShell

So exportieren Sie eine Vorlage mithilfe von PowerShell

Melden Sie sich mit dem Befehl Connect-AzAccount bei Ihrem Azure-Abonnement an, und befolgen Sie die Anweisungen auf dem Bildschirm:
```
Connect-AzAccount
```
Wenn Ihre Identität mehreren Abonnements zugeordnet ist, legen Sie das aktive Abonnement auf das Abonnement der Web PubSub-Ressource fest, die Sie verschieben möchten.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```

Exportieren Sie die Vorlage Ihrer Web PubSub-Quellressource. Diese Befehle speichern eine JSON-Vorlage in Ihrem aktuellen Verzeichnis.

$resource = Get-AzResource `
   -ResourceGroupName <resource-group-name> `
   -ResourceName <webpubsub-resource-name> `
   -ResourceType Microsoft.SignalRService/WebPubSub
Export-AzResourceGroup `
   -ResourceGroupName <resource-group-name> `
   -Resource $resource.ResourceId `
   -IncludeParameterDefaultValue

Die heruntergeladene Datei wird nach der Ressourcengruppe benannt, aus der die Ressource exportiert wurde. Suchen Sie die Datei <resource-group-name>.json, die mit dem Befehl exportiert wurde, und öffnen Sie diese in einem Editor Ihrer Wahl:
```
notepad <source-resource-group-name>.json
```

Um den Parameter für den Namen der Web PubSub-Ressource zu bearbeiten, ändern Sie die Eigenschaft defaultValue des Namens der Web PubSub-Quellressource in den Namen Ihrer Web PubSub-Zielressource, wobei Sie den Namen in Anführungszeichen einschließen müssen:

  {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
      "webPubSub_myWebPubSub_name": {
      "defaultValue": "<target-webpubsub-name>",
        "type": "String"
      }
    }
  }

Ändern Sie die Eigenschaft location unter „resources“, um die Zielregion zu bearbeiten, in die die Web PubSub-Ressource verschoben wird:

    "resources": [
      {
        "type": "Microsoft.SignalRService/WebPubSub",
        "apiVersion": "2021-10-01",
        "name": "[parameters('webPubSub_myWebPubSub_name')]",
        "location": "<target-region>",
        "properties": {
        }
      }
    ]

Informationen zum Abrufen von Regionsstandortcodes finden Sie unter Verfügbare Produkte nach Region. Der Code für eine Region ist der Regionsname ohne Leerzeichen, USA, Mitte = centralus.
Sie können wahlweise auch andere Parameter in der Vorlage ändern, die abhängig von Ihren Anforderungen optional sind.
Speichern Sie die Datei <resource-group-name>.json.
Erstellen Sie mithilfe von New-AzResourceGroup eine Ressourcengruppe in der Zielregion für die Web PubSub-Zielressource, die bereitgestellt werden soll.
```
New-AzResourceGroup -Name <target-resource-group-name> -location <target-region>
```
Stellen Sie die bearbeitete Datei <resource-group-name>.json mit New-AzResourceGroupDeployment in der im vorherigen Schritt erstellten Ressourcengruppe bereit:
```
New-AzResourceGroupDeployment -ResourceGroupName <target-resource-group-name> -TemplateFile <source-resource-group-name>.json
```

Um zu überprüfen, ob die Ressourcen in der Zielregion erstellt wurden, verwenden Sie Get-AzResourceGroup und Get-AzWebPubSub:

Get-AzResourceGroup -Name <target-resource-group-name>

Get-AzWebPubSub -Name <target-webpubsub-name> -ResourceGroupName <target-resource-group-name>

Verwerfen

Wenn Sie nach der Bereitstellung neu starten oder die Web PubSub-Ressource im Ziel verwerfen möchten, löschen Sie die im Ziel erstellte Ressourcengruppe. Die verschobene Web PubSub-Ressource wird dann gelöscht. Wählen Sie hierzu im Portal die Ressourcengruppe im Dashboard aus, und klicken Sie oben auf der Übersichtsseite auf Löschen. Alternativ können Sie Remove-AzResourceGroup verwenden:

Remove-AzResourceGroup -Name <target-resource-group-name>

Bereinigen

Um die Änderungen zu committen und die Verschiebung der Web PubSub-Ressource abzuschließen, löschen Sie die Web PubSub-Quellressource oder -Ressourcengruppe. Wählen Sie hierzu die Web PubSub-Ressource oder -Ressourcengruppe auf dem Dashboard im Portal aus, und klicken Sie oben auf jeder Seite auf Löschen.

Nächste Schritte

In diesem Tutorial haben Sie eine Azure Web PubSub-Ressource aus einer Region in eine andere verschoben und die Quellressourcen bereinigt. Weitere Informationen zum Verschieben von Ressourcen zwischen Regionen und zur Notfallwiederherstellung in Azure finden Sie unter: