Gerir os endpoints do Azure Storage Mover

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

O ponto de extremidade de um movimentador de armazenamento é um recurso que contém o caminho para um local de origem ou de destino e outras informações relevantes. Os pontos de extremidade são usados na criação de uma definição de tarefa para definir os locais de origem e destino para uma operação de cópia específica. Apenas certos tipos de pontos de extremidade podem ser usados como origem ou destino, respectivamente. O Azure Storage Mover suporta atualmente os seguintes cenários:

Migrar de uma partilha de sistema de ficheiros de rede local (NFS) para um contentor Azure Blob
Migrar da fonte do bloco de mensagens do servidor (SMB) para o partilha de ficheiros SMB Azure ou contentor Azure Blob
Migrar da origem NFS para a partilha de ficheiros Azure NFSv4.1

Este artigo orienta-o na criação e gestão de endpoints do Azure Storage Mover. Para seguir esses exemplos, você precisa de um recurso de movimentação 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 completar os passos deste artigo, poderá criar e gerir endpoints usando o portal Azure e o Azure PowerShell.

Visão geral do recurso de endpoint

Dentro da hierarquia de recursos do Azure Storage Mover, um projeto de migração é usado para organizar trabalhos de migração em tarefas ou componentes lógicos. 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 do 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 Storage Mover, seus endpoints e seus projetos.

Como uma migração requer uma origem e um destino bem definidos, os pontos de extremidade são associados ao recurso de movimentação de armazenamento de nível superior. Esse posicionamento permite que você reutilize 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, partilhas NFS, partilhas SMB e endpoints de contentores blob da Azure requerem informação fundamentalmente diferente.

A versão atual do Azure Storage Mover suporta migrações de fidelidade total para combinações específicas de pares source-target. Utilize sempre a versão mais recente do agente para se beneficiar destas fontes e destinos suportados:

Protocolo de origem	Objetivo	Observações
AWS S3	Contêiner de blobs do Azure	Os buckets do AWS (Amazon Web Services) S3 com classes de armazenamento Glacier ou Glacier Deep Archive não podem ser migrados.
Montagem SMB 2.x e 3.x	Partilha de ficheiros Azure (SMB)	As fontes SMB 1.x e as partilhas de ficheiros NFS Azure atualmente não são suportadas.
Montagem SMB 2.x e 3.x	Contêiner de blobs do Azure	Contêineres com o recurso Flatnamespace (FNS) e Hierarchical Namespace Service (HNS) habilitados são suportados e o conjunto de APIs REST do ADLS Gen2 é usado para migração.
Montagem NFS 3 e 4	Contêiner de blobs do Azure	Contêineres com o recurso Flatnamespace (FNS) e Hierarchical Namespace Service (HNS) habilitados são suportados e o conjunto de APIs REST do ADLS Gen2 é usado para migração.
Montagem NFS 3 e 4	Partilha de ficheiros Azure (NFS 4.1)	Partilhas de ficheiros NFS Azure são suportadas com o código-fonte NFS v3/4

Pontos de extremidade SMB

O SMB usa o conceito de ACL (lista de controle de acesso) e autenticação baseada no usuário para fornecer acesso a arquivos compartilhados para usuários selecionados. Para manter a segurança, o Storage Mover depende da integração com o Azure Key Vault para armazenar e controlar de forma segura o acesso às credenciais dos utilizadores e outros segredos. Durante a migração, os recursos do agente de armazenamento móvel ligam-se aos endpoints das suas PME com segredos do Key Vault em vez de credenciais codificadas de forma rígida e não seguras. Essa abordagem reduz muito a chance de que segredos possam ser vazados acidentalmente.

Depois de configurar a sua fonte local de partilha de ficheiros, adicione segredos tanto para um nome de utilizador como para uma palavra-passe ao seu Key Vault. Precisa de fornecer tanto o nome do seu Key Vault ou o Identificador Uniforme de Recursos (URI), como os nomes ou URIs dos segredos das credenciais ao criar os seus endpoints SMB.

O acesso do agente tanto ao seu Key Vault como aos recursos de armazenamento de destino é controlado através do sistema de autorização Azure RBAC (controlo de acesso baseado em roles). Esse sistema permite definir o acesso com base em atributos associados a identidades gerenciadas, entidades de segurança e recursos. É importante notar que as atribuições obrigatórias de funções RBAC são automaticamente aplicadas quando os endpoints SMB são criados no portal Azure. No entanto, qualquer ponto de extremidade criado programaticamente requer que você faça as seguintes atribuições manualmente:

Funções	Recurso
Utilizador de Segredos do Key Vault	O recurso Key Vault usado para armazenar a credencial da sua fonte SMB
Contribuidor Privilegiado de Dados de Ficheiros de Armazenamento	Seu recurso de compartilhamento de arquivos de destino

Há muitos casos de uso que exigem a preservação de valores de metadados, como carimbos de data/hora de arquivos e pastas, ACLs e atributos de arquivo. O Storage Mover suporta o mesmo nível de fidelidade de ficheiros que a partilha de ficheiros subjacente do Azure. Azure Files, por sua vez, suporta um subconjunto das propriedades do ficheiro NTFS. A tabela a seguir representa metadados comuns que são migrados:

Propriedade de metadados	Resultado
Estrutura do diretório	A estrutura de diretórios original da fonte é 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.
Ligações simbólicas	Os links simbólicos na fonte são preservados e mapeados no compartilhamento de destino.
Criar marcador de tempo	O carimbo de data/hora de criação original do arquivo de origem é preservado no compartilhamento de destino.
Alterar data e hora	O carimbo de data/hora de alteração original do arquivo de origem é preservado no compartilhamento de destino.
Marca temporal modificada	O carimbo de data/hora modificado original do arquivo de origem é preservado no compartilhamento de destino.
Último acesso	Este último carimbo de data/hora de acesso não é suportado para um ficheiro ou diretório na partilha de destino.
Outros metadados	Outros metadados do item de origem são preservados se o compartilhamento de destino estiver dando suporte a ele.

Pontos de acesso NFS

Usando o protocolo NFS, pode transferir ficheiros entre computadores que correm Windows e outros sistemas operativos não Windows, como Linux ou UNIX. A versão do Azure Storage Mover suporta migrações de partilhas NFS num NAS ou dispositivo servidor dentro da sua rede para um contentor de blobs Azure ou partilhas de ficheiros Azure.

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

Funções	Recurso
Contribuidor Privilegiado de Dados de Blob de Armazenamento	Seu recurso de contêiner de Blob de destino
Contribuidor Privilegiado de Dados de Ficheiros de Armazenamento	Seu recurso de compartilhamento de arquivos de destino

O Storage Mover processa metadados de forma diferente para fontes de montagem NFS e suas contrapartes de destino de contêiner de Blob ou compartilhamento de arquivos.

Para destinos de origem de montagem NFS e contêiner de Blob, a tabela a seguir identifica os resultados de 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 suportam "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. Tal como acontece com os ficheiros, os metadados da pasta de origem são mantidos no campo de metadados personalizados deste blob.
Permissões de acesso	As permissões no ficheiro de origem são mantidas em metadados personalizados de blobs, mas não funcionam da mesma forma que na origem.
Ligações simbólicas	Um arquivo de destino é 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 marcador de tempo	O timestamp original do ficheiro de origem é preservado como metadados personalizados de blob. O carimbo de tempo nativo do blob reflete o momento em que o ficheiro foi migrado.
Alterar data e hora	O timestamp original do ficheiro de origem é preservado como metadados personalizados de blob. Não existe um timestamp específico para blobs desse tipo.
Marca temporal modificada	O timestamp original do ficheiro de origem é preservado como metadados personalizados de blob. O carimbo de tempo nativo do blob reflete o momento em que o ficheiro foi migrado.
Marca temporal da última vez acessada	Esse carimbo de data/hora é preservado como metadados de blob personalizados caso exista no arquivo de origem. Não existe um timestamp específico para blobs desse tipo.
Outros metadados	Outros metadados são mantidos em um campo de metadados personalizado do blob de destino se existirem em itens de origem. Apenas 4 KiB de metadados podem ser armazenados. Metadados de tamanho maior não são migrados.

Para fontes de montagem NFS e alvos de partilha de ficheiros Azure, a tabela seguinte identifica os resultados para metadados comuns encontrados durante a migração:

Propriedade de metadados	Resultado
Estrutura do diretório	A estrutura de diretórios original da fonte será preservada no compartilhamento de destino.
Permissões de acesso	As permissões de modo de acesso, usuário e grupo serão preservadas do arquivo ou diretório de origem no compartilhamento de destino.
Ligações simbólicas	Links simbólicos são ignorados.
Ligações rígidas	O arquivo de destino será copiado como arquivo normal. Os arquivos na fonte que são links físicos não serão vinculados no destino. O destino receberá cópias completas, apesar do estado de link rígido na origem.
Criar marcador de tempo	O carimbo de data/hora de criação original do arquivo de origem será preservado no compartilhamento de destino.
Alterar data e hora	Não preservado. Na semântica NFS, o ctime é tratado como um atributo de só leitura.
Marca temporal modificada	A data/hora modificada original do ficheiro de origem será preservada na partilha de destino. Em alguns casos em que as informações do 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.
Marca temporal da última vez acessada	Não preservado. Este último carimbo de data/hora de acesso não é suportado para um arquivo nem para um diretório no compartilhamento de destino.

Criar um ponto final

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

Importante

Se você 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 suporta cenários de migração usando protocolos NFS e SMB. As etapas para criar ambos os endpoints são semelhantes. O principal diferenciador entre a criação de endpoints habilitados por NFS e PME é a utilização do Azure Key Vault para armazenar a credencial partilhada dos recursos das PME. Quando um trabalho de migração é executado, os agentes utilizam a credencial partilhada armazenada no Key Vault. O acesso aos segredos do Key Vault é gerido através da concessão de uma atribuição de função RBAC à identidade gerida do agente.

Criar um ponto de extremidade de origem

Os pontos de extremidade de origem identificam os locais dos quais 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 gere as localizações de origem sob a forma de partilhas de ficheiros. Esses locais podem residir no NAS (Network Attached Storage, armazenamento conectado à 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.

Os passos seguintes descrevem o processo de criação de um endpoint de origem.

Portal do Azure
PowerShell

No portal Azure, dirija-se à sua página de recursos Storage mover. 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 de pontos de extremidade de armazenamento padrão exibe os nomes de quaisquer pontos de extremidade de origem provisionados e um resumo de suas propriedades associadas. Você pode selecionar Pontos de extremidade de destino 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 ponto de extremidade para expandir o menu Tipo de ponto de extremidade . 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 ponto de extremidade de origem , forneça valores para o nome do host ou valores de IP e nome de compartilhamento necessários. O nome do host ou o valor do endereço IP deve ser um endereço IPv4 ou um domínio ou nome de host totalmente qualificado.

Importante

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

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

Os agentes de storage mover utilizam segredos armazenados no Key Vault para se conectar aos endpoints SMB. Ao criar um endpoint de origem SMB, precisa de fornecer tanto o nome do Key Vault que contém os segredos como os nomes dos próprios segredos.

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

Depois de selecionar o Key Vault apropriado, pode fornecer valores para os campos necessários de Selecionar segredo para nome de utilizador e Selecionar segredo para palavra-passe. 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 ativar o menu e selecione os valores de nome de usuário e senha. Como alternativa, você pode habilitar a opção Enter secret from URI e fornecer o URI apropriado para o segredo de nome de usuário e senha.

Os valores para host e nome de 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. Finalmente, 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.

O seu novo ponto de extremidade foi implementado e agora aparece na lista de pontos de extremidade de origem, como mostrado na imagem de exemplo a seguir.

Os cmdlets New-AzStorageMoverSmbEndpoint e New-AzStorageMoverNfsEndpoint são usados para criar um novo ponto de extremidade num recurso de transferência de armazenamento que foi implantado anteriormente.

Se 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 Install Azure PowerShell para mais ajuda para instalar Azure PowerShell.

Atenção

Não há suporte para renomear recursos de ponto de extremidade. É uma boa ideia garantir que você nomeou o projeto corretamente, pois não será possível alterar grande parte do nome do ponto de extremidade 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. Consulte a convenção de nomenclatura de recursos para escolher um nome suportado.

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

Importante

Dependendo da configuração de 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 forneça valores 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]"

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

Depois de se conectar com êxito, poderá criar novos endpoints de origem. Dependendo das suas necessidades, pode utilizar o cmdlet New-AzStorageMoverSmbEndpoint para criar um ponto de extremidade SMB, conforme mostrado 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 endpoint de destino

Os pontos de extremidade de destino identificam os locais para os quais os seus dados serão migrados. O Azure oferece vários tipos de armazenamento na cloud. Um aspeto fundamental das migrações de ficheiros para o Azure é determinar qual a opção de armazenamento Azure mais adequada para os seus dados. O número de arquivos e pastas, sua estrutura de diretórios, protocolo de acesso, fidelidade de arquivos e outros aspetos são entradas importantes para um projeto completo de solução em nuvem.

Se precisar de ajuda para escolher o armazenamento Azure destino certo para o design da sua solução cloud, consulte o artigo Cloud migration basics.

As etapas a seguir descrevem o processo de criar um endpoint de destino.

Portal do Azure
PowerShell

No portal Azure, dirija-se à sua página de recursos Storage mover. 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 de pontos de extremidade de armazenamento padrão exibe 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 Conta de armazenamento e a opção apropriada.
Selecione Criar ponto de extremidade para expandir o menu Tipo de ponto de extremidade . 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 Conta de assinatura e Armazenamento , respectivamente. Em seguida, selecione a opção de tipo de destino apropriada correspondente ao seu ponto de extremidade de destino.

Protocolo de origem	Objetivo	Observações
AWS S3	Contêiner de blobs do Azure	Os buckets do AWS (Amazon Web Services) S3 com classes de armazenamento Glacier ou Glacier Deep Archive não podem ser migrados.
Montagem SMB 2.x e 3.x	Partilha de ficheiros Azure (SMB)	As fontes SMB 1.x e as partilhas de ficheiros NFS Azure atualmente não são suportadas.
Montagem SMB 2.x e 3.x	Contêiner de blobs do Azure	Contêineres com o recurso Flatnamespace (FNS) e Hierarchical Namespace Service (HNS) habilitados são suportados e o conjunto de APIs REST do ADLS Gen2 é usado para migração.
Montagem NFS 3 e 4	Contêiner de blobs do Azure	Contêineres com o recurso Flatnamespace (FNS) e Hierarchical Namespace Service (HNS) habilitados são suportados e o conjunto de APIs REST do ADLS Gen2 é usado para migração.
Montagem NFS 3 e 4	Partilha de ficheiros Azure (NFS 4.1)	Partilhas de ficheiros NFS Azure são suportadas com o código-fonte NFS v3/4

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

Seu novo ponto de extremidade foi implantado e agora aparece na 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 New-AzStorageMoverAzStorageContainerEndpoint cmdlet do PowerShell para criar um novo contêiner de blob 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 seu 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. Poderá também ser necessário adicionar ou editar a descrição de um ponto de extremidade.

Siga as etapas nesta seção para visualizar os endpoints acessíveis ao recurso Storage Mover.

Portal do Azure
PowerShell

Para criar um endpoint usando o portal Azure, navegue até à página de recursos Storage mover. Selecione Pontos de extremidade de armazenamento no painel de navegação para acessar seus pontos de extremidade, conforme mostrado na imagem de exemplo.
Na página Pontos de extremidade de armazenamento , a exibição de pontos de extremidade de armazenamento padrão exibe 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.

Neste momento, o portal do Azure não suporta a modificação direta dos endpoints provisionados. A descrição de um endpoint, no entanto, pode ser modificada usando Azure PowerShell seguindo este exemplo. Os recursos de endpoint que necessitem de atualização dentro do portal do Azure devem ser eliminados e recriados.

Use o Get-AzStorageMoverEndpoint cmdlet para obter uma lista de recursos de endpoint. Opcionalmente, você pode fornecer um valor de -Name 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 do movimentador de armazenamento.

O exemplo a seguir recupera um recurso de projeto específico especificando o valor do nome 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 endpoint retornado no exemplo anterior, incluindo um operador de pipeline e o cmdlet Update-AzStorageMoverAzStorageSmbFileShareEndpoint. O exemplo a seguir fornece o valor ausente do ponto de extremidade de partilha de ficheiros SMB 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 da propriedade atualizada 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 endpoint deve ser uma ocorrência relativamente rara no 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.

Advertência

A exclusão de um endpoint é uma ação permanente e importante que não pode ser desfeita. É uma boa ideia garantir que estejas preparado para eliminar o endpoint, pois não será possível restaurá-lo posteriormente.

Portal do Azure
PowerShell

Para eliminar um endpoint usando o portal Azure, navegue até à página de recursos Storage mover. Selecione Pontos de extremidade de armazenamento no painel de navegação para aceder aos seus pontos de extremidade, tal como indicado na imagem a seguir.
A exibição de pontos de extremidade de origem padrão 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.

Identifique o nome do ponto de extremidade que deseja eliminar e marque 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 na sua lista de pontos de extremidade, conforme mostrado na imagem de exemplo a seguir.

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


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

Próximos passos

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 2026-04-22