Modificar um compartilhamento de arquivos do Azure

✔️ Aplica-se a: compartilhamentos de arquivos SMB e NFS clássicos criados com o provedor de recursos Microsoft.Storage

✔️ Aplica-se a: Compartilhamentos de arquivos criados com o provedor de recursos Microsoft.FileShares

Este artigo explica como ajustar as características de tamanho, custo e desempenho de Arquivos do Azure compartilhamentos de arquivos usando o portal Azure, Azure PowerShell e CLI do Azure. Os procedimentos diferem para compartilhamentos de arquivos clássicos, que usam o provedor de recursos Microsoft.Storage, em comparação com os compartilhamentos de arquivos criados com o Microsoft.FileShares.

Alterar as características de custo e desempenho de um compartilhamento de arquivo clássico

Depois de criar seu compartilhamento de arquivos clássico, talvez seja necessário ajustar o provisionamento (modelos provisionados) ou a camada de acesso (modelo pago conforme o uso) do compartilhamento. As seções a seguir mostram como ajustar as propriedades relevantes para o seu compartilhamento.

Modelo de cobrança v2 provisionado

Depois de criar o compartilhamento de arquivo clássico v2 provisionado, você pode alterar uma ou todas as três quantidades provisionadas do compartilhamento de arquivos. Você pode aumentar ou reduzir dinamicamente a quantidade de armazenamento, IOPS e throughput provisionados à medida que suas necessidades mudam. No entanto, você só pode diminuir uma quantidade provisionada após 24 horas decorrido desde o último aumento de quantidade. As alterações de armazenamento, IOPS e taxa de transferência entrarão em vigor em poucos minutos após uma alteração de provisionamento.

Portal

Siga estes passos para atualizar o provisionamento do seu compartilhamento de arquivos.

1. Vá até sua conta de armazenamento. No menu de serviço, em Armazenamento de dados, selecione compartilhamentos de arquivos clássicos.

2. Na listagem de compartilhamento de arquivos, selecione o compartilhamento de arquivos para o qual você deseja alterar o provisionamento.

3. Na visão geral do compartilhamento de arquivos, selecione Alterar tamanho e desempenho.

   

4. O diálogo pop-out de Tamanho e desempenho tem as seguintes opções:

   

   • Armazenamento provisionado (GiB): a quantidade de armazenamento provisionada no compartilhamento.

   • IOPS provisionado e taxa de transferência: um conjunto de botões de opção que você usa para selecionar entre o provisionamento recomendado e especificar manualmente IOPS e taxa de transferência. Se o seu compartilhamento estiver no nível recomendado de IOPS e taxa de transferência para a quantidade de armazenamento provisionada, Provisionamento recomendado será selecionado; caso contrário, Especificar manualmente IOPS e taxa de transferência será selecionado. Você pode alternar entre essas duas opções, dependendo do seu desejo de modificar o provisionamento do compartilhamento.

     • IOPS: Se você selecionar a opção Especificar manualmente IOPS e taxa de transferência, esta caixa de texto permite ajustar a quantidade de IOPS provisionada neste compartilhamento de arquivos.

     • Taxa de transferência (MiB/s): se você optar pela opção Especificar manualmente IOPS e taxa de transferência, esta caixa de texto permite ajustar a quantidade de taxa de transferência provisionada neste compartilhamento de arquivos.

5. Selecione Salvar para aplicar as alterações de provisionamento.

PowerShell

Use o Update-AzRmStorageShare cmdlet para modificar um compartilhamento de arquivo v2 provisionado. Substitua os valores das variáveis $resourceGroupName, $storageAccountName, , $shareName, $provisionedThroughputMibPerSec$provisionedIopse $provisionedStorageGib pelos valores que você deseja para o compartilhamento de arquivos.

# The path to the file share resource to be modified.
$resourceGroupName = "<my-resource-group>"
$storageAccountName = "<my-storage-account-name>"
$shareName = "<name-of-the-file-share>"
# The provisioning desired on the file share. Delete the parameters if no
# change is desired.
$provisionedStorageGib = 10240
$provisionedIops = 10000
$provisionedThroughputMibPerSec = 2048
# Update the file share provisioning.
Update-AzRmStorageShare `
        -ResourceGroupName $resourceGroupName `
        -AccountName $storageAccountName `
        -ShareName $shareName `
        -QuotaGiB $provisionedStorageGib `
        -ProvisionedIops $provisionedIops `
        -ProvisionedBandwidthMibps $provisionedThroughputMibPerSec
$f = Get-AzRmStorageShare -ResourceGroupName $resourceGroupName -AccountName $storageAccountName -ShareName $shareName
$f | fl

CLI do Azure

Use o az storage share-rm update comando para modificar um compartilhamento de arquivo v2 provisionado. Substitua os valores das variáveis resourceGroupName, storageAccountName, , fileShareName, provisionedStorageGibprovisionedIopse provisionedThroughputMibPerSec pelos valores que você deseja para o compartilhamento de arquivos.

# The path to the file share resource to be modified.
resourceGroupName="<resource-group>"
storageAccountName="<storage-account>"
fileShareName="<file-share>"

# The provisioning desired on the file share. Delete the parameters if no
# change is desired.
provisionedStorageGib=10240
provisionedIops=10000
provisionedThroughputMibPerSec=2048

# Update the file share provisioning.
az storage share-rm update \
        --resource-group $resourceGroupName \
        --name $fileShareName \
        --storage-account $storageAccountName \
        --quota $provisionedStorageGib \
        --provisioned-iops $provisionedIops \
        --provisioned-bandwidth-mibps $provisionedThroughputMibPerSec

Modelo de cobrança v1 provisionado

Após criar seu compartilhamento de arquivos provisionado v1, você pode ajustar o tamanho do armazenamento provisionado. Ao alterar o tamanho do armazenamento provisionado, você também altera a quantidade de IOPS provisionada e a taxa de transferência provisionada. Você só pode diminuir o armazenamento provisionado após 24 horas decorrido desde o último aumento de armazenamento. As alterações de armazenamento, IOPS e taxa de transferência entrarão em vigor em poucos minutos após uma alteração de provisionamento. Para mais informações, confira os detalhes do provisionamento provisionado v1.

Portal

Siga estes passos para atualizar o provisionamento do seu compartilhamento de arquivos.

1. Vá até sua conta de armazenamento. No menu de serviço, em Armazenamento de dados, selecione compartilhamentos de arquivos clássicos.

2. Na listagem de compartilhamento de arquivos, selecione o compartilhamento de arquivos para o qual você deseja alterar o provisionamento.

3. Na visão geral do compartilhamento de arquivos, selecione Alterar tamanho e desempenho.

   

4. A caixa de diálogo Tamanho e desempenho tem uma única opção, Armazenamento provisionado (GiB). Se você precisar de mais IOPS ou taxa de transferência do que a quantidade fornecida de armazenamento provisionado, poderá aumentar sua capacidade de armazenamento provisionada para obter IOPS e taxa de transferência adicionais.

   

5. Selecione Salvar para aplicar as alterações de provisionamento.

Observação

Você pode usar o PowerShell e a CLI para ativar ou desativar o bursting pago. O bursting pago é um recurso avançado do modelo de cobrança provisionado v1. Consulte o bursting pago v1 provisionado antes de habilitar o bursting pago.

PowerShell

Você pode modificar um compartilhamento de arquivos provisionado v1 com o cmdlet Update-AzRmStorageShare. Substitua os valores das variáveis $resourceGroupName$storageAccountNamee $fileShareName pelos valores do compartilhamento de arquivos. Definir $provisionedStorageGib, $paidBurstingEnabled, $paidBurstingMaxIopse $paidBurstingMaxThroughputMibPerSec como valores não nulos ($null) no compartilhamento de arquivos. O bursting pago é um recurso avançado do modelo v1 provisionado. Consulte o bursting pago v1 provisionado antes de habilitar.

# The path to the file share resource to be modified.
$resourceGroupName = "<resource-group>"
$storageAccountName = "<storage-account>"
$fileShareName = "<file-share>"
# The provisioning desired on the file share. Set to $null to keep at the
# current level of provisioning.
$provisionedStorageGib = 10240
# Paid bursting settings.
$paidBurstingEnabled = $null # Set to $true or $false.
$paidBurstingMaxIops = $null # Set to an integer value.
$paidBurstingMaxThroughputMibPerSec = $null # Set to an integer value.
# Configure parameter object for splatting.
$params = @{
    ResourceGroupName = $resourceGroupName;
    StorageAccountName = $storageAccountName;
    Name = $fileShareName;
}
if ($null -ne $provisionedStorageGib) {
    $params += @{ QuotaGiB = $provisionedStorageGib }
}
if ($null -ne $paidBurstingEnabled) {
    $params += @{ PaidBurstingEnabled = $paidBurstingEnabled }
}
if ($null -ne $paidBurstingMaxIops) {
    $params += @{ PaidBurstingMaxIops = $paidBurstingMaxIops }
}
if ($null -ne $paidBurstingMaxThroughputMibPerSec) {
    $params += @{
        PaidBurstingMaxBandwidthMibps = $paidBurstingMaxThroughputMibPerSec
    }
}
# Update the file share provisioning.
Update-AzRmStorageShare @params

CLI do Azure

Você pode modificar um compartilhamento de arquivo v1 provisionado usando o az storage share-rm update comando. Substitua os valores das variáveisresourceGroupName, storageAccountNamefileShareNamee provisionedStorageGib pelos valores desejados para o compartilhamento de arquivos.

# The path to the file share resource to be modified.
resourceGroupName="<resource-group>"
storageAccountName="<storage-account>"
fileShareName="<file-share>"

# The provisioning desired on the file share.
provisionedStorageGib=10240

# Update the file share provisioning.
az storage share-rm update \
        --resource-group $resourceGroupName \
        --storage-account $storageAccountName \
        --name $fileShareName \
        --quota $provisionedStorageGib

Para alternar o estouro pago, use o parâmetro --paid-bursting-enabled. O bursting pago é um recurso avançado do modelo v1 provisionado. Consulte o bursting pago v1 provisionado antes de habilitar. Opcionalmente, você pode usar os sinalizadores --paid-bursting-max-iops e --paid-bursting-max-bandwidth-mibps para definir uma restrição sobre o valor superior de intermitência paga permitida para fins de controle de custo. Substitua os valores das variáveis resourceGroupNamestorageAccountNamee fileShareName pelos valores desejados para o compartilhamento de arquivos.

resourceGroupName="<resource-group>"
storageAccountName="<storage-account>"
fileShareName="<file-share>"

az storage share-rm update \
        --resource-group $resourceGroupName \
        --storage-account $storageAccountName \
        --name $fileShareName \
        --paid-bursting-enabled true

Modelo de cobrança pré-pago

Depois de criar o compartilhamento de arquivos com cobrança conforme o uso, talvez você queira alterar duas propriedades:

• Nível de acesso: o nível de acesso do compartilhamento de arquivos determina a proporção entre armazenamento e custos de IOPS e taxa de transferência (na forma de transações). Existem três camadas de acesso disponíveis: otimizada para transações, camada de acesso frequente e camada de acesso esporádico. Alterar a camada de um compartilhamento de arquivos do Azure resulta em custos de transação associados à mudança para a nova camada de acesso. Para mais informações, confira o artigo mudança entre camadas de acesso.

• Cota:a cota define um limite para o tamanho do compartilhamento de arquivos. A propriedade da cota é usada nos modelos provisionados v2 e v1 com o significado de "capacidade de armazenamento provisionada". No entanto, no modelo pago conforme o uso, a cota não tem impacto direto na cobrança. Os dois principais motivos que talvez você queira modificar essa propriedade são se você usar a cota para limitar o crescimento do compartilhamento de arquivos para manter o controle dos custos de armazenamento e transação usados no modelo pago conforme o uso, ou se você tiver uma conta de armazenamento antes da introdução do recurso de compartilhamento de arquivos grande, que permitiu que os compartilhamentos de arquivos crescessem além de 5 TiB. O tamanho máximo de um compartilhamento de arquivos no modelo de pagamento conforme o uso é de 100 TiB.

Portal

Para atualizar a camada de acesso do compartilhamento de arquivos usando o portal Azure, siga estas etapas:

1. Vá até sua conta de armazenamento. No menu de serviço, em Armazenamento de dados, selecione compartilhamentos de arquivos clássicos.

2. Na listagem de compartilhamento de arquivos, selecione o compartilhamento de arquivos para o qual você deseja alterar a camada de acesso.

3. Na visão geral do compartilhamento de arquivos, selecione Alterar camada.

4. Selecione a Camada de acesso desejada na lista de seleção fornecida.

5. Selecione Aplicar para salvar a alteração da camada de acesso.

Para atualizar a cota do compartilhamento de arquivos usando o portal Azure, siga estas etapas:

1. Vá até sua conta de armazenamento. No menu de serviço, em Armazenamento de dados, selecione compartilhamentos de arquivos clássicos.

2. Na listagem de compartilhamento de arquivos, selecione o compartilhamento de arquivos para o qual você deseja alterar a cota.

3. Na visão geral do compartilhamento de arquivos, selecione Editar cota.

4. No pop-out Editar cota , insira o tamanho máximo desejado do compartilhamento ou selecione Definir como máximo. Não há impacto no custo ao definir o compartilhamento para o tamanho máximo.

5. Selecione OK para salvar as alterações de cota. A nova cota é efetivada em alguns minutos.

PowerShell

Você também pode usar o cmdlet do Azure PowerShell Update-AzRmStorageShare para alterar as configurações de nível de acesso e cota para um compartilhamento de arquivos pago conforme o uso. Substitua os valores das variáveis$resourceGroupName, $storageAccountName, $fileShareNamee $accessTier$quotaGib pelos valores desejados para o compartilhamento de arquivos.

# The path to the file share resource to be modified.
$resourceGroupName = "<resource-group>"
$storageAccountName = "<storage-account>"
$fileShareName = "<file-share>"
# The settings to be changed on the file share. Set to $null to skip setting.
$accessTier = "Cool"
$quotaGib = $null
# Construct a parameters hash table for cmdlet splatting.
$updateParams = @{
    ResourceGroupName = $resourceGroupName
    StorageAccountName = $storageAccountName
    Name = $fileShareName
}
if ($null -ne $accessTier) { $updateParams += @{ AccessTier = $accessTier } }
if ($null -ne $quotaGib) { $updateParams += @{ QuotaGiB = $quotaGib } }
# Update the file share
Update-AzRmStorageShare @updateParams

CLI do Azure

Você também pode usar o comando da CLI do Azure az storage share-rm update para alterar as configurações de camada de acesso e cota de um compartilhamento de arquivos com pagamento conforme o uso. Substitua os valores das variáveisresourceGroupName, storageAccountName, fileShareNamee accessTierquotaGib pelos valores desejados para o compartilhamento de arquivos.

# The path to the file share resource to be modified.
resourceGroupName="<resource-group>"
storageAccountName="<storage-account>"
fileShareName="<file-share>"

# The settings to be changed on the file share. Set to the empty string to skip
# setting.
accessTier="Cool"
quotaGib=""

command="az storage share-rm update --resource-group $resourceGroupName"
command="$command --storage-account $storageAccountName --name $fileShareName"

if [ ! -z "${accessTier}" ]; then
    command="$command --access-tier $accessTier"
fi

if [ ! -z "${quotaGib}" ]; then
    command="$command --quota $quotaGib"
fi

# Update file share (command is in variable)
$command

Alterar as características de custo e desempenho de um compartilhamento de arquivo (Microsoft.FileShares)

Depois de criar um compartilhamento de arquivos usando o provedor de recursos Microsoft.FileShares, você pode alterar o armazenamento provisionado, as IOPS e a taxa de transferência. Você pode aumentar ou diminuir dinamicamente conforme suas necessidades mudam, mas só pode diminuir uma quantidade providenciada após 24 horas desde o último aumento.

Portal

Siga estes passos para alterar o tamanho e o desempenho de um compartilhamento de arquivos (Microsoft. FileShares) usando o portal Azure. Você pode dimensionar dinamicamente a quantidade de armazenamento, IOPS e taxa de transferência para cima ou para baixo conforme suas necessidades mudam. No entanto, você só pode diminuir uma quantidade provisionada após 24 horas decorrido desde o último aumento de quantidade. As alterações de armazenamento, IOPS e taxa de transferência entrarão em vigor em poucos minutos após uma alteração de provisionamento.

1. Selecione o compartilhamento de arquivo que quer modificar.

2. No menu de contexto, selecione Configurações.

3. Escolha Tamanho + desempenho.

   

4. A caixa de diálogo Tamanho e desempenho tem as seguintes opções:

   • Capacidade provisionada (GiB): a quantidade de armazenamento que você provisiona no compartilhamento.

   • IOPS provisionado e taxa de transferência: um conjunto de botões de opção que você usa para selecionar entre o provisionamento recomendado e especificar manualmente IOPS e taxa de transferência. Se o compartilhamento estiver nos níveis recomendados de IOPS e taxa de transferência para a quantidade de armazenamento que você provisionou, a opção Provisionamento recomendado será selecionada; caso contrário, a opção Especificar manualmente IOPS e taxa de transferência será selecionada. Você pode alternar entre essas duas opções para alterar o provisionamento de compartilhamento.

   • IOPS: Se você selecionar a opção Especificar manualmente IOPS e taxa de transferência, esta caixa de texto permite ajustar a quantidade de IOPS provisionada neste compartilhamento de arquivos.

   • Taxa de transferência (MiB/s): se você selecionar Especificar manualmente IOPS e taxa de transferência, essa caixa de texto permitirá alterar a quantidade de taxa de transferência provisionada no compartilhamento de arquivo.

   

5. Clique em Salvar.

PowerShell

Para alterar o tamanho e o desempenho de um compartilhamento de arquivos (Microsoft. FileShares) usando Azure PowerShell, use os comandos a seguir. Substitua as variáveis pelos valores pretendidos.

# To learn more about the Az.FileShare module, see https://www.powershellgallery.com/packages/Az.FileShare/1.0.0
Install-Module -Name Az.FileShare -Repository PSGallery -RequiredVersion 1.0.0

$resourceGroup = "<resource-group>"
$shareName = "<file-share-name>"

# The following is an example to modify the file share setting. Edit the command to tailor it to your needs.
Update-AzFileShare `
    -ResourceName $shareName `
    -ResourceGroupName $resourceGroup `
    -RootSquash RootSquash `
    -EncryptionInTransitRequired Enabled `
    -ProvisionedIoPerSec 5001 `
    -ProvisionedStorageGiB 101 `
    -ProvisionedThroughputMiBPerSec 126 `
    -PublicNetworkAccess Disabled `
    -Tag @{tag1="value1"}
Get-AzFileShare -ResourceGroupName $resourceGroup -ResourceName $shareName

CLI do Azure

Para alterar o tamanho e o desempenho de um compartilhamento de arquivos (Microsoft. FileShares) usando CLI do Azure, use os comandos a seguir.

# Install the fileshare extension
az extension add --name fileshare

# Specify your values
shareName="<your-file-share-name>"
resourceGroup="<your-resource-group-name>"

# Update the file share. Uncomment and set only the parameters you want to change.
az fileshare update --name $shareName --resource-group $resourceGroup 
# --provisioned-storage-gib 2048 \
# --provisioned-iops 3000 \
# --provisioned-throughput-mib 125 \
# --root-squash RootSquash \
# --encryption-in-transit-required Enabled \
# --public-network-access Disabled \
# --allowed-subnets <subnet-resource-id> \
# --tags tag1=value1

Para verificar as informações de compartilhamento de arquivos:

az fileshare show --name $shareName --resource-group $resourceGroup

Excluir um compartilhamento de arquivo clássico

Talvez você queira excluir compartilhamentos de arquivos não utilizados ou desatualizados. Você pode recuperar compartilhamentos de arquivos em contas de armazenamento com exclusão temporária habilitada durante o período de retenção.

Portal

Siga estes passos para excluir um compartilhamento clássico de arquivos usando o portal Azure.

1. Vá até sua conta de armazenamento. No menu de serviço, em Armazenamento de dados, selecione compartilhamentos de arquivos clássicos.

2. Na lista de compartilhamentos de arquivos, selecione ... para o compartilhamento que você quer excluir.

3. Selecione Excluir compartilhamento no menu de contexto.

4. O pop-up Excluir possui uma pesquisa sobre o motivo da exclusão do compartilhamento de arquivos. Você pode ignorar esta etapa, mas Microsoft aprecia todos os comentários que você tem sobre Arquivos do Azure, especialmente se algo não estiver funcionando corretamente para você.

5. Insira o nome do compartilhamento de arquivo para confirmar a exclusão e selecione Excluir.

PowerShell

Você também pode usar o cmdlet Azure PowerShell Remove-AzRmStorageShare para excluir um compartilhamento de arquivos. Substitua os valores das variáveis $resourceGroupName$storageAccountNamee $fileShareName pelos valores do compartilhamento de arquivos.

# The path to the file share resource to be deleted.
$resourceGroupName = "<resource-group>"
$storageAccountName = "<storage-account>"
$fileShareName = "<file-share>"
# Remove the file share
Remove-AzRmStorageShare `
        -ResourceGroupName $resourceGroupName `
        -StorageAccountName $storageAccountName `
        -Name $fileShareName

CLI do Azure

Você também pode usar o comando CLI do Azure az storage share-rm delete para excluir um compartilhamento de arquivos. Substitua os valores das variáveis resourceGroupNamestorageAccountNamee fileShareName pelos valores do compartilhamento de arquivos.

resourceGroupName="<resource-group>"
storageAccountName="<storage-account>"
fileShareName="<file-share>"

az storage share-rm delete \
    --resource-group $resourceGroupName \
    --storage-account $storageAccountName \
    --name $fileShareName

Excluir um compartilhamento de arquivo (Microsoft.FileShares)

Antes de excluir um compartilhamento de arquivos que você criou com o provedor de recursos Microsoft.FileShares, certifique-se de excluir ou desconectar o ponto de extremidade privado associado a ele. A exclusão do compartilhamento de arquivos falha se o endpoint privado ainda estiver presente.

Portal

Para excluir um compartilhamento de arquivos (Microsoft. FileShares) usando o portal Azure, siga estas etapas.

1. Vá para o compartilhamento de arquivo.

2. Selecione Excluir no menu de contexto.

   

3. O pop-up Excluir possui uma pesquisa sobre o motivo da exclusão do compartilhamento de arquivos. Você pode ignorar esta pesquisa, mas a equipe de produtos aprecia todos os comentários que você fornecer, especialmente se algo não estiver funcionando corretamente para você. Se seu compartilhamento de arquivos tiver recursos dependentes, como snapshots, o processo de exclusão também exclui os snapshots, e a ação fica irrecuperável. Se o compartilhamento de arquivos tiver recursos associados, como pontos de extremidade privados, o portal ajudará você a removê-los para excluir o compartilhamento de arquivos.

4. Insira o nome do compartilhamento de arquivo para confirmar a exclusão e selecione Excluir.

PowerShell

Para excluir um compartilhamento de arquivos (Microsoft. FileShares) usando Azure PowerShell, execute o comando a seguir. Substitua as variáveis por seus valores.

# To learn more about the Az.FileShare module, see https://www.powershellgallery.com/packages/Az.FileShare/1.0.0
Install-Module -Name Az.FileShare -Repository PSGallery -RequiredVersion 1.0.0

$resourceGroup = "<resource-group>"
$shareName = "<file-share-name>"

Remove-AzFileShare -ResourceName $shareName -ResourceGroupName $resourceGroup

CLI do Azure

Para excluir um compartilhamento de arquivos (Microsoft. FileShares) usando CLI do Azure, execute o comando a seguir.

# Install the fileshare extension
az extension add --name fileshare

# Delete the file share
az fileshare delete --name <file-share-name> --resource-group <your-resource-group-name> -y

Próximas etapas

• Saiba mais sobre Arquivos do Azure.
• Saiba como planejar uma implantação do Arquivos do Azure.