Configuración de la API REST de objetos en Azure NetApp Files (versión preliminar)

Azure NetApp Files admite el acceso a objetos S3 con la característica de API REST de objetos . Con la característica de API REST de objetos, puede conectarse a servicios como Azure AI Search, Azure AI Foundry, Azure Databricks, OneLake y otros.

Registrar la característica

La característica de API REST de objetos de Azure NetApp Files se encuentra actualmente en versión preliminar. Debe enviar una solicitud de lista de espera para usar la característica de API REST de objeto. La activación tarda aproximadamente una semana. Se envía una notificación por correo electrónico para confirmar la inscripción en la versión preliminar.

Creación del certificado autofirmado

Debe generar un certificado SSL con formato PEM. Puede crear el certificado SSL en Azure Portal o con un script.

Portal

Consulte la documentación de Azure Key Vault para agregar un certificado a Key Vault.

Al crear el certificado, asegúrese de:

• el tipo de contenido se establece en PEM.
• El campo Asunto se establece en la dirección IP o en el nombre de dominio completo (FQDN) del punto de conexión de Azure NetApp Files con el formato . "CN=<IP or FQDN>"
• la entrada Nombres DNS especifica la dirección IP o el FQDN.

Script

Este script crea un certificado localmente. Establezca el nombre del equipo CN= en la dirección IP o el nombre de dominio completo (FQDN) del punto de conexión habilitado para la API de REST del objeto. Este script crea una carpeta que incluye el archivo PEM necesario y las claves privadas.

Cree y ejecute el siguiente script:

#!/bin/sh
# Define certificate details 
CERT_DAYS=365 
RSA_STR_LEN=2048 
CERT_DIR="./certs" 
KEY_DIR="./certs/private" 
CN="mylocalsite.local" 

# Create directories if they don't exist 
mkdir -p $CERT_DIR 
mkdir -p $KEY_DIR 

# Generate private key 
openssl genrsa -out $KEY_DIR/server-key.pem $RSA_STR_LEN 

# Generate Certificate Signing Request (CSR) 
openssl req -new -key $KEY_DIR/server-key.pem -out $CERT_DIR/server-req.pem -subj "/C=US/ST=State/L=City/O=Organization/OU=Unit/CN=$CN" 

# Generate self-signed certificate 
openssl x509 -req -days $CERT_DAYS -in $CERT_DIR/server-req.pem -signkey $KEY_DIR/server-key.pem -out $CERT_DIR/server-cert.pem 

echo "Self-signed certificate created at $CERT_DIR/server-cert.pem"

Creación de un cubo

Para habilitar la API REST de objetos, debe crear un cubo.

1. En el volumen de NetApp, seleccione Depósitos.

2. Para crear un cubo, seleccione +Crear.

3. Proporcione la siguiente información para el cubo:

   • Nombre

     Especifique el nombre del cubo. Consulte Reglas de nomenclatura y restricciones para los recursos de Azure para las convenciones de nomenclatura.

   • Camino

     Ruta de acceso del subdirectorio para la API REST de objetos. Para obtener acceso completo al volumen, deje este campo en blanco o use / para el directorio raíz.

   • Id. de usuario (UID)

     UID usado para leer el cubo.

   • Id. de grupo (GID)

     GID usado para leer el cubo.

   • Permisos

     Seleccione Lectura o Lectura escritura.

   

4. Si no ha proporcionado un certificado, cargue el archivo PEM.

   Para cargar un certificado, proporcione la siguiente información:

   • Nombre de dominio plenamente calificado

     Escriba el nombre de dominio completo.

   • Origen del certificado

     Cargue el certificado adecuado. Solo se admiten archivos PEM.

   Haga clic en Guardar.

5. Selecciona Crear.

Después de crear un cubo, debe generar credenciales para acceder al cubo.

Actualizar el acceso al cubo

Puede modificar la configuración de gestión de acceso de un bucket.

1. En el volumen de NetApp, seleccione Depósitos.
2. Seleccione +Crear.
3. Escriba el nombre del cubo que desea modificar.
4. Cambie la configuración de administración de acceso según sea necesario.
5. Puede modificar el identificador de usuario, el identificador de grupo, el nombre de usuario (para volúmenes de protocolo dual o SMB) y los permisos.
6. Haga clic en Guardar para modificar el cubo existente.

Nota:

No se puede modificar el path de un bucket. Para actualizar la ruta de acceso de un cubo, elimine y vuelva a crear el cubo con la nueva ruta de acceso.

Generación de credenciales

1. Vaya al cubo recién creado. Seleccione Generar claves.
2. Escriba la duración de la clave de acceso deseada en días y seleccione Generar claves. Después de seleccionar Generar claves, el portal muestra la clave de acceso y la clave de acceso secreta.

   Importante

   La clave de acceso y la clave de acceso secreta solo se muestran una vez. Almacene las claves de forma segura. No comparta las claves.

3. Después de establecer las credenciales, puede generar una nueva clave de acceso y una clave de acceso secreta seleccionando el ... menú y seleccionando Generar claves de acceso. La generación de nuevas claves invalida inmediatamente las claves existentes.

Eliminar un cubo

La eliminación de un cubo es una operación permanente. No se puede recuperar el cubo después de eliminarlo.

1. En la cuenta de NetApp, vaya a Cubos.
2. Active la casilla situada junto al cubo que desea eliminar.
3. Seleccione Eliminar.
4. En el modal, seleccione Eliminar para confirmar que desea eliminar el cubo.

Pasos siguientes

• Descripción de la API REST de objetos
• Conexión a Azure Databricks
• Conexión a un explorador S3
• Conexión a OneLake