Configurare l'API REST dell'oggetto in Azure NetApp Files (anteprima)

Azure NetApp Files supporta l'accesso agli oggetti S3 con la funzionalità API REST dell'oggetto . Con la funzionalità API REST per oggetti è possibile connettersi ai servizi, tra cui Ricerca di intelligenza artificiale di Azure, Azure AI Foundry, Azure Databricks, OneLake e altri.

Registrare la funzionalità

La funzionalità API REST dell'oggetto in Azure NetApp Files è attualmente in anteprima. È necessario inviare una richiesta di elenco di attesa per usare la funzionalità DELL'API REST dell'oggetto. L'attivazione richiede circa una settimana. Viene inviata una notifica tramite posta elettronica per confermare la registrazione nell'anteprima.

Creare il certificato autofirmato

È necessario generare un certificato SSL in formato PEM. È possibile creare il certificato SSL nel portale di Azure o con uno script.

Portal

Vedere la documentazione di Azure Key Vault per l'aggiunta di un certificato a Key Vault.

Quando si crea il certificato, assicurarsi di:

• Il tipo di contenuto è impostato su PEM
• Il campo Oggetto è impostato sull'indirizzo IP o sul nome di dominio completo (FQDN) dell'endpoint di Azure NetApp Files usando il formato "CN=<IP or FQDN>"
• la voce Nomi DNS specifica l'indirizzo IP o il nome di dominio completo

Script

Questo script crea un certificato in locale. Impostare il nome CN= del computer sull'indirizzo IP o sul nome di dominio completo (FQDN) dell'endpoint abilitato per l'API REST dell'oggetto. Questo script crea una cartella che include il file PEM e le chiavi private necessarie.

Creare ed eseguire lo script seguente:

#!/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"

Creare un bucket

Per abilitare l'API REST dell'oggetto, è necessario creare un bucket.

1. Nel volume NetApp selezionare Bucket.

2. Per creare un bucket, selezionare +Crea.

3. Specificare le informazioni seguenti per il bucket:

   • Nome

     Specificare il nome del bucket. Per le convenzioni di denominazione, vedere Regole di denominazione e restrizioni per le risorse di Azure .

   • Percorso

     Il percorso della sottodirectory per l'API REST dell'oggetto. Per l'accesso al volume completo, lasciare vuoto questo campo o usare / per la directory principale.

   • ID utente (UID)

     UID usato per leggere il bucket.

   • GID (ID gruppo)

     GID usato per leggere il bucket.

   • Autorizzazioni

     Selezionare Lettura o Lettura/Scrittura.

   

4. Se non è stato specificato un certificato, caricare il file PEM.

   Per caricare un certificato, specificare le informazioni seguenti:

   • Nome di dominio completo

     Immettere il nome di dominio completo.

   • Fonte certificato

     Caricare il certificato appropriato. Sono supportati solo i file PEM.

   Seleziona Salva.

5. Fare clic su Crea.

Dopo aver creato un bucket, è necessario generare le credenziali per accedere al bucket.

Aggiornare l'accesso al bucket

È possibile modificare le impostazioni di gestione degli accessi di un bucket.

1. Nel volume NetApp selezionare Bucket.
2. Selezionare +Crea.
3. Immettere il nome del bucket da modificare.
4. Modificare le impostazioni di gestione degli accessi in base alle esigenze.
5. È possibile modificare l'ID utente, l'ID gruppo, il nome utente (per i volumi SMB o dual-protocol) e le autorizzazioni.
6. Fare clic su Salva per modificare il bucket esistente.

Annotazioni

Non è possibile modificare il percorso di un bucket. Per aggiornare il percorso di un bucket, eliminare e ricreare il bucket con il nuovo percorso.

Generare credenziali

1. Vai al tuo bucket appena creato. Selezionare Genera chiavi.
2. Immettere la durata desiderata della chiave di accesso in giorni e quindi selezionare Genera chiavi. Dopo aver selezionato Genera chiavi, il portale visualizza la chiave di accesso e la chiave di accesso privata.

   Importante

   La chiave di accesso e la chiave di accesso privata vengono visualizzate una sola volta. Archiviare le chiavi in modo sicuro. Non condividere le chiavi di sicurezza.

3. Dopo aver impostato le credenziali, è possibile generare una nuova chiave di accesso e una chiave di accesso privata selezionando il ... menu e quindi selezionando Genera chiavi di accesso. La generazione di nuove chiavi invalida immediatamente le chiavi esistenti.

Eliminare un bucket

L'eliminazione di un bucket è un'operazione permanente. Non è possibile ripristinare il bucket dopo che è stato eliminato.

1. Nell'account NetApp, passare ai Bucket.
2. Selezionare la casella di controllo accanto al bucket da eliminare.
3. Selezionare Elimina.
4. Nella finestra modale, selezionare Elimina per confermare l'eliminazione del bucket.

Passaggi successivi

• Informazioni sull'API REST dell'oggetto
• Connettersi ad Azure Databricks
• Connettersi a un browser S3
• Connettersi a OneLake