Konfigurieren der OBJEKT-REST-API in Azure NetApp Files (Vorschau)

Azure NetApp Files unterstützt den Zugriff auf S3-Objekte mit dem Objekt-REST-API-Feature . Mit dem Objekt-REST-API-Feature können Sie eine Verbindung mit Diensten wie Azure AI Search, Azure AI Foundry, Azure Databricks, OneLake und anderen herstellen.

Registrieren der Funktion

Das Objekt-REST-API-Feature in Azure NetApp Files befindet sich derzeit in der Vorschau. Sie müssen eine Waitlist-Anforderung senden, um das Objekt-REST-API-Feature zu verwenden. Die Aktivierung dauert ungefähr eine Woche. Eine E-Mail-Benachrichtigung wird gesendet, um Ihre Registrierung in der Vorschau zu bestätigen.

Erstellen des selbstsignierten Zertifikats

Sie müssen ein PEM-formatiertes SSL-Zertifikat generieren. Sie können das SSL-Zertifikat im Azure-Portal oder mit einem Skript erstellen.

Portal

Weitere Informationen zum Hinzufügen eines Zertifikats zum Key Vault finden Sie in der Dokumentation zu Azure Key Vault.

Stellen Sie beim Erstellen des Zertifikats Folgendes sicher:

• der Inhaltstyp auf PEM festgelegt ist
• Das Feld "Betreff" ist auf die IP-Adresse oder den vollqualifizierten Domänennamen (FQDN) Ihres Azure NetApp Files-Endpunkts im angegebenen Format "CN=<IP or FQDN>" festgelegt.
• der EINTRAG "DNS Names " gibt die IP-Adresse oder den FQDN an.

Skript

Dieses Skript erstellt ein Zertifikat lokal. Legen Sie den Computernamen CN= auf die IP-Adresse oder den vollqualifizierten Domänennamen (FQDN) für den Objekt-REST-API-fähigen Endpunkt fest. Dieses Skript erstellt einen Ordner, der die erforderlichen PEM-Dateien und privaten Schlüssel enthält.

Erstellen und Ausführen des folgenden Skripts:

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

Erstellen eines Buckets

Um die OBJEKT-REST-API zu aktivieren, müssen Sie einen Bucket erstellen.

1. Wählen Sie in Ihrem NetApp-Volume Buckets aus.

2. Um einen Bucket zu erstellen, wählen Sie +Erstellen aus.

3. Geben Sie die folgenden Informationen für den Bucket an:

   • Name

     Geben Sie den Namen für Ihren Bucket an. Verweisen Sie auf Benennungsregeln und Einschränkungen für Azure-Ressourcen für Benennungskonventionen.

   • Pfad

     Der Unterverzeichnispfad für die OBJEKT-REST-API. Lassen Sie dieses Feld für den vollständigen Volume-Zugriff leer oder verwenden Sie / für das Stammverzeichnis.

   • Benutzer-ID (UID)

     Die UID, die zum Lesen des Buckets verwendet wird.

   • Gruppen-ID (GID)

     Die GID, die zum Lesen des Buckets verwendet wird.

   • Erlaubnisse

     Wählen Sie "Lesen" oder "Lesen/Schreiben" aus.

   

4. Wenn Sie kein Zertifikat angegeben haben, laden Sie Ihre PEM-Datei hoch.

   Um ein Zertifikat hochzuladen, geben Sie die folgenden Informationen an:

   • Vollqualifizierter Domänenname

     Geben Sie den vollqualifizierten Domänennamen ein.

   • Zertifikatquelle

     Laden Sie das entsprechende Zertifikat hoch. Nur PEM-Dateien werden unterstützt.

   Wählen Sie Speichern aus.

5. Wählen Sie "Erstellen" aus.

Nachdem Sie einen Bucket erstellt haben, müssen Sie Anmeldeinformationen generieren, um auf den Bucket zuzugreifen.

Bucketzugriff aktualisieren

Sie können die Zugriffsverwaltungseinstellungen eines Buckets ändern.

1. Wählen Sie in Ihrem NetApp-Volume Buckets aus.
2. Wählen Sie +Erstellen aus.
3. Geben Sie den Namen des Buckets ein, den Sie ändern möchten.
4. Ändern Sie die Zugriffsverwaltungseinstellungen nach Bedarf.
5. Sie können die Benutzer-ID, die Gruppen-ID, den Benutzernamen (für SMB- oder Dualprotokollvolumes) und die Berechtigungen ändern.
6. Klicken Sie auf "Speichern ", um den vorhandenen Bucket zu ändern.

Hinweis

Sie können den Pfad eines Buckets nicht ändern. Um den Pfad eines Buckets zu aktualisieren, löschen Sie den Bucket, und erstellen Sie den Bucket mit dem neuen Pfad erneut.

Anmeldeinformationen generieren

1. Navigieren Sie zu Ihrem neu erstellten Bucket. Wählen Sie "Schlüssel generieren" aus.
2. Geben Sie die gewünschte Lebensdauer des Access-Schlüssels in Tagen ein, und wählen Sie dann "Schlüssel generieren" aus. Nachdem Sie " Schlüssel generieren" ausgewählt haben, zeigt das Portal die Zugriffstaste und den geheimen Zugriffsschlüssel an.

   Von Bedeutung

   Der Zugriffsschlüssel und der geheime Zugriffsschlüssel werden nur einmal angezeigt. Speichern Sie die Schlüssel sicher. Teilen Sie die Schlüssel nicht.

3. Nachdem Sie die Anmeldeinformationen festgelegt haben, können Sie eine neue Zugriffstaste und einen geheimen Zugriffsschlüssel generieren, indem Sie das ... Menü und dann " Zugriffstasten generieren" auswählen. Durch das Generieren neuer Schlüssel werden die vorhandenen Schlüssel sofort ungültig.

Einen Bucket löschen

Das Löschen einer Gruppe ist ein endgültiger Vorgang. Sie können den Bucket nach dem Löschen nicht wiederherstellen.

1. Navigieren Sie in Ihrem NetApp-Konto zu Buckets.
2. Aktivieren Sie das Kontrollkästchen neben dem Bucket, den Sie löschen möchten.
3. Klicken Sie auf Löschen.
4. Wählen Sie im modalen Modus "Löschen" aus, um zu bestätigen, dass Sie den Bucket löschen möchten.

Nächste Schritte

• Grundlegendes zur OBJEKT-REST-API
• Herstellen einer Verbindung mit Azure Databricks
• Herstellen einer Verbindung mit einem S3-Browser
• Herstellen einer Verbindung mit OneLake