Tworzenie kontenera obiektów blob za pomocą języka JavaScript lub TypeScript
Obiekty blob w usłudze Azure Storage są zorganizowane w kontenery. Przed przekazaniem obiektu blob należy najpierw utworzyć kontener. W tym artykule pokazano, jak tworzyć kontenery za pomocą biblioteki klienta usługi Azure Storage dla języka JavaScript.
Wymagania wstępne
- W przykładach w tym artykule założono, że masz już skonfigurowany projekt do pracy z biblioteką klienta usługi Azure Blob Storage dla języka JavaScript. Aby dowiedzieć się więcej o konfigurowaniu projektu, w tym instalacji pakietu, importowaniu modułów i tworzeniu autoryzowanego obiektu klienta do pracy z zasobami danych, zobacz Rozpoczynanie pracy z usługami Azure Blob Storage i JavaScript.
- Mechanizm autoryzacji musi mieć uprawnienia do tworzenia kontenera obiektów blob. Aby dowiedzieć się więcej, zobacz wskazówki dotyczące autoryzacji dla następującej operacji interfejsu API REST:
Informacje o nazewnictwie kontenerów
Nazwa kontenera musi być prawidłową nazwą DNS, ponieważ stanowi część unikatowego identyfikatora URI używanego do adresowania kontenera lub jego obiektów blob. Postępuj zgodnie z tymi regułami podczas nazewnictwa kontenera:
- Nazwy kontenerów mogą mieć długość od 3 do 63 znaków.
- Nazwy kontenerów muszą zaczynać się literą lub cyfrą i mogą zawierać tylko małe litery, cyfry i znak kreski (-).
- Kolejne znaki kreski nie są dozwolone w nazwach kontenerów.
Identyfikator URI zasobu kontenera jest sformatowany w następujący sposób:
https://my-account-name.blob.core.windows.net/my-container-name
Tworzenie kontenera
Aby utworzyć kontener, wywołaj następującą metodę z klasy BlobServiceClient :
Kontener można również utworzyć przy użyciu jednej z następujących metod z klasy ContainerClient :
Kontenery są tworzone bezpośrednio pod kontem magazynu. Nie można zagnieżdżać jednego kontenera pod drugim. Wyjątek jest zgłaszany, jeśli kontener o tej samej nazwie już istnieje.
Poniższy przykład tworzy kontener asynchronicznie na podstawie BlobServiceClient
obiektu:
async function createContainer(blobServiceClient, containerName){
const containerClient = await blobServiceClient.createContainer(containerName);
return containerClient;
}
Tworzenie kontenera głównego
Kontener główny służy jako domyślny kontener dla konta magazynu. Każde konto magazynu może mieć jeden kontener główny, który musi mieć nazwę $root. Kontener główny musi zostać jawnie utworzony lub usunięty.
Można odwoływać się do obiektu blob przechowywanego w kontenerze głównym bez uwzględniania nazwy głównego kontenera. Kontener główny umożliwia odwołowanie się do obiektu blob na najwyższym poziomie hierarchii konta magazynu. Można na przykład odwołać się do obiektu blob w kontenerze głównym w następujący sposób:
https://accountname.blob.core.windows.net/default.html
Aby utworzyć kontener główny, wywołaj dowolną metodę create i określ nazwę kontenera jako $root.
Zasoby
Aby dowiedzieć się więcej na temat tworzenia kontenera przy użyciu biblioteki klienta usługi Azure Blob Storage dla języka JavaScript, zobacz następujące zasoby.
Przykłady kodu
- Wyświetl przykłady kodu JavaScript i TypeScript z tego artykułu (GitHub)
Operacje interfejsu API REST
Zestaw Azure SDK dla języka JavaScript zawiera biblioteki, które bazują na interfejsie API REST platformy Azure, co umożliwia interakcję z operacjami interfejsu API REST za pomocą znanych paradygmatów języka JavaScript. Metody biblioteki klienta do tworzenia kontenera używają następującej operacji interfejsu API REST:
- Tworzenie kontenera (interfejs API REST)
Zasoby biblioteki klienta
Powiązana zawartość
- Ten artykuł jest częścią przewodnika dla deweloperów usługi Blob Storage dla języka JavaScript/TypeScript. Aby dowiedzieć się więcej, zobacz pełną listę artykułów z przewodnika dla deweloperów na stronie Tworzenie aplikacji JavaScript/TypeScript.