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

  • Artículo

Importante

Azure Data Box ahora admite la asignación del nivel de acceso en el nivel de blob. Los pasos incluidos en este tutorial reflejan el proceso de copia de datos actualizado y son específicos de los blobs en bloques.

Si necesitas ayuda para determinar el nivel de acceso adecuado para tus datos de blobs de bloques, consulta la sección Determinar el nivel de acceso adecuado para blobs en bloques. Sigue los pasos que se incluyen en la sección Copia de datos en Azure Data Box para copiar los datos en el nivel de acceso adecuado.

La información contenida en esta sección se aplica a los pedidos realizados después del 1 de abril de 2024.

Precaución

En este artículo se hace referencia a CentOS, una distribución de Linux que está cerca de su estado Final de ciclo vida (EOL). Tenga en cuenta su uso y planeación en consecuencia. Para obtener más información, consulte la Guía de fin de vida de CentOS.

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:

  • Prerrequisitos
  • 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. Completa el Tutorial: Configuración de Azure Data Box.
  2. Has recibido tu dispositivo Data Box y el estado del pedido en el portal se ha actualizado a Entregado.
  3. Has revisado los requisitos del sistema para Data Box Blob Storage y estás familiarizado con las versiones compatibles de las API, los SDK y las herramientas.
  4. Tienes acceso a un equipo host con los datos que quieres copiar en tu 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 resultarán afectadas.
  5. Download AzCopy v10 en el equipo host. AzCopy se usa 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 asociado 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.

    Captura de pantalla que muestra el panel con el dispositivo mostrado como desbloqueado.

  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.

    Captura de pantalla que muestra la configuración de red donde puede ver la dirección IP.

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

    Captura de pantalla que muestra el panel Conectar y copiar, donde puede seleccionar REST como opción de acceso.

  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.

    Captura de pantalla que muestra el cuadro de diálogo Acceder a la cuenta de almacenamiento y cargar datos, en el que puede copiar el punto de conexión de Blob Service.

  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.

    Captura de pantalla que muestra un documento del Bloc de notas con la dirección IP y el punto de conexión de Blob Service agregados.

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 asociado, normalmente necesita 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, debe descargarlo e instalarlo.

La primera vez que usa el Explorador de Storage debe realizar los pasos siguientes:

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

    Captura de pantalla que muestra la opción Target Azure Stack (Azure Stack de destino) seleccionada en el menú Editar.

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

    Captura de pantalla que muestra el botón Reiniciar ahora.

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).

    Captura de pantalla en la que se muestra el cuadro de diálogo

  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).

    Captura de pantalla que muestra el cuadro de diálogo Conectarse con el nombre y la clave con los valores especificados.

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

    Captura de pantalla que muestra el cuadro de diálogo Resumen de conexiones con la opción Conectar seleccionada.

  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.

    Captura de pantalla que muestra el menú Explorador con Contenedores de blobs seleccionados.

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. Este certificado se usa para conectarse a la interfaz de usuario web y a las API de REST de Azure Blob Storage.
  • Importa el certificado en el cliente o el host remoto.
  • Agrega la dirección IP del dispositivo y el punto de conexión de servicio de Blob al cliente o al host remoto.
  • Configura el software de asociado y comprueba 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. Seleccione Descargar. Esta acción descarga un archivo de certificado <nombre del pedido>.cer. Guarda este archivo e instálalo en el equipo host o cliente que uses para conectarte al dispositivo.

    Descarga del certificado en 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, lee 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 Máquina local y, después, Siguiente.

    Asistente para importación de certificados, Windows Server

  3. Seleccione Colocar todos los certificados en el siguiente almacén y, después, Examinar. Navega al almacén raíz del host remoto y, a continuación, selecciona Siguiente.

    Asistente para importación de certificados, almacén de certificados

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

    Asistente para importación de certificados, finalización de importación

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.

Determinación del nivel de acceso adecuado para blobs en bloques

Importante

La información contenida en esta sección se aplica a los pedidos realizados después del 1 de abril de 2024.

Azure Storage permite almacenar datos de blobs en bloque en varios niveles de acceso dentro de la misma cuenta de almacenamiento. Esta capacidad permite organizar y almacenar datos de forma más eficaz en función de la frecuencia con la que se accede a ellos. La tabla siguiente contiene información y recomendaciones sobre los niveles de acceso de Azure Storage.

Nivel Recomendación Procedimiento recomendado
Acceso frecuente Resulta útil para los datos en línea a los que se accede o modifica con frecuencia. Este nivel tiene los costos de almacenamiento más altos, pero los de acceso más bajos. Los datos de este nivel deben estar en uso normal y activo.
Acceso esporádico Resulta útil para los datos en línea a los que se accede o se modifican con poca frecuencia. Este nivel tiene menores costos de almacenamiento y mayores costos de acceso que el nivel de acceso frecuente. Los datos de este nivel deben almacenarse durante al menos 30 días.
Acceso esporádico Útil para datos en línea a los que se accede o se modifican raramente pero que requieren una recuperación rápida. Este nivel tiene menores costos de almacenamiento y mayores costos de acceso que el nivel de acceso esporádico. Los datos de este nivel deben almacenarse durante un mínimo de 90 días.
Archivo Resulta útil para los datos sin conexión a los que rara vez se accede y tiene requisitos de latencia más bajos. Los datos de este nivel deben almacenarse durante un mínimo de 180 días. Los datos eliminados del nivel de archivo en un plazo de 180 días están sujetos a un cargo por eliminación anticipada.

Para obtener más información sobre los niveles de acceso de blob, consulta Niveles de acceso para datos de blob. Para obtener procedimientos recomendados más detallados, consulta Procedimientos recomendados de para usar niveles de acceso de blobs.

Puedes transferir los datos de blobs en bloque al nivel de acceso adecuado copiándolos en la carpeta correspondiente dentro de Data Box. Este proceso se describe con más detalle en la sección Copia de datos en Azure Data Box.

Copia de datos a un dispositivo Data Box

Después de conectarse a uno o varios recursos compartidos de Data Box, el siguiente paso es copiar datos. Antes de comenzar la copia de datos, ten en cuenta las siguientes limitaciones:

  • 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.
  • Las cargas simultáneas por Data Box y otra aplicación que no es de Data Box podrían dar lugar a errores de carga de trabajos y daños en los datos.

Importante

Asegúrate de mantener una copia de los datos de origen hasta que puedas confirmar que los datos se han copiado en Azure Storage.

En este tutorial, se usa AzCopy para copiar los datos al Data Box Blob Storage. Si prefieres una herramienta basada en GUI, también puede usar el Explorador de Azure Storage o un software de asociado 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.

    Menú contextual Contenedores de blob, Crear contenedor de blobs

  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.

    Contenedor de blobs creado

Cargar el contenido de una carpeta en Data Box Blob Storage

Usa 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/ \
    --dest-key <key> \
    --recursive

Windows

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

Reemplace <key> por la clave de cuenta. Para recuperar la clave de la cuenta en Azure Portal, ve a la cuenta de almacenamiento. Selecciona Configuración > Claves de acceso, elige una clave y, a continuación, copia y pega el valor en el comando 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, especifica 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

También puedes utilizar AzCopy para cargar archivos según la hora de la última modificación. Para cargar solo los archivos actualizados o nuevos, agrega el parámetro --exclude-older para Linux o el parámetro /XO para Windows, al comando AzCopy.

Si solo quieres copiar los recursos dentro del origen local que no existen en el destino, especifica los parámetros --exclude-older y --exclude-newer para Linux, o los parámetros /XO y /XN para Windows en el comando AzCopy. AzCopy solo carga los datos actualizados, según lo determinado por su marca de tiempo.

Linux

azcopy \
--source /mnt/myfolder \
--destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/ \
--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/ /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 para copiar datos en Azure Data Box Blob Storage mediante las API de REST
  • Conexión a Data Box Blob Storage mediante http o https
  • Determinación del nivel de acceso adecuado para blobs en bloques
  • 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