Поделиться через

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

  • Статья

Большие двоичные объекты в службе хранилища 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 :

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

В следующем примере контейнер создается асинхронно из BlobServiceClient объекта:

async function createContainer(blobServiceClient, containerName){
  
  const containerClient = await blobServiceClient.createContainer(containerName);

  return containerClient;
}

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

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

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

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

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

Ресурсы

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

Примеры кода

Операции REST API

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

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

Связанный контент

  • Эта статья является частью руководства разработчика хранилища BLOB-объектов для JavaScript/Typescript. Дополнительные сведения см. в полном списке статей руководства разработчика по созданию приложения JavaScript/Typescript.