Создание контейнера BLOB-объектов с помощью JavaScript

  • Статья

Большие двоичные объекты в службе хранилища Azure упорядочиваются в контейнеры. Прежде чем вы сможете отправить большой двоичный объект, сперва необходимо создать контейнер. В этой статье приводятся сведения о создании контейнеров с помощью клиентской библиотеки службы хранилища Azure для JavaScript.

Предварительные требования

  • В примерах в этой статье предполагается, что у вас уже есть проект, настроенный для работы с клиентской библиотекой Хранилище BLOB-объектов Azure для JavaScript. Дополнительные сведения о настройке проекта, включая установку пакета, импорт модулей и создание авторизованного клиентского объекта для работы с ресурсами данных, см. в статье Начало работы с Хранилище BLOB-объектов Azure и JavaScript.
  • Механизм авторизации должен иметь разрешения на создание контейнера BLOB-объектов. Дополнительные сведения см. в руководстве по авторизации для следующей операции REST API:

Сведения об именовании контейнеров

Имя контейнера должно быть допустимым DNS-именем, поскольку оно является частью уникального URI, используемого для адресации контейнера или его больших двоичных объектов. При присвоении имени контейнеру следуйте нижеприведенным правилам:

  • Имена контейнеров могут содержать от 3 до 63 символов.
  • Имена контейнеров должны начинаться с буквы или цифры и могут содержать только строчные буквы, цифры и тире (-).
  • Последовательные тире не допускаются в именах контейнеров.

Универсальный код ресурса (URI) для ресурса контейнера имеет следующий формат:

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

Создание контейнера

Чтобы создать контейнер, создайте объект BlobServiceClient или объект ContainerClient , а затем используйте один из следующих методов create:

Контейнеры создаются для учетной записи хранилища немедленно. Нельзя вложить один контейнер в другой. Если контейнер с таким именем уже существует, выдается исключение.

В следующем примере контейнер создается асинхронно из 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;
}

Общие сведения о корневом контейнере

Корневой контейнер с определенным именем $root позволяет ссылаться на большой двоичный объект на верхнем уровне иерархии учетной записи хранения. Например, можно ссылаться на большой двоичный объект без использования имени контейнера в универсальном коде ресурса (URI):

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

Корневой контейнер должен быть явным образом создан или удален. Он не создается по умолчанию при создании службы. Код, приведенный в предыдущем разделе, также может создать корень. Контейнер имеет имя $root.

Ресурсы

Дополнительные сведения о создании контейнера с помощью клиентской библиотеки Хранилище BLOB-объектов Azure для JavaScript см. в следующих ресурсах.

Операции REST API

Пакет AZURE SDK для JavaScript содержит библиотеки, которые создаются на основе REST API Azure, что позволяет взаимодействовать с операциями REST API с помощью привычных парадигм JavaScript. Методы клиентской библиотеки для создания контейнера используют следующую операцию REST API:

Примеры кода

Ресурсы клиентской библиотеки