Gerenciando o armazenamento nas nuvens independentes do Azure usando o PowerShell
A maioria das pessoas usa a Nuvem Pública do Azure para sua implantação global do Azure. Há também algumas implantações independentes do Microsoft Azure por razões de soberania e assim por diante. Essas implantações independentes são chamadas de "ambientes". A lista a seguir detalha as nuvens independentes atualmente disponíveis.
Nota
Recomendamos que utilize o módulo do Azure Az PowerShell para interagir com o Azure. Veja Instalar 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.
Usando uma nuvem independente
Para usar o Armazenamento do Azure em uma das nuvens independentes, conecte-se a essa nuvem em vez do Azure Public. Para usar uma das nuvens independentes em vez do Azure Public:
- Você especifica o ambiente ao qual se conectar.
- Você determina e usa as regiões disponíveis.
- Você usa o sufixo de ponto de extremidade correto, que é diferente do Azure Public.
Os exemplos exigem o módulo Az do Azure PowerShell versão 0.7 ou posterior. Em uma janela do PowerShell, execute Get-Module -ListAvailable Az para localizar a versão. Se nada estiver listado ou se você precisar atualizar, consulte Instalar o módulo do Azure PowerShell.
Iniciar sessão no Azure
Execute o cmdlet Get-AzEnvironment para ver os ambientes do Azure disponíveis:
Get-AzEnvironment
Inicie sessão na sua conta que tem acesso à nuvem à qual pretende ligar-se e defina o ambiente. Este exemplo mostra como entrar em uma conta que usa o Azure Government Cloud.
Connect-AzAccount -Environment AzureUSGovernment
Para acessar a China Cloud, use o ambiente AzureChinaCloud. Para acessar a nuvem alemã, use AzureGermanCloud.
Neste ponto, se você precisar da lista de locais para criar uma conta de armazenamento ou outro recurso, poderá consultar os locais disponíveis para a nuvem selecionada usando Get-AzLocation.
Get-AzLocation | select Location, DisplayName
A tabela a seguir mostra os locais retornados para a nuvem alemã.
| Localização | Nome a Apres. |
|---|---|
germanycentral |
Alemanha Central |
germanynortheast |
Nordeste da Alemanha |
Sufixo de ponto final
O sufixo de ponto de extremidade para cada um desses ambientes é diferente do ponto de extremidade Público do Azure. Por exemplo, o sufixo de ponto de extremidade de blob para o Azure Public é blob.core.windows.net. Para o Government Cloud, o sufixo do ponto de extremidade blob é blob.core.usgovcloudapi.net.
Obter ponto de extremidade usando Get-AzEnvironment
Recupere o sufixo do ponto de extremidade usando Get-AzEnvironment. O ponto de extremidade é a propriedade StorageEndpointSuffix do ambiente.
Os trechos de código a seguir mostram como recuperar o sufixo do ponto de extremidade. Todos esses comandos retornam algo como "core.cloudapp.net" ou "core.cloudapi.de", etc. Anexe o sufixo ao serviço de armazenamento para acessar esse serviço. Por exemplo, "queue.core.cloudapi.de" acessará o serviço de fila na nuvem alemã.
Esse trecho de código recupera todos os ambientes e o sufixo de ponto de extremidade de cada um.
Get-AzEnvironment | select Name, StorageEndpointSuffix
Este comando retorna os seguintes resultados.
| Nome | Sufixo StorageEndpointSuffix |
|---|---|
| AzureChinaCloud | core.chinacloudapi.cn |
| AzureCloud | core.windows.net |
| AzureGermanCloud | core.cloudapi.de |
| AzureUSGovernment | core.usgovcloudapi.net |
Para recuperar todas as propriedades do ambiente especificado, chame Get-AzEnvironment e especifique o nome da nuvem. Esse trecho de código retorna uma lista de propriedades; procure StorageEndpointSuffix na lista. O exemplo a seguir é para a nuvem alemã.
Get-AzEnvironment -Name AzureGermanCloud
Os resultados são semelhantes aos seguintes valores:
| Nome de Propriedade | valor |
|---|---|
| Nome | AzureGermanCloud |
| EnableAdfsAuthentication | False |
| ActiveDirectoryServiceEndpointResourceI | http://management.core.cloudapi.de/ |
| GaleriaURL | https://gallery.cloudapi.de/ |
| ManagementPortalUrl | https://portal.microsoftazure.de/ |
| ServiceManagementUrl | https://manage.core.cloudapi.de/ |
| PublishSettingsFileUrl | https://manage.microsoftazure.de/publishsettings/index |
| ResourceManagerUrl | http://management.microsoftazure.de/ |
| SqlDatabaseDnsSuffix | .database.cloudapi.de |
| Sufixo StorageEndpointSuffix | core.cloudapi.de |
| ... | ... |
Para recuperar apenas a propriedade do sufixo do ponto de extremidade de armazenamento, recupere a nuvem específica e peça apenas essa propriedade.
$environment = Get-AzEnvironment -Name AzureGermanCloud
Write-Host "Storage EndPoint Suffix = " $environment.StorageEndpointSuffix
Este comando retorna as seguintes informações:
Storage Endpoint Suffix = core.cloudapi.de
Obter endpoint de uma conta de armazenamento
Você também pode examinar as propriedades de uma conta de armazenamento para recuperar os pontos de extremidade:
# Get a reference to the storage account.
$resourceGroup = "myexistingresourcegroup"
$storageAccountName = "myexistingstorageaccount"
$storageAccount = Get-AzStorageAccount `
-ResourceGroupName $resourceGroup `
-Name $storageAccountName
# Output the endpoints.
Write-Host "blob endpoint = " $storageAccount.PrimaryEndPoints.Blob
Write-Host "file endpoint = " $storageAccount.PrimaryEndPoints.File
Write-Host "queue endpoint = " $storageAccount.PrimaryEndPoints.Queue
Write-Host "table endpoint = " $storageAccount.PrimaryEndPoints.Table
Para uma conta de armazenamento na Government Cloud, este comando retorna a seguinte saída:
blob endpoint = http://myexistingstorageaccount.blob.core.usgovcloudapi.net/
file endpoint = http://myexistingstorageaccount.file.core.usgovcloudapi.net/
queue endpoint = http://myexistingstorageaccount.queue.core.usgovcloudapi.net/
table endpoint = http://myexistingstorageaccount.table.core.usgovcloudapi.net/
Depois de definir o ambiente
Agora você pode usar o PowerShell para gerenciar suas contas de armazenamento e acessar dados de blob, fila, arquivo e tabela. Para obter mais informações, consulte Az.Storage.
Clean up resources (Limpar recursos)
Se você criou um novo grupo de recursos e uma conta de armazenamento para este exercício, poderá remover ambos os ativos excluindo o grupo de recursos. Eliminar o grupo de recursos elimina todos os recursos incluídos no grupo.
Remove-AzResourceGroup -Name $resourceGroup