Obter informações de configuração da conta de armazenamento

Artigo
03/10/2023

Este artigo mostra como obter as informações e as propriedades de configuração de uma conta de armazenamento do Azure usando o portal do Azure, o PowerShell ou a CLI do Azure.

Obter a ID do recurso para uma conta de armazenamento

Para cada recurso do Azure Resource Manager há uma ID do recurso associada que o identifica de maneira exclusiva. Determinadas operações exigem que você forneça a ID do recurso. Você pode obter a ID do recurso de uma conta de armazenamento usando o portal do Azure, o PowerShell ou a CLI do Azure.

Para exibir a ID do recurso do Azure Resource Manager para uma conta de armazenamento no portal do Azure, siga estas etapas:

Navegue até sua conta de armazenamento no portal do Azure.
Na página Visão Geral, na seção Essentials, selecione o link Exibição JSON.
A ID do recurso referente à conta de armazenamento é exibida na parte superior da página.

Para retornar a ID do recurso do Azure Resource Manager para uma conta de armazenamento com o PowerShell, verifique se você tem instalado o módulo Az.Storage. Em seguida, chame o comando Get-AzStorageAccount para retornar a conta de armazenamento e obter a ID de recurso dela:

(Get-AzStorageAccount -ResourceGroupName <resource-group> -Name <storage-account>).Id

Para retornar a ID do recurso do Azure Resource Manager para uma conta de armazenamento com a CLI do Azure, chame o comando az storage account show e consulte a ID do recurso:

az storage account show \
    --name <storage-account> \
    --resource-group <resource-group> \
    --query id \
    --output tsv

Você também pode obter a ID do recurso para uma conta de armazenamento chamando a operação Contas de Armazenamento – Obter Propriedades na API REST.

Para obter mais informações sobre os tipos de recursos gerenciados pelo Azure Resource Manager, confira Provedores de recursos e tipos de recursos.

Obter o tipo de conta, a localização ou o SKU de replicação para uma conta de armazenamento

O tipo de conta, a localização e o SKU de replicação são algumas das propriedades disponíveis em uma conta de armazenamento. É possível usar o portal do Azure, o PowerShell ou a CLI do Azure para ver esses valores.

Para ver o tipo de conta, a localização ou o SKU de replicação de uma conta de armazenamento no portal do Azure, siga estas etapas:

Navegue até sua conta de armazenamento no portal do Azure.
Localize essas propriedades na página Visão Geral, na seção Essentials

Para exibir o tipo de conta, a localização ou o SKU de replicação de uma conta de armazenamento com o PowerShell, chame o comando Get-AzStorageAccount para retornar a conta de armazenamento e verifique as propriedades:

$account = Get-AzStorageAccount -ResourceGroupName <resource-group> -Name <storage-account>
$account.Location
$account.Sku
$account.Kind

Para ver o tipo de conta, a localização ou o SKU de replicação de uma conta de armazenamento com o PowerShell, chame o comando az storage account show e consulte as propriedades:

az storage account show \
    --name <storage-account> \
    --resource-group <resource-group> \
    --query '[location,sku,kind]' \
    --output tsv

Obter pontos de extremidade de serviço para a conta de armazenamento

Os pontos de extremidade de serviço para uma conta de armazenamento fornecem a URL base para qualquer objeto de blob, fila, tabela ou arquivo no Armazenamento do Azure. Use essa URL base para construir o endereço de qualquer recurso determinado.

Para obter os pontos de extremidade de serviço de uma conta de armazenamento no portal do Azure, siga estas etapas:

Navegue até sua conta de armazenamento no portal do Azure.
Na seção Configurações, localize a configuração de Pontos de Extremidade.
Na página Pontos de Extremidade, será exibido o ponto de extremidade de serviço para cada serviço de Armazenamento do Azure, bem como a ID do recurso.

Se a conta de armazenamento for replicada geograficamente, os pontos de extremidade secundários também aparecerão nesta página.

Para obter os pontos de extremidade de serviço de uma conta de armazenamento com o PowerShell, chame Get-AzStorageAccount e retorne a propriedade PrimaryEndpoints. Se a conta de armazenamento for replicada geograficamente, a propriedade SecondaryEndpoints retornará os pontos de extremidade secundários.

(Get-AzStorageAccount -ResourceGroupName $rgName -Name $accountName).PrimaryEndpoints
(Get-AzStorageAccount -ResourceGroupName $rgName -Name $accountName).SecondaryEndpoints

Para obter os pontos de extremidade de serviço de uma conta de armazenamento com a CLI do Azure, chame az storage account show e retorne a propriedade primaryEndpoints. Se a conta de armazenamento for replicada geograficamente, a propriedade secondaryEndpoints retornará os pontos de extremidade secundários.

az storage account show \
    --resource-group <resource-group> \
    --name <account-name> \
    --query '[primaryEndpoints, secondaryEndpoints]'

Obter uma cadeia de conexão para a conta de armazenamento

Você pode usar uma cadeia de conexão para autorizar o acesso ao Armazenamento do Microsoft Azure com as chaves de acesso da conta (autorização de Chave Compartilhada). Para saber mais sobre cadeias de conexão, confira Configurar cadeia de conexão do Armazenamento do Azure.

Importante

Suas chaves de conta de armazenamento são semelhantes para a senha raiz da sua conta de armazenamento. Sempre tenha cuidado para proteger as suas chaves de acesso. Utilize o Azure Key Vault para gerenciar e girar suas chaves com segurança. Evite distribuir chaves de acesso para outros usuários, fazer hard-coding com elas ou salvá-las em qualquer lugar em texto sem formatação que seja acessível a outras pessoas. Gire suas chaves se você acredita que elas podem ter sido comprometidas.

A Microsoft recomenda usar o Microsoft Entra ID para autorizar solicitações em dados de blob, arquivo e fila, se possível, em vez de usar as chaves de conta (autorização de Chave Compartilhada). A autorização com o Microsoft Entra ID fornece segurança superior e facilidade de uso em relação à autorização da chave compartilhada. Para obter mais informações, consulte Autorizar o acesso a dados no Armazenamento do Microsoft Azure ou Autorizar o acesso a dados de arquivo no portal do Azure.

Para obter uma cadeia de conexão no portal do Azure, siga estas etapas:

Navegue até sua conta de armazenamento no portal do Azure.
Na seção Segurança + rede, localize a configuração de chaves de acesso.
Para exibir as chaves da conta e as cadeias de conexão associadas, selecione o botão Mostrar chaves na parte superior da página.
Para copiar uma cadeia de conexão para a área de transferência, selecione o botão Copiar à direita da cadeia de conexão.

Para obter uma cadeia de conexão com o PowerShell, obtenha primeiro um objeto StorageAccountContext e recupere a propriedade ConnectionString.

$rgName = "<resource-group>"
$accountName = "storagesamplesdnszone2"

(Get-AzStorageAccount -ResourceGroupName <resource-group> -Name <storage-account>).Context.ConnectionString

Para obter a cadeia de conexão com a CLI do Azure, chame o comando az storage account show-connection-string.

az storage account show-connection-string --resource-group <resource-group> --name <storage-account>

Obter o tempo de criação das chaves de acesso da conta para uma conta de armazenamento

Se a propriedade keyCreationTime de uma ou ambas as chaves de acesso da conta para uma conta de armazenamento for nula, você precisará girar as chaves antes de configurar uma política de expiração de chave ou uma política de expiração de SAS. Verifique a chaveCreationTime para uma conta de armazenamento usando o portal do Azure, o PowerShell ou a CLI do Azure.

Para exibir a hora de criação das chaves de acesso da conta para uma conta de armazenamento no portal do Azure, siga estas etapas:

Navegue até sua conta de armazenamento no portal do Azure.
Na página Visão Geral, na seção Essentials, selecione o link Exibição JSON.
Na página JSON do recurso, selecione a versão mais recente da API.
No JSON em propriedades, você visualizará keyCreationTime para key1 e key2.

Para retornar o tempo de criação das chaves de acesso da conta para uma conta de armazenamento com o PowerShell, verifique se você instalou o módulo Az.Storage. Em seguida, chame o comando Get-AzStorageAccount para obter a propriedade keyCreationTime, que inclui o tempo de criação para ambas as chaves. No código de exemplo abaixo, obtemos o keyCreationTime para ambas as chaves e testamos se cada valor é nulo:

$rgName      = <resource-group>
$accountName = <storage-account>

# Get the keyCreationTime property of the storage account
$keyCreationTime = (Get-AzStorageAccount -ResourceGroupName $rgName -Name $accountName).keyCreationTime
# Display the value for both keys
$keyCreationTime
# Check both properties for null values
Write-Host 'keyCreationTime.key1 is null = ' ($keyCreationTime.key1 -eq $null)
Write-Host 'keyCreationTime.key2 is null = ' ($keyCreationTime.key2 -eq $null)

Para retornar o tempo de criação das chaves de acesso da conta para uma conta de armazenamento com a CLI do Azure, chame o comando az storage account show e consulte keyCreationTime:

az storage account show \
    --name <storage-account> \
    --resource-group <resource-group> \
    --query keyCreationTime

Você também pode obter o keyCreationTime para uma conta de armazenamento chamando a operação Contas de Armazenamento – Obter Propriedades na API REST.