Konfigurace rozhraní REST API objektu ve službě Azure NetApp Files (Preview)

Azure NetApp Files podporuje přístup k objektům S3 pomocí funkce rozhraní REST API objektu . Pomocí funkce REST API objektu se můžete připojit ke službám, jako jsou Azure AI Search, Azure AI Foundry, Azure Databricks, OneLake a další.

Registrace funkce

Funkce rozhraní REST API objektu ve službě Azure NetApp Files je aktuálně ve verzi Preview. Pokud chcete použít funkci REST API objektu, musíte odeslat požadavek na seznam čekání . Aktivace trvá přibližně jeden týden. Odešle se e-mailové oznámení, které potvrdí vaši registraci ve verzi Preview.

Vytvořte samopodepsaný certifikát

Musíte vygenerovat certifikát SSL ve formátu PEM. Certifikát SSL můžete vytvořit na webu Azure Portal nebo pomocí skriptu.

Portal

Informace o přidání certifikátu do služby Key Vault najdete v dokumentaci ke službě Azure Key Vault.

Při vytváření certifikátu se ujistěte, že:

• Typ obsahu je nastavený na PEM.
• Pole Předmět je nastavené na IP adresu nebo plně kvalifikovaný název domény (FQDN) koncového bodu Služby Azure NetApp Files pomocí formátu. "CN=<IP or FQDN>"
• Položka Názvy DNS určuje IP adresu nebo plně kvalifikovaný název domény.

Skript

Tento skript vytvoří certifikát místně. Nastavte název CN= počítače na IP adresu nebo plně kvalifikovaný název domény (FQDN) koncového bodu s povoleným rozhraním REST API objektu. Tento skript vytvoří složku, která obsahuje potřebný soubor PEM a privátní klíče.

Vytvořte a spusťte následující skript:

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

Vytvoření kontejneru

Pokud chcete povolit rozhraní REST API objektu, musíte vytvořit kontejner.

1. Ve svazku NetApp vyberte Buckets.

2. Pokud chcete vytvořit kbelík, vyberte +Vytvořit.

3. Do kontejneru zadejte následující informace:

   • název

     Zadejte název kontejneru. Informace o zásadách vytváření názvů najdete v pravidlech a omezeních pro prostředky Azure .

   • Path

     Cesta k podadresáři objektu REST API. Pro úplný přístup ke svazku ponechte toto pole prázdné nebo použijte / pro kořenový adresář.

   • ID uživatele (UID)

     Identifikátor UID použitý ke čtení kontejneru.

   • ID skupiny (GID)

     GID použitý ke čtení úložiště.

   • Permissions

     Vyberte čtení nebo čtení i zápis.

   

4. Pokud jste certifikát nezadali, nahrajte soubor PEM.

   Pokud chcete nahrát certifikát, zadejte následující informace:

   • Plně kvalifikovaný název domény

     Zadejte plně kvalifikovaný název domény.

   • Zdroj certifikátu

     Nahrajte příslušný certifikát. Podporují se jenom soubory PEM.

   Vyberte Uložit.

5. Vyberte Vytvořit.

Po vytvoření kontejneru je potřeba vygenerovat přihlašovací údaje pro přístup k kontejneru.

Aktualizace přístupu k bucketu

Můžete upravit nastavení správy přístupu k bucketu.

1. Ve svazku NetApp vyberte Buckets.
2. Vyberte +Vytvořit.
3. Zadejte název kontejneru, který chcete upravit.
4. Podle potřeby změňte nastavení správy přístupu.
5. Můžete upravit ID uživatele, ID skupiny, uživatelské jméno (pro svazky SMB nebo svazky se dvěma protokoly) a oprávnění.
6. Chcete-li upravit existující kontejner, klikněte na uložit .

Poznámka:

Cestu kontejneru nelze upravit. Pokud chcete aktualizovat cestu kbelíku, odstraňte a znovu vytvořte kontejner s novou cestou.

Generování přihlašovacích údajů

1. Přejděte do nově vytvořeného kontejneru. Vyberte Vygenerovat klíče.
2. Zadejte životnost požadovaného přístupového klíče ve dnech a pak vyberte Vygenerovat klíče. Po výběru možnosti Vygenerovat klíče se na portálu zobrazí přístupový klíč a tajný přístupový klíč.

   Důležité

   Přístupový klíč a tajný přístupový klíč se zobrazí jenom jednou. Bezpečně ukládejte klíče. Klíče nesdílejte.

3. Po nastavení přihlašovacích údajů můžete vygenerovat nový přístupový klíč a tajný přístupový klíč výběrem ... nabídky a následným výběrem možnosti Vygenerovat přístupové klíče. Generování nových klíčů okamžitě zneplatní stávající klíče.

Odstranění kontejneru

Odstranění kontejneru je trvalá operace. Kontejner se po odstranění nedá obnovit.

1. V účtu NetApp přejděte na Buckets.
2. Zaškrtněte políčko vedle kontejneru, který chcete odstranit.
3. Vyberte Odstranit.
4. V modálním okně vyberte Odstranit a potvrďte, že chcete kontejner odstranit.

Další kroky

• Porozumět objektu v rámci REST API
• Připojení k Azure Databricks
• Připojení k prohlížeči S3
• Připojení k OneLake