Share via

Vytvoření kontejneru objektů blob pomocí JavaScriptu

  • Článek

Objekty blob ve službě Azure Storage jsou uspořádané do kontejnerů. Před nahráním objektu blob musíte nejprve vytvořit kontejner. Tento článek ukazuje, jak vytvořit kontejnery pomocí klientské knihovny Azure Storage pro JavaScript.

Požadavky

  • Příklady v tomto článku předpokládají, že už máte projekt nastavený pro práci s klientskou knihovnou Azure Blob Storage pro JavaScript. Další informace o nastavení projektu, včetně instalace balíčku, importu modulů a vytvoření autorizovaného objektu klienta pro práci s datovými prostředky, najdete v tématu Začínáme s Azure Blob Storage a JavaScriptem.
  • Autorizační mechanismus musí mít oprávnění k vytvoření kontejneru objektů blob. Další informace najdete v pokynech k autorizaci pro následující operaci rozhraní REST API:

O pojmenování kontejnerů

Název kontejneru musí být platný název DNS, protože je součástí jedinečného identifikátoru URI použitého k adresování kontejneru nebo jeho objektů blob. Při pojmenování kontejneru dodržujte tato pravidla:

  • Názvy kontejnerů můžou mít délku 3 až 63 znaků.
  • Názvy kontejnerů musí začínat písmenem nebo číslicí a můžou obsahovat pouze malá písmena, číslice a pomlčku (-).
  • Po sobě jdoucí pomlčky nejsou v názvech kontejnerů povolené.

Identifikátor URI pro prostředek kontejneru je naformátovaný takto:

https://my-account-name.blob.core.windows.net/my-container-name

Vytvoření kontejneru

Pokud chcete vytvořit kontejner, vytvořte objekt BlobServiceClient nebo Objekt ContainerClient a pak použijte jednu z následujících metod vytvoření:

Kontejnery se vytvářejí okamžitě pod účtem úložiště. Není možné vnořit jeden kontejner pod jiný. Pokud již existuje kontejner se stejným názvem, vyvolá se výjimka.

Následující příklad vytvoří kontejner asynchronně z objektu 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;
}

Principy kořenového kontejneru

Kořenový kontejner s konkrétním názvem $rootumožňuje odkazovat na objekt blob na nejvyšší úrovni hierarchie účtu úložiště. Můžete například odkazovat na objekt blob bez použití názvu kontejneru v identifikátoru URI:

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

Kořenový kontejner musí být explicitně vytvořen nebo odstraněn. Ve výchozím nastavení se nevytvořil jako součást vytváření služby. Kořenový adresář může vytvořit stejný kód zobrazený v předchozí části. Název kontejneru je $root.

Zdroje informací

Další informace o vytvoření kontejneru pomocí klientské knihovny Azure Blob Storage pro JavaScript najdete v následujících zdrojích informací.

Operace rozhraní REST API

Sada Azure SDK pro JavaScript obsahuje knihovny, které jsou postavené na rozhraní Azure REST API a umožňují interakci s operacemi rozhraní REST API prostřednictvím známých paradigmat JavaScriptu. Metody klientské knihovny pro vytvoření kontejneru používají následující operaci rozhraní REST API:

Ukázky kódů

Prostředky klientské knihovny