Megosztás a következőn keresztül:

Az Azure Blob Storage és a JavaScript vagy a TypeScript használatának első lépései

  • Cikk

Ez a cikk bemutatja, hogyan csatlakozhat az Azure Blob Storage-hoz az Azure Blob Storage JavaScripthez készült ügyfélkódtárával. A csatlakozás után a fejlesztői útmutatók segítségével megtudhatja, hogyan működhet a kód a Blob Storage szolgáltatás tárolóin, blobokon és funkcióin.

Ha egy teljes példával szeretne kezdeni, tekintse meg az ügyfélkódtár JavaScripthez vagy TypeScripthez készült rövid útmutatóját.

API-referenciacsomag (npm) | Kódtár forráskódminták | | Visszajelzés küldése |

Előfeltételek

A projekt beállítása

Ez a szakasz végigvezeti egy projekt előkészítésén az Azure Blob Storage JavaScripthez készült ügyfélkódtárával való együttműködéshez.

Nyisson meg egy parancssort, és keresse meg a projektmappát. Módosítsa <project-directory> a mappa nevét:

cd <project-directory>

Ha még nem rendelkezik fájllal package.json a címtárban, inicializálja a projektet a fájl létrehozásához:

npm init -y

A projektkönyvtárból telepítse az Azure Blob Storage- és Az Azure Identity-ügyfélkódtárak csomagjait a npm install parancsok vagy yarn add parancsok használatával. A @azure/identitáscsomagra az Azure-szolgáltatásokhoz való jelszó nélküli kapcsolatokhoz van szükség.

npm install @azure/storage-blob @azure/identity

Hozzáférés engedélyezése és csatlakozás a Blob Storage-hoz

Ha egy alkalmazást a Blob Storage-hoz szeretne csatlakoztatni, hozza létre a BlobServiceClient osztály egy példányát. Ez az objektum a kiindulási pont az adaterőforrások tárfiók szintjén való használatához. Használhatja a tárfiókon és annak tárolóin való működéshez. A szolgáltatásügyfél használatával tárolóügyfeleket vagy blobügyfeleket is létrehozhat, attól függően, hogy milyen erőforrással kell dolgoznia.

Ha többet szeretne megtudni az ügyfélobjektumok létrehozásáról és kezeléséről, beleértve az ajánlott eljárásokat, olvassa el az adaterőforrásokat kezelő ügyfélobjektumok létrehozását és kezelését ismertető témakört.

Az objektumokat BlobServiceClient Microsoft Entra engedélyezési jogkivonat, fiókhozzáférési kulcs vagy közös hozzáférésű jogosultságkód (SAS) használatával engedélyezheti. Az optimális biztonság érdekében a Microsoft azt javasolja, hogy felügyelt identitásokkal használja a Microsoft Entra ID-t a blobadatokra vonatkozó kérelmek engedélyezéséhez. További információ: Blobok hozzáférésének engedélyezése a Microsoft Entra-azonosítóval.

A Microsoft Entra-azonosítóval való engedélyezéshez biztonsági tagot kell használnia. Az, hogy milyen típusú biztonsági tagra van szüksége, attól függ, hogy hol fut az alkalmazás. Útmutatóként használja az alábbi táblázatot:

Az alkalmazás futtatásának helye Rendszerbiztonsági tag Útmutató
Helyi gép (fejlesztés és tesztelés) Szolgáltatásnév Az alkalmazás regisztrálásához, a Microsoft Entra-csoport beállításához, a szerepkörök hozzárendeléséhez és a környezeti változók konfigurálásához lásd : Hozzáférés engedélyezése fejlesztői szolgáltatásnevek használatával
Helyi gép (fejlesztés és tesztelés) Felhasználói azonosító A Microsoft Entra-csoport beállításáról, a szerepkörök hozzárendeléséről és az Azure-ba való bejelentkezésről további információt a hozzáférés engedélyezése fejlesztői hitelesítő adatokkal című témakörben talál .
Az Azure-ban üzemeltetve Felügyelt identitás A felügyelt identitás engedélyezéséről és a szerepkörök hozzárendeléséről további információt az Azure által üzemeltetett alkalmazások hozzáférésének engedélyezése felügyelt identitással című témakörben talál .
Az Azure-on kívül üzemeltetett (például helyszíni alkalmazások) Szolgáltatásnév Az alkalmazás regisztrálásához, szerepkörök hozzárendeléséhez és környezeti változók konfigurálásához lásd : Hozzáférés engedélyezése helyszíni alkalmazásokból egy alkalmazásszolgáltatás-egyszerű használatával

Hozzáférés engedélyezése a DefaultAzureCredential használatával

A Blob Storage-hoz való hozzáférés és csatlakozás engedélyezésének egyszerű és biztonságos módja egy OAuth-jogkivonat beszerzése DefaultAzureCredential-példány létrehozásával. Ezután ezzel a hitelesítő adatok használatával létrehozhat egy objektumot BlobServiceClient .

Az alábbi példa egy objektumot hoz létre a BlobServiceClient következő használatával DefaultAzureCredential:

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

Ez a példakód JavaScript- vagy TypeScript-projektekhez használható.

Az alkalmazás fordítása

Amikor az Azure Blob Storage-ban adaterőforrásokkal való együttműködésre hoz létre alkalmazásokat, a kód elsősorban három erőforrástípussal dolgozik: tárfiókokkal, tárolókkal és blobokkal. Ha többet szeretne megtudni ezekről az erőforrástípusokról, az egymáshoz való viszonyukról és az alkalmazások erőforrásokkal való interakciójáról, olvassa el a Blob Storage-adaterőforrásokkal való interakciót ismertető témakört.

Az alábbi útmutatók bemutatják, hogyan férhet hozzá az adatokhoz, és hogyan hajthat végre konkrét műveleteket a JavaScripthez készült Azure Storage-ügyfélkódtár használatával:

Útmutató Leírás
Újrapróbálkozési szabályzat konfigurálása Újrapróbálkozási szabályzatok implementálása az ügyfélműveletekhez.
Blobok másolása Blob másolása egyik helyről a másikra.
Tároló létrehozása Blobtárolók létrehozása.
Felhasználódelegálási SAS létrehozása Hozzon létre egy felhasználódelegálási SAS-t egy tárolóhoz vagy blobhoz.
Blobbérletek létrehozása és kezelése Blob zárolásának létrehozása és kezelése.
Tárolóbérletek létrehozása és kezelése Tároló zárolásának létrehozása és kezelése.
Törlés és visszaállítás Blobok törlése és helyreállíthatóan törölt blobok visszaállítása.
Tárolók törlése és visszaállítása Tárolók törlése és helyreállíthatóan törölt tárolók visszaállítása.
Blobok letöltése Töltse le a blobokat sztringek, streamek és fájlelérési utak használatával.
Blobok keresése címkékkel Címkék beállítása és lekérése, valamint címkék használata a blobok kereséséhez.
Blobok listázása Blobok listázása különböző módokon.
Tárolók listázása Egy fiók tárolóinak listázása és a lista testreszabásához elérhető különféle lehetőségek.
Tulajdonságok és metaadatok (blobok) kezelése Blobok tulajdonságainak és metaadatainak lekérése és beállítása.
Tulajdonságok és metaadatok (tárolók) kezelése Tárolók tulajdonságainak és metaadatainak lekérése és beállítása.
Adatátviteli teljesítmény finomhangolása Az adatátviteli műveletek teljesítményének optimalizálása.
Blob hozzáférési szintjének beállítása vagy módosítása Blokkblob hozzáférési szintjének beállítása vagy módosítása.
Blobok feltöltése Megtudhatja, hogyan tölthet fel blobokat sztringek, streamek, fájlelérési utak és egyéb módszerek használatával.