Tutorial: Uso de las API REST para copiar datos a Azure Data Box Blob Storage

  • Artículo
  • Tiempo de lectura: 10 minutos

En este tutorial se describen los procedimientos para conectarse a Azure Data Box Blob Storage mediante las API REST con http o https. Una vez conectado, también se describen los pasos necesarios para copiar los datos en Data Box Blob Storage y preparar el dispositivo Data Box para su envío.

En este tutorial, aprenderá a:

  • Requisitos previos
  • Conexión a Data Box Blob Storage mediante http o https
  • Copia de datos a un dispositivo Data Box

Requisitos previos

Antes de comenzar, asegúrese de que:

  1. Ha completado el Tutorial: Instalación de un dispositivo Azure Data Box.
  2. Ha recibido su dispositivo Data Box y el estado del pedido en el portal se actualiza a Delivered (Entregado).
  3. Ha revisado los requisitos del sistema para Data Box Blob Storage y está familiarizado con las versiones compatibles de las API, los SDK y las herramientas.
  4. Tiene acceso a un equipo host con los datos que desea copiar en su dispositivo Data Box. El equipo host debe:
    • Ejecutar un sistema operativo admitido.
    • Estar conectado a una red de alta velocidad. Es muy recomendable tener una conexión de 10 GbE como mínimo. Si no hay disponible una conexión de 10 GbE, se puede usar un vínculo de datos de 1 GbE, pero las velocidades de copia se verán afectadas.
  5. Descargue AzCopy 7.1.0 en el equipo host. Usará AzCopy para copiar los datos desde el equipo host a Azure Data Box Blob Storage.

Conexión mediante http o https

Puede conectarse a Data Box Blob Storage mediante http o https.

  • Https es la forma segura y recomendada de conectarse al almacenamiento de blobs de Data Box.
  • Http se utiliza para conectarse en redes de confianza.

Los pasos para conectarse son diferentes cuando se conecta a Data Box Blob Storage mediante http o https.

Conexión mediante http

Estos son los pasos para conectarse a las API REST de Data Box Blob Storage mediante http:

  • Adición de la dirección IP de dispositivo y el punto de conexión de Blob service al host remoto
  • Configuración del software de terceros y comprobación de la conexión

En las secciones siguientes se describen todos estos pasos.

Adición de la dirección IP del dispositivo y el punto de conexión de Blob service

  1. Inicio de sesión en el dispositivo Data Box. Asegúrese de que está desbloqueado.

    Screenshot shows your dashboard with the device displayed as Unlocked.

  2. Vaya a Establecer interfaces de red. Anote la dirección IP del dispositivo de la interfaz de red utilizada para conectar con el cliente.

    Screenshot shows the Network Settings where you can see the I P address.

  3. Vaya a Conectar y copiar y haga clic en REST.

    Screenshot shows the Connect and copy pane where you can select REST as an access setting.

  4. En el cuadro de diálogo Acceder a la cuenta de almacenamiento y cargar datos, copie el valor de Punto de conexión de Blob service.

    Screenshot shows the Access storage account and upload data dialog box where you can copy the Blob Service Endpoint.

  5. Inicie el Bloc de notas como administrador y abra el archivo hosts que se encuentra en C:\Windows\System32\Drivers\etc.

  6. Agregue la entrada siguiente a su archivo hosts: <device IP address> <Blob service endpoint>

  7. Como referencia, utilice la siguiente imagen. Guarde el archivo hosts.

    Screenshot shows a Notepad document with the I P address and blob service endpoint added.

Comprobación de la conexión y configuración del software de asociados

Configuración del software de partner para conectar con el cliente. Para conectar con el software de partner, normalmente necesitaría la información siguiente (puede variar), que se recopila en la página Conectar y copiar de la interfaz de usuario web local del paso anterior:

  • Nombre de la cuenta de almacenamiento
  • Clave de acceso
  • Punto de conexión de Blob service

Para comprobar que la conexión se establece correctamente, use el Explorador de Storage para conectarse a una cuenta de almacenamiento externa. Si no tiene el Explorador de Storage, descárguelo.

Si es la primera vez que usa el Explorador de Storage, deberá realizar los pasos siguientes.

  1. En la barra de comandos superior, vaya a Editar > Azure Stack de destino.

    Screenshot shows Target Azure Stack selected from the Edit menu.

  2. Reinicie el Explorador de Storage para que los cambios surtan efecto.

    Screenshot shows the Restart Now button.

Siga estos pasos para conectarse a la cuenta de almacenamiento y comprobar la conexión.

  1. En el Explorador de Storage, seleccione Connect to Azure Storage (Conectar con Azure Storage). En el cuadro de diálogo Connect to Azure Storage (Conectar con Azure Storage), seleccione Use a storage account name and key (Usar un nombre y una clave de cuenta de almacenamiento).

    Screenshot shows the Connect to Azure Storage dialog box with Use a storage account name and key selected.

  2. Pegue los valores de Account name (Nombre de cuenta) y Account key (Clave de cuenta) (valor de la clave 1 en la página Connect and copy en la interfaz de usuario web local). Seleccione el dominio de puntos de conexión de Storage como Other (enter below) [Otros (indicar a continuación)] y, después, proporcione el punto de conexión de Blob service como se muestra a continuación. Active la opción Use HTTP (Usar HTTP) solo si la transferencia se va a hacer mediante http. Si usa https, deje la opción desactivada. Seleccione Next (Siguiente).

    Screenshot shows the Connect with Name and Key dialog box with values entered.

  3. En el cuadro de diálogo Connection Summary (Resumen de conexiones), compruebe la información proporcionada. Seleccione Conectar.

    Screenshot shows the Connection Summary dialog box with Connect selected.

  4. La cuenta que ha agregado correctamente se muestra en el panel izquierdo del Explorador de Storage, con (External, Other) anexado al nombre. Haga clic en Contenedores de blobs para ver el contenedor.

    Screenshot shows the Explorer menu with Blob Containers selected.

Conexión mediante https

Estos son los pasos para conectarse a las API REST de Azure Blob Storage mediante https:

  • Descarga del certificado desde Azure Portal
  • Importación del certificado en el cliente o el host remoto
  • Adición de la dirección IP del dispositivo y el punto de conexión de Blob service al cliente o al host remoto
  • Configuración del software de terceros y comprobación de la conexión

En las secciones siguientes se describen todos estos pasos.

Descargar certificado

Use Azure Portal para descargar el certificado.

  1. Inicie sesión en Azure Portal.

  2. Vaya a su pedido de Data Box y, a continuación, a General > Detalles del dispositivo.

  3. En Credenciales del dispositivo, vaya a Acceso de API al dispositivo. Haga clic en Descargar. Esta acción descarga un archivo de certificado <nombre del pedido>.cer. Guarde este archivo. Instalará este certificado en el equipo cliente o host que usará para conectarse al dispositivo.

    Download certificate in Azure portal

Importación de certificado

Para acceder al almacenamiento de blobs de Data Box a través de HTTPS, el dispositivo necesita un certificado TLS/SSL. La forma en que este certificado se pone a disposición de la aplicación cliente varía de una aplicación a otra y entre sistemas operativos y distribuciones. Algunas aplicaciones pueden acceder al certificado después de que se importa en el almacén de certificados del sistema, mientras que otras no hacen uso de ese mecanismo.

En esta sección se menciona información específica para algunas aplicaciones. Para más información sobre otras aplicaciones, consulte la documentación de la aplicación y el sistema operativo usado.

Siga estos pasos para importar el archivo .cer en el almacén raíz de un cliente de Windows o Linux. En un sistema Windows, puede usar Windows PowerShell o la interfaz de usuario de Windows Server para importar e instalar el certificado en el sistema.

Use Windows PowerShell

  1. Iniciar una sesión de Windows PowerShell como administrador.

  2. En el símbolo del sistema, escriba:

    Import-Certificate -FilePath C:\temp\localuihttps.cer -CertStoreLocation Cert:\LocalMachine\Root

Uso de la interfaz de usuario de Windows Server

  1. Haga clic con el botón derecho en el archivo .cer y seleccione Instalar certificado. Esta acción inicia el Asistente para importar certificados.

  2. Para Ubicación de almacén, seleccione Equipo local y, después, haga clic en Siguiente.

    Certificate Import Wizard, Windows Server

  3. Seleccione Colocar todos los certificados en el siguiente almacén y, luego, haga clic en Examinar. Navegue al almacén raíz del host remoto y, a continuación, haga clic en Siguiente.

    Certificate Import Wizard, Certificate Store

  4. Haga clic en Finalizar Aparece un mensaje que indica que la importación se ha realizado correctamente.

    Certificate Import Wizard, finish import

Uso de un sistema Linux

El método para importar un certificado varía según la distribución.

Varias, como Ubuntu y Debian, usan el comando update-ca-certificates.

  • Cambie el nombre del archivo de certificado codificado en Base64 para tener una extensión .crt y cópielo en /usr/local/share/ca-certificates directory.
  • Ejecute el comando update-ca-certificates.

Las versiones recientes de RHEL, Fedora y CentOS usan el comando update-ca-trust.

  • Copie el archivo de certificado en el directorio /etc/pki/ca-trust/source/anchors.
  • Ejecute update-ca-trust.

Para más información, consulte la documentación específica para su distribución.

Adición de la dirección IP del dispositivo y el punto de conexión de Blob service

Siga los mismos pasos para agregar la dirección IP del dispositivo y el punto de conexión de Blob service cuando se conecta mediante http.

Configuración del software de partners y comprobación de la conexión

Siga los pasos para configurar el software de asociado que usó durante la conexión mediante http. La única diferencia es que debe dejar la opción Usar http desactivada.

Copia de datos a un dispositivo Data Box

Una vez que esté conectado a Data Box Blob Storage, el siguiente paso es copiar los datos. Antes de copiar los datos, revise las consideraciones siguientes:

  • Al copiar los datos, asegúrese de que el tamaño de los datos se ajusta a los límites descritos en los límites de almacenamiento de Azure y de Data Box.
  • Si los datos que el dispositivo Data Box va a cargar los están cargando a la vez otras aplicaciones fuera del dispositivo Data Box, podría provocar errores en el trabajo de carga y daños en los datos.

Importante

Asegúrese de conservar una copia de los datos de origen hasta que pueda confirmar que Data Box los ha transferido a Azure Storage.

En este tutorial, se usa AzCopy para copiar los datos al Data Box Blob Storage. También puede usar el Explorador de Azure Storage (si lo prefiere una herramienta basada en GUI) o un software de partner para copiar los datos.

El procedimiento de copia incluye los siguientes pasos:

  • Crear un contenedor
  • Cargar el contenido de una carpeta en Data Box Blob Storage
  • Cargar los archivos modificados en Data Box Blob Storage

En las siguientes secciones se describen estos pasos.

Crear un contenedor

El primer paso es crear un contenedor, ya que los blobs siempre se cargan en un contenedor. Los contenedores organizan grupos de blobs de la misma forma que se organizan archivos en las carpetas de un equipo. Siga estos pasos para crear un contenedor de blobs:

  1. Abra el Explorador de Storage.

  2. En el panel izquierdo, expanda la cuenta de almacenamiento en la que desea crear el contenedor de blobs.

  3. Haga clic con el botón derecho en Contenedores de blobs y, en el menú contextual, seleccione Crear contenedor de blobs.

    Blob Containers context menu, Create Blob Container

  4. Aparecerá un cuadro de texto debajo de la carpeta Contenedores de blobs. Escriba el nombre del contenedor de blobs. Para más información sobre las reglas y restricciones en la nomenclatura de los contenedores de blobs, consulte Creación del contenedor y establecimiento de los permisos.

  5. Presione ENTRAR cuando termine para crear el contenedor de blobs o Esc para cancelar la operación. Una vez que el contenedor de blobs se ha creado correctamente, se mostrará en la carpeta Contenedores de blobs de la cuenta de almacenamiento seleccionada.

    Blob container created

Cargar el contenido de una carpeta en Data Box Blob Storage

Use AzCopy para cargar todos los archivos en una carpeta en Blob Storage en Windows o Linux. Para cargar todos los blobs en una carpeta, escriba el siguiente comando de AzCopy:

Linux

azcopy \
    --source /mnt/myfolder \
    --destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ \
    --dest-key <key> \
    --recursive

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /DestKey:<key> /S

Reemplace <key> por la clave de cuenta. Para obtener la clave de cuenta, en Azure Portal, vaya a su cuenta de almacenamiento. Vaya a Configuración > Claves de acceso, seleccione una clave y péguela en el comando de AzCopy.

Si el contenedor de destino especificado no existe, AzCopy lo crea y carga el archivo en él. Actualice la ruta de acceso de origen al directorio de datos y reemplace data-box-storage-account-name en la dirección URL de destino por el nombre de la cuenta de almacenamiento asociada a su dispositivo Data Box.

Para cargar el contenido del directorio especificado repetidamente en Blob Storage, especifique la opción --recursive (Linux) o /S (Windows). Al ejecutar AzCopy con una de estas opciones, se cargan también todas las subcarpetas y sus archivos.

Cargar los archivos modificados en Data Box Blob Storage

Use AzCopy para cargar archivos según la hora de la última modificación. Para probar esto, modifique o cree archivos en el directorio de origen para fines de prueba. Para cargar solo los archivos nuevos o actualizados, agregue el parámetro --exclude-older (Linux) o /XO (Windows) al comando AzCopy.

Si solo desea copiar los recursos de origen que no existen en el destino, especifique ambos parámetros --exclude-older y --exclude-newer (Linux) o /XO y /XN (Windows) en el comando de AzCopy. AzCopy carga solo los datos actualizados, en función de su marca de tiempo.

Linux

azcopy \
--source /mnt/myfolder \
--destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ \
--dest-key <key> \
--recursive \
--exclude-older

Windows

AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /DestKey:<key> /S /XO

Si se han producido errores durante la operación de copia o de conexión, consulte Solución de problemas relacionados con el almacenamiento de blobs de Data Box.

El siguiente paso consiste en preparar el dispositivo para el envío.

Pasos siguientes

En este tutorial, ha obtenido información acerca de varios temas relacionados con Azure Data Box, como:

  • Requisitos previos
  • Conexión a Data Box Blob Storage mediante http o https
  • Copia de datos a un dispositivo Data Box

En el siguiente tutorial aprenderá a enviar su dispositivo Data Box a Microsoft.

Envío de un dispositivo Data Box a Microsoft