Een blobcontainer maken met JavaScript of TypeScript
Blobs in Azure Storage worden georganiseerd in containers. Voordat u een blob kunt uploaden, moet u eerst een container maken. In dit artikel wordt beschreven hoe u containers maakt met de Azure Storage-clientbibliotheek voor JavaScript.
Vereisten
- In de voorbeelden in dit artikel wordt ervan uitgegaan dat u al een project hebt ingesteld voor gebruik met de Azure Blob Storage-clientbibliotheek voor JavaScript. Zie Aan de slag met Azure Blob Storage en JavaScript voor meer informatie over het instellen van uw project, inclusief pakketinstallatie, het importeren van modules en het maken van een geautoriseerd clientobject voor gebruik met gegevensbronnen.
- Het autorisatiemechanisme moet machtigingen hebben om een blobcontainer te maken. Zie de autorisatierichtlijnen voor de volgende REST API-bewerking voor meer informatie:
Over naamgeving van containers
Een containernaam moet een geldige DNS-naam zijn, omdat deze deel uitmaakt van de unieke URI die wordt gebruikt om de container of de bijbehorende blobs te adresseren. Volg deze regels bij het benoemen van een container:
- Containernamen kunnen tussen 3 en 63 tekens lang zijn.
- Containernamen moeten beginnen met een letter of cijfer en mogen alleen kleine letters, cijfers en het streepje (-) bevatten.
- Opeenvolgende streepjes zijn niet toegestaan in containernamen.
De URI voor een containerresource is als volgt ingedeeld:
https://my-account-name.blob.core.windows.net/my-container-name
Een container maken
Als u een container wilt maken, roept u de volgende methode aan vanuit de BlobServiceClient-klasse :
U kunt ook een container maken met behulp van een van de volgende methoden uit de Klasse ContainerClient :
Containers worden direct onder het opslagaccount gemaakt. Het is niet mogelijk om één container onder een andere container te nesten. Er wordt een uitzondering gegenereerd als er al een container met dezelfde naam bestaat.
In het volgende voorbeeld wordt een container asynchroon gemaakt op basis van een BlobServiceClient object:
async function createContainer(blobServiceClient, containerName){
const containerClient = await blobServiceClient.createContainer(containerName);
return containerClient;
}
De hoofdcontainer maken
Een hoofdcontainer fungeert als een standaardcontainer voor uw opslagaccount. Elk opslagaccount kan één hoofdcontainer hebben, die de naam $root moet hebben. De hoofdcontainer moet expliciet worden gemaakt of verwijderd.
U kunt verwijzen naar een blob die is opgeslagen in de hoofdcontainer zonder de naam van de hoofdcontainer op te slaan. Met de hoofdcontainer kunt u verwijzen naar een blob op het hoogste niveau van de opslagaccounthiërarchie. U kunt bijvoorbeeld als volgt verwijzen naar een blob in de hoofdcontainer:
https://accountname.blob.core.windows.net/default.html
Als u de hoofdcontainer wilt maken, roept u een willekeurige create-methode aan en geeft u de containernaam op als $root.
Resources
Zie de volgende resources voor meer informatie over het maken van een container met behulp van de Azure Blob Storage-clientbibliotheek voor JavaScript.
Codevoorbeelden
- Voorbeelden van JavaScript- en TypeScript-code weergeven uit dit artikel (GitHub)
REST API-bewerkingen
De Azure SDK voor JavaScript bevat bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende JavaScript-paradigma's. De clientbibliotheekmethoden voor het maken van een container gebruiken de volgende REST API-bewerking:
Clientbibliotheekbronnen
Gerelateerde inhoud
- Dit artikel maakt deel uit van de ontwikkelaarshandleiding voor Blob Storage voor JavaScript/Typescript. Zie de volledige lijst met artikelen over ontwikkelaarshandleidingen in Uw JavaScript-/Typescript-app bouwen voor meer informatie.