De configuratie van de Object REST API in Azure NetApp Files (proefversie)

2025-10-29

Azure NetApp Files biedt ondersteuning voor toegang tot S3-objecten met de functie object REST API . Met de object REST API-functie kunt u verbinding maken met services zoals Azure AI Search, Azure AI Foundry, Azure Databricks, OneLake en andere.

De functie registreren

De object REST API-functie in Azure NetApp Files is momenteel beschikbaar als preview-versie. U moet een wachtlijstaanvraag indienen om de object REST API-functie te kunnen gebruiken. Activering duurt ongeveer één week. Er wordt een e-mailmelding verzonden om uw inschrijving in de preview te bevestigen.

Het zelfondertekende certificaat maken

U moet een MET PEM geformatteerd SSL-certificaat genereren. U kunt het SSL-certificaat maken in Azure Portal of met een script.

Portal
Script

Raadpleeg de Documentatie van Azure Key Vault voor het toevoegen van een certificaat aan Key Vault.

Zorg er bij het maken van het certificaat voor dat:

het inhoudstype is ingesteld op PEM
het veld Onderwerp is ingesteld op het IP-adres of de FQDN (Fully Qualified Domain Name) van uw Azure NetApp Files-eindpunt met behulp van de indeling "CN=<IP or FQDN>"
de vermelding DNS-namen specificeert het IP-adres of de FQDN

Met dit script wordt lokaal een certificaat gemaakt. Stel de computernaam CN= in op het IP-adres of de volledig gekwalificeerde domeinnaam (FQDN) van uw REST API-compatibele object-eindpunt. Met dit script maakt u een map die het benodigde PEM-bestand en de persoonlijke sleutels bevat.

Maak en voer het volgende script uit:

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

Een bucket maken

Als u de OBJECT REST API wilt inschakelen, moet u een bucket maken.

Selecteer Buckets in uw NetApp-volume.
Als u een bucket wilt maken, selecteert u +Maken.
Geef de volgende informatie op voor de bucket:
- Naam
  
  Geef de naam op voor uw bucket. Raadpleeg naamgevingsregels en -beperkingen voor Azure-resources voor naamconventies.
- Path
  
  Het subdirectorypad voor object REST API. Voor volledige toegang tot het volume laat u dit veld leeg of u gebruikt / voor de hoofdmap.
- Gebruikers-id (UID)
  
  De UID die werd gebruikt om de bucket te lezen.
- Groeps-id (GID)
  
  De GID wordt gebruikt om de bucket te lezen.
- toestemmingen
  
  Selecteer Lezen of Lezen/Schrijven.
Als u geen certificaat hebt opgegeven, uploadt u uw PEM-bestand.

Als u een certificaat wilt uploaden, geeft u de volgende informatie op:
- Volledig gekwalificeerde domeinnaam
  
  Voer de volledig gekwalificeerde domeinnaam in.
- Certificaatbron
  
  Upload het juiste certificaat. Alleen PEM-bestanden worden ondersteund.
Selecteer Opslaan.
Klik op Creëren.

Nadat u een bucket hebt gemaakt, moet u referenties genereren om toegang te krijgen tot de bucket.

Toegang tot buckets bijwerken

U kunt de instellingen voor toegangsbeheer van een bucket wijzigen.

Selecteer Buckets in uw NetApp-volume.
Selecteer +Maken.
Voer de naam in van de bucket die u wilt wijzigen.
Wijzig indien nodig de instellingen voor toegangsbeheer.
U kunt de gebruikers-id, groeps-id, gebruikersnaam (voor SMB- of dual-protocolvolumes) en machtigingen wijzigen.
Klik op Opslaan om de bestaande bucket te wijzigen.

Opmerking

U kunt het pad van een bucket niet wijzigen. Als u het pad van een bucket wilt bijwerken, verwijdert u de bucket en maakt u deze opnieuw met het nieuwe pad.

Referenties genereren

Navigeer naar de zojuist gemaakte bucket. Selecteer Sleutels genereren.
Voer de gewenste levensduur van de Access-sleutel in dagen in en selecteer Sleutels genereren. Nadat u Sleutels genereren hebt geselecteerd, worden in de portal de toegangssleutel en de geheime toegangssleutel weergegeven.

Belangrijk

De toegangssleutel en de geheime toegangssleutel worden slechts eenmaal weergegeven. Sla de sleutels veilig op. Deel de sleutels niet.
Nadat u de referenties hebt ingesteld, kunt u een nieuwe toegangssleutel en geheime toegangssleutel genereren door het ... menu te selecteren en vervolgens toegangssleutels genereren te selecteren. Als u nieuwe sleutels genereert, worden de bestaande sleutels onmiddellijk ongeldig.

Een bucket verwijderen

Het verwijderen van een bucket is een permanente handeling. U kunt de bucket niet herstellen nadat u deze hebt verwijderd.

Navigeer in uw NetApp-account naar Buckets.
Schakel het selectievakje in naast de bucket die u wilt verwijderen.
Selecteer Verwijderen.
In het modale venster, selecteer Verwijderen om te bevestigen dat u de bucket wilt verwijderen.

Volgende stappen

Feedback

Is deze pagina nuttig?