Gerenciar pontos de extremidade do Migrador de Armazenamento do Azure

Embora o termo endpoint seja frequentemente usado em redes, ele é usado no contexto do serviço Storage Mover para descrever um local de armazenamento com um alto nível de detalhe.

Um ponto de extremidade do migrador de armazenamento é um recurso que contém o caminho para um local de origem ou destino e outras informações relevantes. Os pontos de extremidade são usados na criação de uma definição de trabalho para definir os locais de origem e de destino para uma operação de cópia específica. Somente determinados tipos de pontos de extremidade podem ser usados como uma origem ou um destino, respectivamente. Atualmente, o Azure Storage Mover dá suporte aos seguintes cenários:

Migrar de um compartilhamento NFS (sistema de arquivos de rede) local para um contêiner de Blob do Azure
Migrar da origem do bloco de mensagens do servidor (SMB) para o compartilhamento de arquivos do Azure SMB ou para o contêiner do Azure Blob
Migrar da origem do NFS para o compartilhamento de arquivos NFSv4.1 do Azure

Este artigo descreve a criação e o gerenciamento de pontos de extremidade do Migrador de Armazenamento do Azure. Para seguir estes exemplos, você precisa ter um recurso do migrador de armazenamento de nível superior. Se você ainda não criou um, siga as etapas no artigo Criar um recurso do Storage Mover antes de continuar.

Depois de concluir as etapas neste artigo, você poderá criar e gerenciar endpoints usando o portal do Azure e o Azure PowerShell.

Visão geral de recursos do endpoint

Na hierarquia de recursos do Azure Storage Mover, um projeto de migração é usado para organizar trabalhos de migração em tarefas lógicas ou componentes. Um projeto de migração, por sua vez, contém pelo menos uma definição de trabalho, que descreve os locais de origem e de destino para seu projeto de migração. O artigo Noções básicas sobre a hierarquia de recursos do Storage Mover contém informações mais detalhadas sobre as relações entre um Gerenciador de Armazenamento, seus pontos de extremidade e seus projetos.

Como uma migração requer uma origem e um destino bem definidos, os pontos de extremidade são pai do recurso do migrador de armazenamento de nível superior. Esse posicionamento permite reutilizar pontos de extremidade em qualquer número de definições de trabalho. Embora exista apenas um único recurso de ponto de extremidade, as propriedades de cada ponto de extremidade individual podem variar com base em seu tipo. Por exemplo, pontos de extremidade de compartilhamentos NFS, compartilhamentos SMB e contêineres de blob do Azure exigem informações fundamentalmente diferentes.

A versão atual do Migrador de Armazenamento do Azure dá suporte a migrações de fidelidade total para combinações específicas de par de destino de origem. Sempre utilize a versão mais recente do agente para se beneficiar dessas fontes e destinos com suporte:

Protocolo de origem	Meta	Comentários
AWS S3	Contêiner de blobs do Azure	Os buckets S3 do AWS (Amazon Web Services) com classes de armazenamento do Glacier ou Glacier Deep Archive não podem ser migrados.
Montagem SMB 2.x e 3.x	Compartilhamento de arquivos do Azure (SMB)	Atualmente, não há suporte para fontes do SMB 1.x e compartilhamentos de arquivos do Azure NFS.
Montagem SMB 2.x e 3.x	Contêiner de blobs do Azure	Contêineres com FNS (Flatnamespace) e recurso HNS (Serviço de Namespace Hierárquico) habilitados têm suporte e o conjunto de API REST do ADLS Gen2 é usado para migração.
Montagem de NFS 3 e 4	Contêiner de blobs do Azure	Contêineres com FNS (Flatnamespace) e recurso HNS (Serviço de Namespace Hierárquico) habilitados têm suporte e o conjunto de API REST do ADLS Gen2 é usado para migração.
Montagem de NFS 3 e 4	Compartilhamento de arquivos do Azure (NFS 4.1)	Há suporte para compartilhamentos de arquivos do Azure NFS com origem NFS v3/4

Pontos de extremidade SMB

O SMB usa o conceito de ACL (lista de controle de acesso) e a autenticação baseada no usuário para fornecer acesso a arquivos compartilhados para usuários selecionados. Para manter a segurança, o Storage Mover conta com a integração do Azure Key Vault para armazenar e controlar com segurança o acesso às credenciais do usuário e outros segredos. Durante uma migração, os recursos do agente do migrador de armazenamento se conectam aos pontos de extremidade SMB com segredos do Key Vault, em vez de com credenciais não seguras codificadas em código. Essa abordagem reduz consideravelmente a chance de que os segredos possam ser acidentalmente vazados.

Depois que a origem do compartilhamento de arquivos local estiver configurada, adicione segredos para um nome de usuário e uma senha ao Key Vault. Você precisa fornecer o nome do Key Vault ou o URI (Uniform Resource Identifier) e os nomes ou URIs dos segredos de credencial ao criar seus pontos de extremidade SMB.

O acesso do agente ao Key Vault e aos recursos de armazenamento de destino é controlado por meio do sistema de autorização do Azure RBAC (controle de acesso baseado em funções). Esse sistema permite que você defina o acesso com base em atributos associados a identidades gerenciadas, entidades de segurança e recursos. É importante observar que as atribuições de função RBAC necessárias são aplicadas automaticamente quando endpoints SMB são criados no Portal do Azure. No entanto, qualquer ponto de extremidade criado programaticamente exige que você faça as seguintes atribuições manualmente:

Função	Recurso
Usuário de segredos do Key Vault	O recurso do Key Vault usado para armazenar as credenciais da sua fonte SMB
Colaborador privilegiado de dados de arquivo de armazenamento	Seu recurso de compartilhamento de arquivo de destino

Há muitos casos de uso que exigem a preservação de valores de metadados, como carimbos de data/hora de arquivo e pasta, ACLs e atributos de arquivo. O Storage Mover dá suporte ao mesmo nível de fidelidade de arquivo que o compartilhamento de arquivos subjacente do Azure. Os Arquivos do Azure, por sua vez, dão suporte a um subconjunto das propriedades do arquivo NTFS. A tabela a seguir representa metadados comuns migrados:

Propriedade de Metadados	Resultado
Estrutura do diretório	A estrutura de diretório original da origem é preservada no compartilhamento de destino.
Permissões de acesso	As permissões no arquivo ou diretório de origem são preservadas no compartilhamento de destino.
Links simbólicos	Os links simbólicos na origem são preservados e mapeados no compartilhamento de destino.
Criar carimbo de data/hora	O carimbo de data/hora de criação original do arquivo de origem é preservado no compartilhamento de destino.
Alterar carimbo de data/hora	O carimbo de data/hora de alteração original do arquivo de origem é preservado no compartilhamento de destino.
Modificação do carimbo de data/hora	O carimbo de data/hora modificado original do arquivo de origem é preservado no compartilhamento de destino.
Registro de data e hora do último acesso	Este último carimbo de data/hora de acesso não tem suporte para um arquivo ou diretório no compartilhamento de destino.
Outros metadados	Outros metadados do item de origem serão preservados se o compartilhamento de destino estiver dando suporte a ele.

Pontos de extremidade NFS

Usando o protocolo NFS, você pode transferir arquivos entre computadores que executam Windows e outros sistemas operacionais que não sejam Windows, como Linux ou UNIX. A versão do Azure Storage Mover dá suporte a migrações de compartilhamentos NFS em um NAS ou dispositivo de servidor em sua rede para um contêiner de blobs do Azure ou compartilhamentos de arquivos do Azure.

Ao contrário do SMB, o NFS não utiliza o conceito de ACL ou a autenticação baseada no usuário. Essa diferença permite que os pontos de extremidade NFS sejam acessados sem a integração do Azure Key Vault. Qualquer ponto de extremidade criado programaticamente exige que você faça as seguintes atribuições manualmente:

Função	Recurso
Colaborador privilegiado de Dados de blob de armazenamento	Seu recurso de contêiner Blob de destino
Colaborador privilegiado de dados de arquivo de armazenamento	Seu recurso de compartilhamento de arquivo de destino

O Migrador de Armazenamento processa metadados de maneira diferente para as fontes de montagem NFS e seus contêineres de Blob ou compartilhamento de arquivos de destino correspondentes.

Quanto às fontes de montagem NFS e destinos de contêineres do Blob, a tabela a seguir identifica os resultados para metadados comuns encontrados durante a migração:

Propriedade de Metadados	Resultado
Estrutura do diretório	Os contêineres de blob não têm um sistema de arquivos tradicional, mas dão suporte a "pastas virtuais". O caminho de um arquivo dentro de uma pasta é anexado ao nome do arquivo e colocado em uma lista simples dentro do contêiner de blob. As pastas vazias são representadas como um blob vazio no contêiner de destino. Assim como acontece com os arquivos, os metadados da pasta de origem são mantidos no campo de metadados personalizado desse blob.
Permissões de acesso	As permissões no arquivo de origem são preservadas nos metadados personalizados do blob, mas não funcionam da mesma maneira que na origem.
Links simbólicos	Um arquivo de destino será migrado se seu link simbólico puder ser resolvido. Um link simbólico que não pode ser resolvido é registrado como um arquivo com falha.
Criar carimbo de data/hora	O carimbo de data/hora original do arquivo de origem é preservado como metadados de blob personalizados. O timestamp nativo do blob reflete o momento em que o arquivo foi migrado.
Alterar carimbo de data/hora	O carimbo de data/hora original do arquivo de origem é preservado como metadados de blob personalizados. Não há nenhum carimbo de data/hora nativo de blob desse tipo.
Modificação do carimbo de data/hora	O carimbo de data/hora original do arquivo de origem é preservado como metadados de blob personalizados. O timestamp nativo do blob reflete o momento em que o arquivo foi migrado.
Data/hora do último acesso	Esse carimbo de data/hora será preservado como metadados de blob personalizados se existir no arquivo de origem. Não há nenhum carimbo de data/hora nativo de blob desse tipo.
Outros metadados	Outros metadados são persistidos em um campo de metadados personalizado do blob de destino se ele existir em itens de origem. Somente 4 KiB de metadados podem ser armazenados. Metadados de um tamanho maior não são migrados.

Para fontes de montagem do NFS e destinos de compartilhamento de arquivos do Azure, a tabela a seguir identifica os resultados de metadados comuns encontrados durante a migração:

Propriedade de Metadados	Resultado
Estrutura do diretório	A estrutura de diretório original da origem será preservada no compartilhamento de destino.
Permissões de acesso	As permissões de modo de acesso, de usuário e de grupo serão preservadas do arquivo de origem ou do diretório no compartilhamento de destino.
Links simbólicos	Links simbólicos são ignorados.
Links rígidos	O arquivo de destino será copiado como arquivo regular. Os arquivos na origem que são links rígidos não serão vinculados no destino. O destino receberá cópias completas, independentemente do status do link físico na origem.
Criar carimbo de data/hora	O carimbo de data/hora de criação original do arquivo de origem será preservado no compartilhamento de destino.
Alterar carimbo de data/hora	Não preservado. A semântica da NFS trata o ctime como um atributo de leitura somente.
Modificação do carimbo de data/hora	O timestamp original modificado do arquivo de origem será preservado na pasta de destino. Em alguns casos em que as informações de diretório são atualizadas antes que os arquivos sejam atualizados, o "Carimbo de data/hora modificado" no diretório será refletido corretamente após a primeira sincronização e não durante a cópia inicial.
Data/hora do último acesso	Não preservado. Esse último carimbo de data/hora de acesso não é compatível com arquivos nem diretórios no compartilhamento de destino.

Criar um ponto de extremidade

Antes de criar uma definição de trabalho, você precisa criar pontos de extremidade para suas fontes de dados de origem e de destino.

Importante

Se você ainda não implantou um recurso do Storage Mover usando o provedor de recursos, precisará criar seu recurso de nível superior antes de tentar as etapas neste exemplo.

O Azure Storage Mover dá suporte a cenários de migração usando protocolos NFS e SMB. As etapas para criar ambos os pontos de extremidade são semelhantes. O principal diferencial entre a criação de pontos de extremidade habilitados para NFS e SMB é o uso do Azure Key Vault para armazenar a credencial compartilhada de recursos SMB. Quando um trabalho de migração é executado, os agentes usam a credencial compartilhada armazenada no Key Vault. O acesso aos segredos do Key Vault é gerenciado concedendo uma atribuição de função RBAC à identidade gerenciada do agente.

Criar um ponto de extremidade de origem

Os endpoints de origem identificam locais de onde seus dados são migrados. Os pontos de extremidade de origem são usados para definir a origem dos dados especificados em seu projeto de migração. O Azure Storage Mover manipula os locais de origem na forma de compartilhamentos de arquivos. Esses locais podem residir no NAS (Armazenamento Anexado à Rede), em um servidor ou até mesmo em uma estação de trabalho. Os protocolos comuns para compartilhamentos de arquivos são SMB e NFS.

As etapas seguintes descrevem o processo de criação de um endpoint de origem.

Portal do Azure
PowerShell

No portal do Azure, navegue até a página de recursos do Migrador de armazenamento. Selecione pontos de extremidade de armazenamento no painel de navegação para acessar seus pontos de extremidade.

Na página Pontos de Extremidade de Armazenamento, a exibição padrão dos pontos de extremidade de armazenamento apresenta os nomes de quaisquer pontos de extremidade de origem provisionados e um resumo de suas propriedades associadas. Você pode selecionar pontos de extremidade alvo para exibir os pontos de extremidade de destino correspondentes. Você também pode filtrar ainda mais os resultados selecionando a versão do protocolo ou o filtro host e selecionando a opção apropriada.
Selecione Criar endpoint para expandir o menu tipo de endpoint. Selecione Criar ponto de extremidade de origem para abrir o painel Criar ponto de extremidade de origem , conforme mostrado na imagem a seguir.
No painel Criar endpoint de origem, forneça os valores necessários para nome do host ou IP e nome de compartilhamento. O nome do host ou o valor do endereço IP deve ser um endereço IPv4 ou um nome de host ou domínio totalmente qualificado.

Importante

Dependendo da configuração do DNS, talvez seja necessário usar o FQDN (nome de domínio totalmente qualificado) em vez do nome do host.

Você também pode adicionar um valor opcional de descrição de até 1.024 caracteres de comprimento. Em seguida, selecione a versão protocolo para expandir o menu de seleção de protocolo e selecione a opção apropriada para o destino de origem.

Os agentes do migrador de armazenamento usam segredos armazenados no Key Vault para se conectar aos pontos de extremidade SMB. Ao criar um ponto de extremidade de origem SMB, você precisa fornecer o nome do Key Vault que contém os segredos e os próprios nomes dos segredos.

Primeiro, selecione Key Vault para expandir o menu e selecione o nome do Key Vault que contém seus segredos. Você pode fornecer um valor com o qual filtrar a lista de Key Vaults, se necessário.

Depois de selecionar o Key Vault apropriado, você pode fornecer valores para os campos necessários Select secret for username e Select secret for password. Esses valores podem ser fornecidos fornecendo o URI para os segredos ou selecionando os segredos de uma lista. Selecione o botão Selecionar segredo para habilitar o menu e selecione os valores de nome de usuário e senha. Como alternativa, você pode habilitar a opção Insira segredo de URI e fornecer o URI apropriado para o segredo de usuário e senha.

Os valores do host e do nome do compartilhamento são concatenados para formar o caminho de origem de migração completo. O valor do caminho é exibido no campo Caminho de origem completo . Copie o caminho fornecido e verifique se você pode acessá-lo antes de confirmar suas alterações. Por fim, depois de confirmar que todos os valores estão corretos e que você pode acessar o caminho de origem, selecione Criar para adicionar seu novo ponto de extremidade.

Seu novo endpoint foi implantado e agora aparece na lista de endpoints de origem, conforme a imagem de exemplo a seguir.

Os cmdlets New-AzStorageMoverSmbEndpoint e New-AzStorageMoverNfsEndpoint são usados para criar um novo endpoint em um recurso de movimentação de armazenamento que você implantou anteriormente.

Se você ainda não instalou o Az.StorageMover módulo:

## Ensure you are running the latest version of PowerShell 7
$PSVersionTable.PSVersion

## Your local execution policy must be set to at least remote signed or less restrictive
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

## If you don't have the general Az PowerShell module, install it first
Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

## Lastly, the Az.StorageMover module is not installed by default and must be manually requested.
Install-Module -Name Az.StorageMover -Scope CurrentUser -Repository PSGallery -Force

Consulte o artigo Instalar o Azure PowerShell para obter mais ajuda para instalar o Azure PowerShell.

Cuidado

Não há suporte para renomeação de recursos de endpoint. É uma boa ideia dar ao projeto um nome apropriado, já que você não poderá alterar grande parte do nome do endpoint depois que ele for provisionado. No entanto, você pode optar por criar um novo ponto de extremidade com as mesmas propriedades e um nome diferente, conforme mostrado em uma seção posterior. Veja a convenção de nomenclatura de recursos para escolher um nome compatível.

É sempre uma boa ideia criar e usar variáveis para armazenar cadeias de caracteres longas ou potencialmente complexas.

Importante

Dependendo da configuração do DNS, talvez seja necessário usar o FQDN (nome de domínio totalmente qualificado) em vez do nome do host.

Copie o bloco de código de exemplo e os valores de fornecimento para os parâmetros necessários. O -Description parâmetro é opcional e é adicionado na seção Exibir e editar as propriedades de um ponto de extremidade.


## Set variables
$subscriptionID    = "[Subscription GUID]"
$resourceGroupName = "[Resource group name]"
$storageMoverName  = "[Storage mover resource's name]"
$sourceHost        = "[Source share's host name or IP address]"
$sourceShare       = "[Source share's name]"
$targetResourceID  = "/subscriptions/[GUID]/resourceGroups/demoResourceGroup/"
$targetResourceID += "providers/Microsoft.Storage/storageAccounts/demoAccount"

## For SMB endpoints 
$smbFileshare      = "[Target fileshare name]"
$usernameURI       = "https://demo.vault.azure.net/secrets/demoUser"
$passwordURI       = "https://demo.vault.azure.net/secrets/demoPassword"

## For NFS endpoints
$nfsContainer      = "[Blob container target]"

Conecte-se à sua conta do Azure usando o Connect-AzAccount cmdlet. Especifique a ID da sua assinatura fornecendo um valor para o -Subscription parâmetro, conforme mostrado no exemplo.
```
Connect-AzAccount -Subscription $subscriptionID
```

Depois de se conectar com êxito, você pode criar novos recursos de ponto de extremidade de origem. Dependendo da sua necessidade, você pode utilizar o cmdlet New-AzStorageMoverSmbEndpoint para criar um ponto de extremidade SMB, conforme demonstrado no exemplo a seguir.


New-AzStorageMoverSmbEndpoint `
   -Name "smbSourceEndpoint"
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName `
   -Host $sourceHost ` 
   -ShareName $sourceShare `
   -CredentialsUsernameUri $usernameURI `
   -CredentialsPasswordUri $passwordURI

Como alternativa, você pode criar um novo ponto de extremidade de origem NFS usando o New-AzStorageMoverNfsEndpoint cmdlet, conforme mostrado.


New-AzStorageMoverNfsEndpoint `
    -Name "nfsSourceEndpoint" `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName `
    -Host $sourceHost `
    -Export $sourceShare `

A resposta de exemplo a seguir contém a ProvisioningState propriedade, que indica que o ponto de extremidade foi criado com êxito.


Id                           : /subscriptions/<GUID>/resourceGroups/
                              demoResourceGroup/providers/Microsoft.StorageMover/
                              storageMovers/demoMover/endpoints/smbTargetEndpoint
Name                         : demoTarget
Property                     : {
                                 "endpointType": "AzureStorageSmbFileShare",
                                 "description": "",
                                 "provisioningState": "Succeeded",
                                 "storageAccountResourceId": "/subscriptions/[GUID]/
                                  resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                  storageAccounts/contosoeuap",
                                 "fileShareName": "demoFileshare"
                               }
SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
SystemDataCreatedBy          : user@contoso.com
SystemDataCreatedByType      : User
SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
SystemDataLastModifiedBy     : user@contoso.com
SystemDataLastModifiedByType : User
Type                         : microsoft.storagemover/storagemovers/endpoints

Criar um ponto de extremidade de destino

Os pontos de extremidade de destino identificam locais para os quais os dados são migrados. O Azure oferece vários tipos de armazenamento em nuvem. Um aspecto fundamental da migração de arquivos para o Azure é determinar a opção de armazenamento do Azure adequada aos seus dados. O número de arquivos e pastas, sua estrutura de diretório, protocolo de acesso, fidelidade de arquivo e outros aspectos são entradas importantes em um design de solução de nuvem completo.

Se você precisar de ajuda para escolher o armazenamento de destino certo do Azure para seu design de solução de nuvem, consulte o artigo básico de migração na nuvem .

As etapas a seguir descrevem o processo de criação de um endpoint de destino.

Portal do Azure
PowerShell

No portal do Azure, navegue até a página de recursos do Migrador de armazenamento. Selecione pontos de extremidade de armazenamento no painel de navegação para acessar seus pontos de extremidade.

Na página Pontos de Extremidade de Armazenamento, a exibição padrão dos pontos de extremidade de armazenamento apresenta os nomes de quaisquer pontos de extremidade de origem provisionados e um resumo de suas propriedades associadas. Selecione pontos de extremidade de destino para exibir os pontos de extremidade de destino existentes. Você pode filtrar ainda mais os resultados selecionando o filtro da conta de armazenamento e a opção apropriada.
Selecione Criar endpoint para expandir o menu tipo de endpoint. Selecione Criar ponto de extremidade de destino para abrir o painel Criar ponto de extremidade de destino , conforme mostrado na imagem a seguir.

No painel Criar ponto de extremidade de destino, selecione sua assinatura e sua conta de armazenamento de destino nas listas de contas de Assinatura e Armazenamento, respectivamente. Em seguida, selecione a opção apropriada de tipo de destino correspondente ao endpoint de destino.

Protocolo de origem	Meta	Comentários
AWS S3	Contêiner de blobs do Azure	Os buckets S3 do AWS (Amazon Web Services) com classes de armazenamento do Glacier ou Glacier Deep Archive não podem ser migrados.
Montagem SMB 2.x e 3.x	Compartilhamento de arquivos do Azure (SMB)	Atualmente, não há suporte para fontes do SMB 1.x e compartilhamentos de arquivos do Azure NFS.
Montagem SMB 2.x e 3.x	Contêiner de blobs do Azure	Contêineres com FNS (Flatnamespace) e recurso HNS (Serviço de Namespace Hierárquico) habilitados têm suporte e o conjunto de API REST do ADLS Gen2 é usado para migração.
Montagem de NFS 3 e 4	Contêiner de blobs do Azure	Contêineres com FNS (Flatnamespace) e recurso HNS (Serviço de Namespace Hierárquico) habilitados têm suporte e o conjunto de API REST do ADLS Gen2 é usado para migração.
Montagem de NFS 3 e 4	Compartilhamento de arquivos do Azure (NFS 4.1)	Há suporte para compartilhamentos de arquivos do Azure NFS com origem NFS v3/4

Dependendo do tipo de destino escolhido, selecione o contêiner de Blob ou o compartilhamento de arquivos na lista suspensa correspondente. Por fim, você pode adicionar um valor opcional de Descrição para seu alvo de até 1024 caracteres e selecionar Criar para implantar seu ponto de extremidade.

Seu novo ponto de extremidade é implantado e agora aparece em sua lista de pontos de extremidade, conforme mostrado na imagem de exemplo a seguir.

Para criar um novo compartilhamento de arquivos SMB, use o New-AzStorageMoverAzStorageSmbFileShareEndpoint cmdlet, conforme mostrado no exemplo a seguir.


New-AzStorageMoverAzStorageSmbFileShareEndpoint `
   -Name "smbTargetEndpoint" ` 
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName ` 
   -StorageAccountResourceId $targetResourceID `
   -FileShareName $targetFileshare

Use o cmdlet do PowerShell New-AzStorageMoverAzStorageContainerEndpoint para criar um novo contêiner de blobs NFS. O exemplo a seguir fornece diretrizes de provisionamento.


New-AzStorageMoverAzStorageContainerEndpoint `
  -Name "nfsTargetEndpoint" `
  -ResourceGroupName $resourceGroupName `
  -StorageMoverName $storageMoverName `
  -BlobContainerName $targetEpContainer `
  -StorageAccountResourceId $targetResourceID `

A resposta de exemplo a seguir contém a ProvisioningState propriedade, que indica que o ponto de extremidade foi criado com êxito.


Id                           : /subscriptions/<GUID>/resourceGroups/
                              demoResourceGroup/providers/Microsoft.StorageMover/
                              storageMovers/demoMover/endpoints/smbTargetEndpoint
Name                         : demoTarget
Property                     : {
                                 "endpointType": "AzureStorageSmbFileShare",
                                 "description": "",
                                 "provisioningState": "Succeeded",
                                 "storageAccountResourceId": "/subscriptions/[GUID]/
                                  resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                  storageAccounts/contosoeuap",
                                 "fileShareName": "demoFileshare"
                               }
SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
SystemDataCreatedBy          : user@contoso.com
SystemDataCreatedByType      : User
SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
SystemDataLastModifiedBy     : user@contoso.com
SystemDataLastModifiedByType : User
Type                         : microsoft.storagemover/storagemovers/endpoints

Exibir e editar as propriedades de um ponto de extremidade

Dependendo do caso de uso, talvez seja necessário recuperar um ponto de extremidade específico ou uma lista completa de todos os recursos do ponto de extremidade. Talvez você também precise adicionar ou editar a descrição de um endpoint.

Siga as etapas nesta seção para exibir pontos de extremidade acessíveis ao recurso do Migrador de Armazenamento.

Portal do Azure
PowerShell

Para excluir um ponto de extremidade usando o portal do Azure, navegue até a página de recursos do Migrador de armazenamento. Selecione endereços de armazenamento no painel de navegação para acessar seus endereços, conforme mostrado na imagem de exemplo.
Na página Pontos de Extremidade de Armazenamento, a exibição padrão dos pontos de extremidade de armazenamento apresenta os nomes de quaisquer pontos de extremidade de origem provisionados e um resumo de suas propriedades associadas. Para exibir o ponto de extremidade de destino provisionado, selecione Pontos de extremidade de destino. Você pode filtrar ainda mais os resultados selecionando os filtros protocolo ou host e a opção relevante.

No momento, o portal do Azure não dá suporte à modificação direta de pontos de extremidade provisionados. No entanto, a descrição de um ponto de extremidade pode ser modificada usando o Azure PowerShell seguindo este exemplo. Os recursos de ponto de extremidade que exigem atualização no portal do Azure devem ser excluídos e recriados.

Use o cmdlet Get-AzStorageMoverEndpoint para recuperar uma lista de recursos de ponto de extremidade. Opcionalmente, você pode fornecer um -Name valor de parâmetro para recuperar um recurso específico. Chamar o cmdlet sem o parâmetro opcional retorna uma lista de todos os pontos de extremidade provisionados associados ao recurso de migrador de armazenamento.

O exemplo a seguir recupera um recurso de projeto específico especificando o valor do nome de demoTarget .


  Get-AzStorageMoverEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName ` 
    -Name "demoTarget"

A resposta de exemplo contém as propriedades do projeto especificado, incluindo a propriedade vazia Description .


Id                           : /subscriptions/<GUID>/resourceGroups/
                                 demoResourceGroup/providers/Microsoft.StorageMover/
                                 storageMovers/demoMover/endpoints/smbTargetEndpoint
Name                         : demoTarget
Property                     : {
                                 "endpointType": "AzureStorageSmbFileShare",
                                 "description": "",
                                 "provisioningState": "Succeeded",
                                 "storageAccountResourceId": "/subscriptions/[GUID]/
                                  resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                  storageAccounts/contosoeuap",
                                 "fileShareName": "demoFileshare"
                               }
SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
SystemDataCreatedBy          : user@contoso.com
SystemDataCreatedByType      : User
SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
SystemDataLastModifiedBy     : user@contoso.com
SystemDataLastModifiedByType : User
Type                         : microsoft.storagemover/storagemovers/endpoints

Você pode adicionar a descrição ausente ao ponto de extremidade retornado no exemplo anterior, incluindo um operador de pipeline e o cmdlet Update-AzStorageMoverAzStorageSmbFileShareEndpoint. O exemplo a seguir fornece o valor do ponto de extremidade de compartilhamento de arquivo SMB ausente com o parâmetro -Description.


  Get-AzStorageMoverEndpoint `
    -ResourceGroupName $resourceGroupName `
    -StorageMoverName $storageMoverName ` 
    -Name "demoTarget" | `
  Update-AzStorageMoverAzStorageSmbFileShareEndpoint `
    -Description "SMB fileshare endpoint"

A resposta agora contém o valor atualizado da propriedade Description.


Id                           : /subscriptions/<GUID>/resourceGroups/
                                 demoResourceGroup/providers/Microsoft.StorageMover/
                                 storageMovers/demoMover/endpoints/smbTargetEndpoint
Name                         : demoTarget
Property                     : {
                                 "endpointType": "AzureStorageSmbFileShare",
                                 "description": "SMB fileshare endpoint",
                                 "provisioningState": "Succeeded",
                                 "storageAccountResourceId": "/subscriptions/[GUID]/
                                  resourceGroups/demoResourceGroup/providers/Microsoft.Storage/
                                  storageAccounts/contosoeuap",
                                 "fileShareName": "demoFileshare"
                               }
SystemDataCreatedAt          : 6/22/2023 1:19:00 AM
SystemDataCreatedBy          : user@contoso.com
SystemDataCreatedByType      : User
SystemDataLastModifiedAt     : 6/22/2023 1:19:00 AM
SystemDataLastModifiedBy     : user@contoso.com
SystemDataLastModifiedByType : User
Type                         : microsoft.storagemover/storagemovers/endpoints

Excluir um ponto de extremidade

A remoção de um recurso de ponto de extremidade deve ser uma ocorrência relativamente rara em seu ambiente de produção, embora possa haver ocasiões em que possa ser útil. Para excluir um recurso de ponto de extremidade do Storage Mover, siga o exemplo fornecido.

Aviso

Excluir um ponto de extremidade é uma ação permanente e não pode ser desfeita. É uma boa ideia certificar-se de que você esteja preparado para excluir o ponto de extremidade, pois não poderá restaurá-lo posteriormente.

Portal do Azure
PowerShell

Para excluir um ponto de extremidade usando o portal do Azure, navegue até a página de recursos do Migrador de armazenamento. Selecione pontos de extremidade de armazenamento no painel de navegação para acessar seus pontos de extremidade, conforme indicado na imagem a seguir.
A visão padrão dos pontos de extremidade de origem exibe os nomes de quaisquer pontos de extremidade de origem provisionados e um resumo de seus dados associados. Você pode selecionar o filtro pontos de extremidade de destino para exibir os pontos de extremidade de destino correspondentes.

Localize o nome do ponto de extremidade que você deseja excluir e selecione a caixa de seleção correspondente. Depois de verificar se você selecionou o ponto de extremidade apropriado, selecione Excluir , conforme mostrado na imagem a seguir.

Seu novo ponto de extremidade é excluído e não aparece mais em sua lista de pontos de extremidade, conforme mostrado na imagem de exemplo a seguir.

Use o Remove-AzStorageMoverEndpoint para excluir permanentemente um recurso de endpoint. Forneça o nome do ponto de extremidade com o parâmetro -Name e os nomes de recursos do grupo de recursos e do migrador de armazenamento com os parâmetros -ResourceGroupName e -StorageMoverName, respectivamente.


Remove-AzStorageMoverEndpoint `
   -ResourceGroupName $resourceGroupName `
   -StorageMoverName $storageMoverName ` 
   -Name "demoTarget"

Próximas etapas

Crie um projeto para agrupar os diferentes compartilhamentos de origem que precisam ser migrados juntos.

Criar e gerenciar um projeto

Comentários

Esta página foi útil?

Last updated on 2025-10-19