Serviço de cópia de segurança e restauro

O script da amostra neste artigo mostra como fazer backup e restaurar a Gestão de API instância de serviço.

Nota

Para interagir com o Azure, recomenda-se o módulo Azure Az PowerShell. Consulte a instalação Azure PowerShell para começar. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Pode utilizar os Cloud Shell comandos pré-instalados para executar o código neste artigo, sem ter de instalar nada no ambiente local.

Para iniciar o Azure Cloud Shell:

Opção Exemplo/Ligação
Selecione Experimente-o no canto superior direito de um bloco de código ou de comando. Selecionar Tentar Não copia automaticamente o código ou o comando para Cloud Shell. Screenshot que mostra um exemplo de Try It for Azure Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. Screenshot que mostra como lançar Cloud Shell numa nova janela.
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure. Screenshot que mostra o botão de Cloud Shell no portal do Azure

Para utilizar o Cloud Shell Azure:

  1. Inicie o Cloud Shell.

  2. Selecione o botão Copiar num bloco de código (ou bloco de comando) para copiar o código ou o comando.

  3. Cole o código ou o comando na sessão de Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux, ou selecionando o Cmd+Shift+V no macOS.

  4. Selecione Entrar para executar o código ou comando.

Se optar por instalar e utilizar o PowerShell localmente, este tutorial requer a Azure PowerShell versão 1.0 ou posterior do módulo. Executar Get-Module -ListAvailable Az para localizar a versão. Se precisar de atualizar, veja Install Azure PowerShell module (Instalar o módulo do Azure PowerShell). Se estiver a executar localmente o PowerShell, também terá de executar o Connect-AzAccount para criar uma ligação com o Azure.

Script de exemplo

##########################################################
#  Script to backup and restore api management service.
###########################################################

$random = (New-Guid).ToString().Substring(0,8)

# Azure specific details
$subscriptionId = "my-azure-subscription-id"
 
# Api Management service specific details
$apiManagementName = "apim-$random"
$resourceGroupName = "apim-rg-$random"
$location = "Japan East"
$organisation = "Contoso"
$adminEmail = "admin@contoso.com"
 
# Storage Account details
$storageAccountName = "backup$random"
$containerName = "backups"
$backupName = $apiManagementName + "-apimbackup"
 
# Select default azure subscription
Select-AzSubscription -SubscriptionId $subscriptionId
 
# Create a Resource Group 
New-AzResourceGroup -Name $resourceGroupName -Location $location -Force
 
# Create storage account    
New-AzStorageAccount -StorageAccountName $storageAccountName -Location $location -ResourceGroupName $resourceGroupName -Type Standard_LRS
$storageKey = (Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -StorageAccountName $storageAccountName)[0].Value
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -StorageAccountKey $storageKey

# Create blob container
New-AzStorageContainer -Name $containerName -Context $storageContext -Permission blob
 
# Create API Management service
New-AzApiManagement -ResourceGroupName $resourceGroupName -Location $location -Name $apiManagementName -Organization $organisation -AdminEmail $adminEmail
 
# Backup API Management service.
Backup-AzApiManagement -ResourceGroupName $resourceGroupName -Name $apiManagementName -StorageContext $storageContext -TargetContainerName $containerName -TargetBlobName $backupName
 
# Restore API Management service
Restore-AzApiManagement -ResourceGroupName $resourceGroupName -Name $apiManagementName -StorageContext $storageContext -SourceContainerName $containerName -SourceBlobName $backupName

Limpar os recursos

Quando já não é necessário, pode utilizar o comando Remove-AzResourceGroup para remover o grupo de recursos e todos os recursos relacionados.

Remove-AzResourceGroup -Name myResourceGroup

Passos seguintes

Para obter mais informações sobre o módulo do Azure PowerShell, veja Documentação do Azure PowerShell.

Pode ver exemplos adicionais do Azure PowerShell para a Gestão de API do Azure nos Exemplos do PowerShell.