Tworzenie kontenera obiektów blob przy użyciu języka JavaScript

  • Artykuł

Obiekty blob w usłudze Azure Storage są zorganizowane w kontenery. Przed przekazaniem obiektu blob należy najpierw utworzyć kontener. W tym artykule przedstawiono sposób tworzenia kontenerów 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 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 Wprowadzenie do Azure Blob Storage i Języka 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 ona część unikatowego identyfikatora URI używanego do adresowania kontenera lub jego obiektów blob. Postępuj zgodnie z następującymi regułami podczas nazewnictwa kontenera:

  • Nazwy kontenerów mogą zawierać 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, utwórz obiekt BlobServiceClient lub obiekt ContainerClient , a następnie użyj jednej z następujących metod tworzenia:

Kontenery są tworzone natychmiast pod kontem magazynu. Nie można zagnieżdżać jednego kontenera pod innym. Wyjątek jest zgłaszany, jeśli kontener o tej samej nazwie już istnieje.

W poniższym przykładzie kontener jest tworzony asynchronicznie z obiektu BlobServiceClient:

async function createContainer(blobServiceClient, containerName){

  // anonymous access at container level
  const options = {
    access: 'container'
  };

  // creating client also creates container
  const containerClient = await blobServiceClient.createContainer(containerName, options);
  console.log(`container ${containerName} created`);

  // do something with container
  // ...

  return containerClient;
}

Omówienie kontenera głównego

Kontener główny o określonej nazwie $rootumoż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 bez użycia nazwy kontenera w identyfikatorze URI:

https://myaccount.blob.core.windows.net/default.html

Kontener główny musi zostać jawnie utworzony lub usunięty. Nie jest on domyślnie tworzony w ramach tworzenia usługi. Ten sam kod wyświetlany w poprzedniej sekcji może utworzyć katalog główny. Nazwa kontenera to $root.

Zasoby

Aby dowiedzieć się więcej na temat tworzenia kontenera przy użyciu biblioteki klienta Azure Blob Storage dla języka JavaScript, zobacz następujące zasoby.

Operacje interfejsu API REST

Zestaw Azure SDK dla języka JavaScript zawiera biblioteki oparte na interfejsie API REST platformy Azure, które umożliwiają 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:

Przykłady kodu

Zasoby biblioteki klienta