Dela via

Kom igång med Azure Blob Storage och JavaScript eller TypeScript

  • Artikel

Den här artikeln visar hur du ansluter till Azure Blob Storage med hjälp av Azure Blob Storage-klientbiblioteket för JavaScript. När du är ansluten använder du utvecklarguiderna för att lära dig hur din kod kan fungera på containrar, blobar och funktioner i Blob Storage-tjänsten.

Om du vill börja med ett fullständigt exempel kan du läsa snabbstarten för klientbiblioteket för JavaScript eller TypeScript.

API-referenspaket (npm) | Exempel på källkod | | för bibliotek Ge feedback |

Förutsättningar

Konfigurera projektet

Det här avsnittet beskriver hur du förbereder ett projekt för att arbeta med Azure Blob Storage-klientbiblioteket för JavaScript.

Öppna en kommandotolk och gå till projektmappen. Ändra <project-directory> till mappnamnet:

cd <project-directory>

Om du inte redan har en package.json fil i katalogen initierar du projektet för att skapa filen:

npm init -y

Från projektkatalogen installerar du paket för Azure Blob Storage- och Azure Identity-klientbiblioteken npm install med hjälp av kommandona eller yarn add . Det @azure/identitetspaketet behövs för lösenordslösa anslutningar till Azure-tjänster.

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

Auktorisera åtkomst och ansluta till Blob Storage

Om du vill ansluta en app till Blob Storage skapar du en instans av klassen BlobServiceClient . Det här objektet är startpunkten för att interagera med dataresurser på lagringskontonivå. Du kan använda den för att arbeta med lagringskontot och dess containrar. Du kan också använda tjänstklienten för att skapa containerklienter eller blobklienter, beroende på vilken resurs du behöver arbeta med.

Mer information om hur du skapar och hanterar klientobjekt, inklusive metodtips, finns i Skapa och hantera klientobjekt som interagerar med dataresurser.

Du kan auktorisera ett BlobServiceClient objekt med hjälp av en Microsoft Entra-auktoriseringstoken, en kontoåtkomstnyckel eller en signatur för delad åtkomst (SAS). För optimal säkerhet rekommenderar Microsoft att du använder Microsoft Entra-ID med hanterade identiteter för att auktorisera begäranden mot blobdata. Mer information finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra-ID.

Om du vill auktorisera med Microsoft Entra-ID måste du använda ett säkerhetsobjekt. Vilken typ av säkerhetsobjekt du behöver beror på var appen körs. Använd följande tabell som en guide:

Var appen körs Säkerhetsobjekt Vägledning
Lokal dator (utveckla och testa) Tjänstens huvudnamn Information om hur du registrerar appen, konfigurerar en Microsoft Entra-grupp, tilldelar roller och konfigurerar miljövariabler finns i Auktorisera åtkomst med utvecklartjänstens huvudnamn
Lokal dator (utveckla och testa) Användaridentitet Information om hur du konfigurerar en Microsoft Entra-grupp, tilldelar roller och loggar in på Azure finns i Auktorisera åtkomst med autentiseringsuppgifter för utvecklare
Värdhanterad i Azure Hanterad identitet Information om hur du aktiverar hanterad identitet och tilldelar roller finns i Auktorisera åtkomst från Azure-värdbaserade appar med hjälp av en hanterad identitet
Värdhanterad utanför Azure (till exempel lokala appar) Tjänstens huvudnamn Information om hur du registrerar appen, tilldelar roller och konfigurerar miljövariabler finns i Auktorisera åtkomst från lokala appar med hjälp av ett huvudnamn för programtjänsten

Auktorisera åtkomst med defaultAzureCredential

Ett enkelt och säkert sätt att auktorisera åtkomst och ansluta till Blob Storage är att hämta en OAuth-token genom att skapa en DefaultAzureCredential-instans . Du kan sedan använda den autentiseringsuppgiften för att skapa ett BlobServiceClient objekt.

I följande exempel skapas ett BlobServiceClient objekt med :DefaultAzureCredential

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

Det här kodexemplet kan användas för JavaScript- eller TypeScript-projekt.

Skapa appen

När du skapar appar för att arbeta med dataresurser i Azure Blob Storage interagerar koden främst med tre resurstyper: lagringskonton, containrar och blobar. Mer information om dessa resurstyper, hur de relaterar till varandra och hur appar interagerar med resurser finns i Förstå hur appar interagerar med Blob Storage-dataresurser.

Följande guider visar hur du kommer åt data och utför specifika åtgärder med hjälp av Azure Storage-klientbiblioteket för JavaScript:

Guide beskrivning
Konfigurera en återförsöksprincip Implementera återförsöksprinciper för klientåtgärder.
Kopiera blobar Kopiera en blob från en plats till en annan.
Skapa en container Skapa blobcontainrar.
Skapa en SAS för användardelegering Skapa en SAS för användardelegering för en container eller blob.
Skapa och hantera bloblån Upprätta och hantera ett lås på en blob.
Skapa och hantera containerlån Upprätta och hantera ett lås på en container.
Ta bort och återställa Ta bort blobar och återställ mjukt borttagna blobar.
Ta bort och återställa containrar Ta bort containrar och återställ mjukt borttagna containrar.
Ladda ned blobar Ladda ned blobar med hjälp av strängar, strömmar och filsökvägar.
Hitta blobar med taggar Ange och hämta taggar och använd taggar för att hitta blobar.
Lista blobar Lista blobar på olika sätt.
Lista containrar Visa en lista över containrar i ett konto och de olika alternativ som är tillgängliga för att anpassa en lista.
Hantera egenskaper och metadata (blobar) Hämta och ange egenskaper och metadata för blobar.
Hantera egenskaper och metadata (containrar) Hämta och ange egenskaper och metadata för containrar.
Prestandajustering för dataöverföringar Optimera prestanda för dataöverföringsåtgärder.
Ange eller ändra åtkomstnivån för en blob Ange eller ändra åtkomstnivån för en blockblob.
Ladda upp blobar Lär dig hur du laddar upp blobar med hjälp av strängar, strömmar, filsökvägar och andra metoder.