Gerenciar pontos de extremidade 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. Atualmente, o Azure Storage Mover dá suporte aos seguintes cenários:

Migrar de um compartilhamento de 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 ficheiros SMB no Azure ou contentor de Blob do Azure
Migrar da origem NFS para o compartilhamento de arquivos do Azure NFSv4.1

Este artigo orienta o leitor pela 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 concluíres as etapas deste artigo, poderás criar e gerir endpoints usando o portal do 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 pontos finais de contentor de blob do Azure exigem informações fundamentalmente diferentes.

A versão atual do Azure Storage Mover dá suporte a migrações de fidelidade total para combinações específicas de par origem-destino. 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	Contentor 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	Compartilhamento de arquivos do Azure (SMB)	Atualmente, não há suporte para fontes SMB 1.x e compartilhamentos de arquivos do Azure NFS.
Montagem SMB 2.x e 3.x	Contentor 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	Contentor 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	Compartilhamento de arquivos do Azure (NFS 4.1)	As partilhas de ficheiros do Azure NFS são suportadas com a origem 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 conta com a integração do Cofre de Chaves do Azure 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 de movimentação de armazenamento ligam-se aos seus pontos de extremidade SMB com segredos armazenados no Cofre de Chaves, em vez de com credenciais não seguras e codificadas. Essa abordagem reduz muito a chance de que segredos possam ser vazados acidentalmente.

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

O acesso do agente ao Cofre da Chave e aos recursos de armazenamento de destino é controlado por meio do sistema de autorização RBAC (controle de acesso baseado em função) do Azure. Esse sistema permite definir 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 os pontos de extremidade SMB são criados no portal do Azure. No entanto, qualquer ponto de extremidade criado programaticamente requer que você faça as seguintes atribuições manualmente:

Funções	Recurso
Usuário do Key Vault Secrets	O recurso Key Vault usado para armazenar a credencial da 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 oferece 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 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, você pode transferir arquivos entre computadores que executam o Windows e outros sistemas operacionais não 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 blob do Azure ou compartilhamentos de arquivos do Azure.

Ao contrário do SMB, o NFS não utiliza o conceito de ACL ou autenticação baseada no usuário. Essa diferença permite o acesso aos pontos de extremidade NFS sem a integração do 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 do Blog 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 destinos de compartilhamento de arquivos do Azure, a tabela a seguir identifica 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 dá suporte a cenários de migração usando protocolos NFS e SMB. As etapas para criar ambos os endpoints são semelhantes. O principal diferencial entre a criação de pontos de extremidade habilitados para NFS e SMB é o uso do Cofre de Chaves do Azure para armazenar a credencial compartilhada para recursos SMB. Quando um trabalho de migração é executado, os agentes usam a credencial compartilhada armazenada no Cofre da Chave. O acesso aos segredos do Key Vault é administrado ao atribuir uma 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 lida com locais de origem na forma de compartilhamentos de arquivos. 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 do Azure, navegue até a página do recurso 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 movimentação de armazenamento usam segredos armazenados no Azure Key Vault para se conectar a pontos de extremidade SMB. Ao criar um ponto de extremidade de origem SMB, precisa fornecer tanto o nome do Cofre de Chaves que contém os segredos quanto os nomes dos segredos em si.

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

Depois de selecionar o Cofre de Chaves apropriado, você pode fornecer valores para os campos Selecionar segredo para nome de usuário e Selecionar segredo para senha . 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 Instalar o Azure PowerShell para obter mais ajuda na instalação do 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]"

Conecte-se à sua conta do Azure usando o Connect-AzAccount cmdlet. 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 nuvem. Um aspeto fundamental das migrações de arquivos para o Azure é determinar qual opção de armazenamento do Azure é certa para 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 de destino do Azure certo para o design da sua solução de nuvem, consulte o artigo Noções básicas sobre migração para a nuvem.

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

portal do Azure
PowerShell

No portal do Azure, navegue até a página do recurso 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	Contentor 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	Compartilhamento de arquivos do Azure (SMB)	Atualmente, não há suporte para fontes SMB 1.x e compartilhamentos de arquivos do Azure NFS.
Montagem SMB 2.x e 3.x	Contentor 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	Contentor 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	Compartilhamento de arquivos do Azure (NFS 4.1)	As partilhas de ficheiros do Azure NFS são suportadas com a 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. 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 do Azure, navegue para a página de recurso 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.

No momento, o portal do Azure não oferece suporte à modificação direta de pontos de extremidade provisionados. A descrição de um ponto de extremidade, no entanto, pode ser modificada usando o Azure PowerShell seguindo este exemplo. Os recursos dos endpoints que devem ser atualizados no portal do Azure devem ser apagados e criados novamente.

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 ponto de extremidade usando o portal do Azure, navegue até à página de recurso do 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

Feedback

Esta página foi útil?

Last updated on 2025-10-19