Administración de puntos de conexión de Azure Storage Mover

Aunque el término punto de conexión se usa a menudo en las redes, se usa en el contexto del servicio Storage Mover para describir una ubicación de almacenamiento con un alto nivel de detalle.

Un punto de conexión de Storage Mover es un recurso que contiene la ruta de acceso a una ubicación origen o destino y otro tipo de información relevante. Los puntos de conexión se usan en la creación de una definición de trabajo para definir las ubicaciones de origen y destino de una operación de copia determinada. Solo se pueden usar determinados tipos de puntos de conexión como origen o destino, respectivamente. Azure Storage Mover admite actualmente los siguientes escenarios:

Migrar desde un recurso compartido de sistema de archivos de red (NFS) local a un a un contenedor de Azure Blob
Migrar desde el origen del bloque de mensajes del servidor (SMB) al recurso compartido de archivos de Azure SMB o al a un contenedor de Azure Blob
Migración del origen NFS al recurso compartido de archivos de Azure NFSv4.1

Este artículo le guía por la creación y administración de puntos de conexión de Azure Storage Mover. Para seguir estos ejemplos, necesita un recurso de transferencia de almacenamiento de alto nivel. Si no ha creado uno, siga los pasos descritos en el artículo Creación de un recurso de Storage Mover antes de continuar.

Después de completar los pasos de este artículo, podrá crear y administrar puntos de conexión mediante Azure Portal y Azure PowerShell.

Introducción a los recursos de punto de conexión

Dentro de la jerarquía de recursos de Azure Storage Mover, se usa un proyecto de migración para organizar los trabajos de migración en tareas lógicas o componentes. A su vez, un proyecto de migración contiene al menos una definición de trabajo, que describe las ubicaciones de origen y destino del proyecto de migración. El artículo Descripción de la jerarquía de recursos de Storage Mover contiene información más detallada sobre las relaciones entre un objeto Storage Mover, sus puntos de conexión y sus proyectos.

Dado que una migración requiere un origen y un destino bien definidos, los extremos están vinculados al recurso de transferencia de almacenamiento de nivel más alto. Esta ubicación permite reutilizar puntos de conexión en cualquier número de definiciones de trabajo. Aunque solo existe un único recurso de punto de conexión, las propiedades de cada punto de conexión individual pueden variar en función de su tipo. Por ejemplo, los recursos compartidos NFS, los recursos compartidos SMB y los puntos de conexión de contenedores de blob de Azure requieren información fundamentalmente diferente.

La versión actual de Azure Storage Mover admite migraciones de fidelidad completa para combinaciones específicas de pares de destino de origen. Use siempre la versión más reciente del agente para beneficiarse de estos orígenes y destinos admitidos:

Protocolo de origen	Objetivo	Comentarios
AWS S3	Contenedor de blobs de Azure	No se pueden migrar los cubos de AWS (Amazon Web Services) S3 con clases de almacenamiento Glacier o Glacier Deep Archive.
Montaje SMB 2.x y 3.x	Recurso compartido de archivos de Azure (SMB)	Actualmente no se admiten orígenes SMB 1.x ni recursos compartidos de archivos de Azure NFS.
Montaje SMB 2.x y 3.x	Contenedor de blobs de Azure	Se admiten contenedores con flatnamespace (FNS) y la característica servicio de espacio de nombres jerárquico (HNS) habilitada y se usa el conjunto de API REST de ADLS Gen2 para la migración.
Montaje de NFS 3 y 4	Contenedor de blobs de Azure	Se admiten contenedores con flatnamespace (FNS) y la característica servicio de espacio de nombres jerárquico (HNS) habilitada y se usa el conjunto de API REST de ADLS Gen2 para la migración.
Montaje de NFS 3 y 4	Compartición de archivos de Azure (NFS 4.1)	Las comparticiones de archivos de Azure NFS son compatibles con NFS v3/4.

Puntos de conexión de SMB

SMB usa el concepto de ACL (lista de control de acceso) y la autenticación basada en el usuario para proporcionar acceso a los archivos compartidos para los usuarios seleccionados. Para mantener la seguridad, Storage Mover se basa en la integración de Azure Key Vault para almacenar y controlar de forma segura el acceso a las credenciales de usuario y a otros secretos. Durante una migración, los recursos del agente de almacenamiento mover se conectan a los puntos de conexión de SMB con secretos de Key Vault en lugar de con credenciales codificadas de forma rígida no seguras. Este enfoque reduce considerablemente la posibilidad de que se filtren accidentalmente los secretos.

Una vez configurado el origen del recurso compartido de archivos local, agregue secretos para un nombre de usuario y una contraseña a Key Vault. Debe proporcionar tanto el nombre de Key Vault como el identificador uniforme de recursos (URI) y los nombres o URI de los secretos de credenciales al crear los puntos de conexión de SMB.

El acceso del agente tanto a key Vault como a los recursos de almacenamiento de destino se controla mediante el sistema de autorización RBAC (control de acceso basado en rol) de Azure. Este sistema permite definir el acceso en función de los atributos asociados a identidades administradas, entidades de seguridad y recursos. Es importante tener en cuenta que las asignaciones de roles de RBAC necesarias se aplican automáticamente cuando se crean puntos de conexión SMB en Azure Portal. Sin embargo, cualquier punto de conexión creado mediante programación requiere que realice manualmente las siguientes asignaciones:

Rol	Recurso
Usuario de secretos de Key Vault	El recurso de Key Vault que se usa para almacenar las credenciales de tu fuente de SMB
Colaborador con privilegios de datos de archivos de Storage	Recurso compartido de archivos de destino

Hay muchos casos de uso que requieren conservar valores de metadatos, como marcas de tiempo de archivo y carpeta, ACL y atributos de archivo. Storage Mover admite el mismo nivel de fidelidad de archivos que el recurso compartido de archivos subyacente de Azure. Azure Files admite a su vez un subconjunto de las propiedades del archivo NTFS. En la tabla siguiente se representan metadatos comunes que se migran:

Propiedad de metadatos	Resultado
Estructura de directorios	La estructura de directorios original del origen se conserva en el recurso compartido de destino.
Permisos de acceso	Los permisos en el archivo o directorio de origen se conservan en el recurso compartido de destino.
Vínculos simbólicos	Los vínculos simbólicos del origen se conservan y se asignan en el recurso compartido de destino.
Creación de marca de tiempo	La marca de tiempo de creación original del archivo de origen se conserva en el recurso compartido de destino.
Cambio de marca de tiempo	La marca de tiempo de cambio original del archivo de origen se conserva en el recurso compartido de destino.
Marca de tiempo modificada	La marca de tiempo modificada original del archivo de origen se conserva en el recurso compartido de destino.
Marca de tiempo de último acceso	La última marca de tiempo de acceso no se admite para un archivo o directorio en la compartición de destino.
Otros metadatos	Se conservan otros metadatos del elemento de origen si el recurso compartido de destino lo admite.

Puntos de conexión NFS

Con el protocolo NFS, puede transferir archivos entre equipos que ejecutan Windows y otros sistemas operativos que no son Windows, como Linux o UNIX. La versión de Azure Storage Mover admite migraciones de recursos compartidos NFS en un dispositivo NAS o servidor dentro de la red a un contenedor de blobs de Azure o a recursos compartidos de archivos de Azure.

A diferencia de SMB, NFS no utiliza el concepto de ACL ni la autenticación basada en el usuario. Esta diferencia permite acceder a los puntos de conexión NFS sin la integración de Azure Key Vault. Cualquier punto de conexión creado mediante programación requiere que realice manualmente las siguientes asignaciones:

Rol	Recurso
Blog sobre almacenamiento Datos Colaborador privilegiado	El recurso de contenedor de blobs de destino
Colaborador con privilegios de datos de archivos de Storage	Su recurso de compartición de archivos de destino

Storage Mover procesa los metadatos de forma diferente para los orígenes de montaje NFS y sus homólogos de destino del contenedor de blobs o de recurso compartido de archivos.

En el caso de los destinos de origen de montaje de NFS y contenedor de blobs, en la tabla siguiente se identifican los resultados de los metadatos comunes encontrados durante la migración:

Propiedad de metadatos	Resultado
Estructura de directorios	Los contenedores de blobs no tienen un sistema de archivos tradicional, sino que admiten "carpetas virtuales". La ruta de acceso de un archivo dentro de una carpeta se antepone al nombre de archivo y se coloca en una lista plana dentro del contenedor de blobs. Las carpetas vacías se representan como un blob vacío en el contenedor de destino. Al igual que con los archivos, los metadatos de la carpeta de origen se conservan en el campo de metadatos personalizados de este blob.
Permisos de acceso	Los permisos en el archivo de origen se conservan en metadatos de blobs personalizados, pero no funcionan como lo hacían en el origen.
Vínculos simbólicos	Se migra un archivo de destino si se puede resolver su vínculo simbólico. Un vínculo simbólico que no se puede resolver se registra como un archivo con errores.
Creación de marca de tiempo	La marca de tiempo original del archivo fuente se conserva como metadatos personalizados del blob. La marca de tiempo nativa del blob refleja la hora en la que se migró el archivo.
Cambio de marca de tiempo	La marca de tiempo original del archivo fuente se conserva como metadatos personalizados del blob. No hay ninguna marca de tiempo nativa de blob de este tipo.
Marca de tiempo modificada	La marca de tiempo original del archivo fuente se conserva como metadatos personalizados del blob. La marca de tiempo nativa del blob refleja la hora en la que se migró el archivo.
Marca de tiempo del último acceso	Si existe en el archivo de origen, esta marca de tiempo se conserva como metadatos personalizados de blobs. No hay ninguna marca de tiempo nativa de blob de este tipo.
Otros metadatos	Otros metadatos se conservan en un campo de metadatos personalizado del blob de destino si existe en los elementos de origen. Solo se pueden almacenar 4 KiB de metadatos. Los metadatos de un tamaño mayor no se migran.

En el caso de los orígenes de montaje NFS y los destinos de recursos compartidos de archivos de Azure, en la tabla siguiente se identifican los resultados de los metadatos comunes encontrados durante la migración:

Propiedad de metadatos	Resultado
Estructura de directorios	La estructura de directorios original del origen se conservará en el recurso compartido de destino.
Permisos de acceso	El modo de acceso, los permisos de usuario y grupo se conservarán del archivo o directorio de origen en el recurso compartido de destino.
Vínculos simbólicos	Se omiten los vínculos simbólicos.
Vínculos físicos	El archivo de destino se copiará como archivo normal. Los archivos que son enlaces duros en el origen no estarán vinculados en el destino. El destino recibirá copias completas a pesar del estado del vínculo físico en el origen.
Creación de marca de tiempo	La marca de tiempo de creación original del archivo de origen se conservará en el recurso compartido de destino.
Cambio de marca de tiempo	No se conserva. La semántica de NFS trata ctime como un atributo de solo lectura.
Marca de tiempo modificada	La marca de tiempo modificada original del archivo de origen se conservará en el recurso compartido de destino. En algunos casos en los que la información del directorio se actualiza antes de actualizar los archivos, la "marca de tiempo modificada" en el directorio se reflejará correctamente después de la primera sincronización y no durante la copia inicial.
Marca de tiempo del último acceso	No se conserva. Esta última marca de tiempo de acceso no se admite para un archivo ni un directorio en el recurso compartido de destino.

Crear un punto de conexión

Antes de poder crear una definición de tarea, debe crear puntos de conexión para las fuentes de datos de origen y destino.

Importante

Si no ha implementado un recurso de Storage Mover mediante el proveedor de recursos, deberá crear el recurso de nivel superior antes de intentar los pasos descritos en este ejemplo.

Azure Storage Mover admite escenarios de migración mediante protocolos NFS y SMB. Los pasos para crear ambos puntos de conexión son similares. El diferenciador clave entre la creación de puntos de conexión habilitados para NFS y SMB es el uso de Azure Key Vault para almacenar la credencial compartida para los recursos SMB. Cuando se ejecuta un trabajo de migración, los agentes usan la credencial compartida almacenada en Key Vault. El acceso a los secretos de Key Vault se administra concediéndole una asignación de roles de RBAC a la identidad administrada del agente.

Creación de un punto de conexión de origen

Los puntos de conexión de origen identifican las ubicaciones desde las que se migran los datos. Los puntos de conexión de origen se usan para definir el origen de los datos especificados en el proyecto de migración. Azure Storage Mover controla las ubicaciones de origen en forma de recursos compartidos de archivos. Estas ubicaciones pueden residir en el almacenamiento conectado a la red (NAS), un servidor o incluso en una estación de trabajo. Los protocolos comunes para los recursos compartidos de archivos son SMB y NFS.

En los pasos siguientes se describe el proceso de creación de un punto de conexión de origen.

Azure Portal
PowerShell

En Azure Portal, vaya a la página de recursos de Storage Mover. Seleccione Puntos de conexión de almacenamiento en el panel de navegación para acceder a tus puntos de conexión.

En la página Puntos de conexión de almacenamiento , la vista Puntos de conexión de almacenamiento predeterminados muestra los nombres de los puntos de conexión de origen aprovisionados y un resumen de sus propiedades asociadas. Puede seleccionar puntos de conexión de destino para ver los puntos de conexión de destino correspondientes. También puede filtrar los resultados aún más seleccionando la versión del protocolo o el filtro host y seleccionando la opción adecuada.
Seleccione Crear punto de conexión para expandir el menú Tipo de punto de conexión . Seleccione Crear punto de conexión de origen para abrir el panel Crear punto de conexión de origen, como se muestra en la imagen siguiente.
En el panel Crear punto de extremo de origen, proporcione los valores de Nombre del host o IP y nombre de recurso compartido necesarios. El valor de nombre de host o dirección IP debe ser una dirección IPv4, o un dominio completo o nombre de host.

Importante

En función de la configuración de DNS, es posible que tenga que usar el nombre de dominio completo (FQDN) en lugar del nombre de host.

También puede agregar un valor description opcional de hasta 1024 caracteres de longitud. A continuación, seleccione Versión de protocolo para expandir el menú de selección de protocolo y seleccione la opción adecuada para el destino de origen.

Los agentes de Storage Mover usan secretos almacenados en Key Vault para conectarse a los puntos de conexión de SMB. Al crear un punto de conexión de origen SMB, debe proporcionar tanto el nombre del Key Vault que contiene los secretos como los propios nombres de los secretos.

En primer lugar, seleccione Almacén de claves para expandir el menú y seleccione el nombre del almacén de claves que contiene los secretos. Puede proporcionar un valor con el que filtrar la lista de Almacenes de claves si es necesario.

Después de seleccionar el Key Vault adecuado, puede proporcionar valores para los campos Seleccionar secreto para nombre de usuario y Seleccionar secreto para contraseña. Estos valores se pueden proporcionar proporcionando el URI a los secretos o seleccionando los secretos de una lista. Seleccione el botón Seleccionar secreto para habilitar el menú y seleccione los valores de nombre de usuario y contraseña. Como alternativa, puede habilitar la opción Entrar secreto desde el URI y proporcionar el URI adecuado al nombre de usuario y al secreto de contraseña.

Los valores de host y nombre de recurso compartido se concatenan para formar la ruta de acceso de origen de migración completa. El valor de ruta de acceso se muestra en el campo Ruta de acceso de origen completa . Copie la ruta de acceso proporcionada y compruebe que puede acceder a ella antes de confirmar los cambios. Por último, después de confirmar que todos los valores son correctos y que puede acceder a la ruta de acceso de origen, seleccione Crear para agregar el nuevo punto de conexión.

El nuevo punto de conexión se implementa y ahora aparece en la lista de puntos de conexión de origen, como se muestra en la siguiente imagen de ejemplo.

Se utilizan los cmdlets New-AzStorageMoverSmbEndpoint y New-AzStorageMoverNfsEndpoint para crear un nuevo punto de conexión dentro de un recurso de transferencia de almacenamiento que implementó anteriormente.

Si no ha instalado el 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 el artículo Instalación de Azure PowerShell para obtener más ayuda para instalar Azure PowerShell.

Precaución

No se admite el cambio de nombre de los recursos de punto de conexión. Es una buena idea asegurarse de que ha nombrado el proyecto correctamente, ya que no podrá cambiar gran parte del nombre del punto de conexión después de aprovisionarlo. Sin embargo, puede optar por crear un nuevo punto de conexión con las mismas propiedades y un nombre diferente, como se muestra en una sección posterior. Consulte la convención de nomenclatura de recursos para elegir un nombre admitido.

Siempre es una buena idea crear y usar variables para almacenar cadenas largas o potencialmente complejas.

Importante

En función de la configuración de DNS, es posible que tenga que usar el nombre de dominio completo (FQDN) en lugar del nombre de host.

Copie el bloque de código de ejemplo y proporcione los valores de los parámetros necesarios. El -Description parámetro es opcional y se agrega en la sección Ver y editar las propiedades de un punto de conexión .


## 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]"

Conéctese a su cuenta de Azure mediante el Connect-AzAccount cmdlet . Especifique el identificador de la suscripción proporcionando un valor para el -Subscription parámetro como se muestra en el ejemplo.
```
Connect-AzAccount -Subscription $subscriptionID
```

Una vez que se haya conectado correctamente, puede crear nuevos recursos de punto de conexión de origen. Según sus necesidades, puede usar el New-AzStorageMoverSmbEndpoint cmdlet para crear un punto de conexión SMB, como se muestra en el ejemplo siguiente.


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

Como alternativa, puede crear un nuevo punto de conexión de origen NFS mediante el New-AzStorageMoverNfsEndpoint cmdlet tal como se muestra.


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

La siguiente respuesta de ejemplo contiene la ProvisioningState propiedad , que indica que el punto de conexión se creó correctamente.


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

Creación de un punto de conexión de destino

Los puntos de conexión de destino identifican las ubicaciones a las que se migran los datos. Azure ofrece varios tipos de almacenamiento en la nube. Un aspecto fundamental de las migraciones de archivos a Azure es determinar qué opción de almacenamiento de Azure es la adecuada para los datos. El número de archivos y carpetas, su estructura de directorios, protocolo de acceso, fidelidad de archivos y otros aspectos son entradas importantes en un diseño completo de soluciones en la nube.

Si necesita ayuda para elegir el almacenamiento de destino de Azure adecuado para el diseño de la solución en la nube, consulte el artículo Aspectos básicos de la migración a la nube.

En los pasos siguientes se describe el proceso de creación de un punto de conexión de destino.

Azure Portal
PowerShell

En Azure Portal, vaya a la página de recursos de Storage Mover. Seleccione Puntos de conexión de almacenamiento en el panel de navegación para acceder a tus puntos de conexión.

En la página Puntos de conexión de almacenamiento , la vista Puntos de conexión de almacenamiento predeterminados muestra los nombres de los puntos de conexión de origen aprovisionados y un resumen de sus propiedades asociadas. Seleccione Puntos de conexión de destino para ver los puntos de conexión de destino existentes. Puede filtrar aún más los resultados seleccionando el filtro de la cuenta de almacenamiento y la opción adecuada.
Seleccione Crear punto de conexión para expandir el menú Tipo de punto de conexión . Seleccione Crear punto de conexión de destino para abrir el panel Crear punto de conexión de destino , como se muestra en la imagen siguiente.

En el panel Crear punto de conexión de destino , seleccione la suscripción y la cuenta de almacenamiento de destino en las listas Suscripción y Cuenta de almacenamiento , respectivamente. A continuación, seleccione la opción Tipo de destino correspondiente al punto de conexión de destino.

Protocolo de origen	Objetivo	Comentarios
AWS S3	Contenedor de blobs de Azure	No se pueden migrar los cubos de AWS (Amazon Web Services) S3 con clases de almacenamiento Glacier o Glacier Deep Archive.
Montaje SMB 2.x y 3.x	Recurso compartido de archivos de Azure (SMB)	Actualmente no se admiten orígenes SMB 1.x ni recursos compartidos de archivos de Azure NFS.
Montaje SMB 2.x y 3.x	Contenedor de blobs de Azure	Se admiten contenedores con flatnamespace (FNS) y la característica servicio de espacio de nombres jerárquico (HNS) habilitada y se usa el conjunto de API REST de ADLS Gen2 para la migración.
Montaje de NFS 3 y 4	Contenedor de blobs de Azure	Se admiten contenedores con flatnamespace (FNS) y la característica servicio de espacio de nombres jerárquico (HNS) habilitada y se usa el conjunto de API REST de ADLS Gen2 para la migración.
Montaje de NFS 3 y 4	Compartición de archivos de Azure (NFS 4.1)	Las comparticiones de archivos de Azure NFS son compatibles con NFS v3/4.

En función del tipo de destino que elija, seleccione el contenedor de blobs o el uso compartido de archivos en la lista desplegable correspondiente. Por último, puede agregar un valor description opcional para el destino de hasta 1024 caracteres de longitud y seleccionar Crear para implementar el punto de conexión.

El nuevo punto de conexión se implementa y ahora aparece en la lista de puntos de conexión, como se muestra en la imagen de ejemplo siguiente.

Para crear un nuevo recurso compartido de archivos SMB, use el New-AzStorageMoverAzStorageSmbFileShareEndpoint cmdlet como se muestra en el ejemplo siguiente.


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

Use el New-AzStorageMoverAzStorageContainerEndpoint cmdlet de PowerShell para crear un nuevo contenedor de blobs NFS. En el ejemplo siguiente se proporcionan instrucciones de aprovisionamiento.


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

La siguiente respuesta de ejemplo contiene la ProvisioningState propiedad , que indica que el punto de conexión se creó correctamente.


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

Visualización y edición de las propiedades de un punto de conexión

Según el caso de uso, es posible que tenga que recuperar un punto de conexión específico o una lista completa de todos los recursos del punto de conexión. También es posible que tenga que agregar o editar la descripción de un punto de conexión.

Siga los pasos de esta sección para ver los puntos de conexión accesibles para el recurso de Storage Mover.

Azure Portal
PowerShell

Para crear un punto de conexión mediante Azure Portal, vaya a la página de recursos de Storage Mover . Seleccione Puntos de conexión de almacenamiento en el panel de navegación para acceder a los puntos de conexión de almacenamiento, como se muestra en la imagen de ejemplo.
En la página Puntos de conexión de almacenamiento , la vista Puntos de conexión de almacenamiento predeterminados muestra los nombres de los puntos de conexión de origen aprovisionados y un resumen de sus propiedades asociadas. Para ver el punto de conexión de destino aprovisionado, seleccione Puntos de conexión de destino. Puede filtrar aún más los resultados seleccionando los filtros de protocolo o host y la opción correspondiente.

En este momento, Azure Portal no admite la modificación directa de los puntos de conexión aprovisionados. Sin embargo, la descripción de un punto de conexión se puede modificar mediante Azure PowerShell siguiendo este ejemplo. Los recursos de punto de conexión que requieren la actualización en Azure Portal deben eliminarse y volver a crearse.

Use el Get-AzStorageMoverEndpoint cmdlet para recuperar una lista de recursos de punto de conexión. Opcionalmente, puede proporcionar un -Name valor de parámetro para recuperar un recurso específico. Al llamar al cmdlet sin el parámetro opcional, se devuelve una lista de todos los puntos de conexión aprovisionados asociados al recurso de Storage Mover.

En el ejemplo siguiente se recupera un recurso de proyecto específico especificando el nombre demoTarget.


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

La respuesta de ejemplo contiene las propiedades del proyecto especificadas, incluida la propiedad vacía 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

Puede agregar la descripción que falta al punto de conexión devuelto en el ejemplo anterior mediante la inclusión de un operador de canalización y el cmdlet Update-AzStorageMoverAzStorageSmbFileShareEndpoint. En el ejemplo siguiente se proporciona el valor de punto de conexión del recurso compartido de archivos SMB que falta con el parámetro -Description.


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

La respuesta ahora contiene el valor de propiedad actualizado 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

Eliminar un punto de conexión

La eliminación de un recurso de punto de conexión debe ser una aparición relativamente poco frecuente en el entorno de producción, aunque puede haber ocasiones en las que pueda resultar útil. Para eliminar un recurso de punto de conexión de Storage Mover, siga el ejemplo proporcionado.

Advertencia

La eliminación de un punto de conexión es una acción permanente y no se puede deshacer. Es recomendable asegurarse de que está preparado para eliminar el punto de conexión, ya que no podrá restaurarlo más adelante.

Azure Portal
PowerShell

Para eliminar un punto de conexión mediante el Azure portal, vaya a la página de recursos del Storage Mover. Seleccione Puntos de conexión de almacenamiento en el panel de navegación para acceder a los puntos de conexión, como se indica en la imagen siguiente.
La vista de puntos de conexión de origen predeterminado muestra los nombres de los puntos de conexión de origen aprovisionados y un resumen de sus datos asociados. Puede seleccionar el filtro Puntos de conexión de destino para ver los puntos de conexión de destino correspondientes.

Busque el nombre del punto de conexión que desea eliminar y active la casilla correspondiente. Después de comprobar que ha seleccionado el punto de conexión adecuado, seleccione Eliminar como se muestra en la siguiente imagen.

El nuevo punto de conexión se elimina y ya no aparece en la lista de puntos de conexión, como se muestra en la imagen de ejemplo siguiente.

Use el Remove-AzStorageMoverEndpoint para eliminar permanentemente un recurso de punto de conexión. Proporcione el nombre del punto de conexión con el parámetro -Name, y el grupo de recursos y los nombres de los recursos del movedor de almacenamiento con los parámetros -ResourceGroupName y -StorageMoverName, respectivamente.


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

Pasos siguientes

Cree un proyecto para recopilar las diferentes fuentes compartidas que deben migrarse juntas.

Creación y administración de un proyecto

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-06-09