Общие сведения о средствах службы хранилища Azure для сервера Azure MCP

Сервер Azure MCP позволяет управлять ресурсами службы хранилища Azure, включая учетные записи хранения, контейнеры, большие двоичные объекты и таблицы с запросами естественного языка.

служба хранилища Azure — это решение облачного хранилища Майкрософт для современных сценариев хранения данных.

Замечание

Параметры средства. Средства Azure MCP Server определяют параметры для данных, необходимых для выполнения задач. Некоторые из этих параметров относятся к каждому инструменту и описаны ниже. Другие параметры являются глобальными и общими для всех инструментов. Дополнительные сведения см. в разделе "Параметры средства".

Учетная запись: создание

Создайте новую учетную запись хранения Azure.

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

Примеры запросов:

  • Создайте учетную запись хранения: "Создайте учетную запись хранения с именем 'mystorageaccount' в группе ресурсов 'my-resource-group' в расположении 'eastus'."
  • С использованием SKU: "Создайте учетную запись хранения 'mydata' в группе ресурсов 'my-resource-group' в регионе 'eastus' с использованием Standard_GRS".
  • Включите функцию Data Lake: "Создайте учетную запись хранения datalakeacct в группе ресурсов 'my-resource-group' в регионе 'westeurope' с включенной иерархической областью имен".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для ресурсов Azure.
Учетная запись хранения Обязательно Глобально уникальное название учетной записи хранения Azure (3–24 символа, только строчные буквы и цифры).
Местоположение Обязательно Регион Azure, в котором Azure создает учетную запись хранения (например, eastus, westus2).
Артикул Необязательно номер SKU учетной записи хранения. Допустимые значения: Standard_LRS, Standard_GRS, Standard_RAGRSStandard_ZRSPremium_LRSPremium_ZRS, . Standard_GZRSStandard_RAGZRS
Уровень доступа Необязательно Уровень доступа по умолчанию для хранилища объектов BLOB. Допустимые значения: Hot, Cool.
Включение иерархического пространства имен Необязательно Следует ли включить иерархическое пространство имен (Data Lake Storage 2-го поколения) для учетной записи хранения.

Проверка успешности. Средство возвращает сведения о созданной учетной записи хранения.

Подсказки по аннотациям инструмента:

Разрушительный: ✅ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Локальность обязательна: ❌

Учетная запись: получение сведений

Извлекает подробные сведения о учетных записях хранения Azure, включая имя учетной записи, расположение, номер SKU, тип, состояние иерархического пространства имен, параметры только HTTPS и конфигурацию общедоступного доступа к BLOB-объектам. Если имя учетной записи не указано, средство возвращает сведения обо всех учетных записях в подписке.

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

Примеры запросов:

  • Получение сведений об учетной записи хранения: "Показать сведения о учетной записи хранения mystorageaccount".
  • Список всех учетных записей: "Какие учетные записи хранения находятся в моей подписке?"
  • Проверьте свойства: "Каковы параметры учетной записи хранения mydata?".
Параметр Обязательно или необязательно Description
Учетная запись хранения Необязательно Глобально уникальное имя учетной записи хранения Azure (например, mystorageaccount).

Проверка успешности. Возвращает JSON со свойствами учетной записи хранения или списком всех учетных записей, если имя не указано.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Контейнер: создание контейнера

Создайте контейнер объектов BLOB с необязательным публичным доступом.

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

Примеры запросов:

  • Создайте контейнер: "Создание частного контейнера с именем mycontainer" в учетной записи хранения mystorageaccount".
  • С уровнем доступа: "Создайте контейнер BLOB с именем 'logs' в учетной записи хранения 'mydata' с уровнем доступа 'приватный'."
Параметр Обязательно или необязательно Description
Учетная запись хранения Обязательно Глобально уникальное имя учетной записи хранения Azure (например, mystorageaccount).
Контейнер Обязательно Имя контейнера, создаваемого в учетной записи хранения.

Проверка успешности. Средство возвращает свойства созданного контейнера.

Подсказки по аннотациям инструмента:

Разрушительный: ✅ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Локальность обязательна: ❌

Контейнер: получение сведений о контейнере

Список всех BLOB-контейнеров в учетной записи хранения или показать сведения о конкретном контейнере. Отображает свойства контейнера, включая политики доступа, состояние аренды и метаданные.

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

Примеры запросов:

  • Получение сведений о контейнере: "Показать сведения о контейнере "документы" в учетной записи хранения mystorageaccount".
  • Список контейнеров: "Какие контейнеры находятся в учетной записи хранения "media_files"?"
  • Проверьте политику доступа: "Проверка политики доступа для контейнера "user_data" в учетной записи хранения Prodstore".
Параметр Обязательно или необязательно Description
Учетная запись хранения Обязательно Глобально уникальное имя учетной записи хранения Azure.
Контейнер Необязательно Имя контейнера. Если имя не указано, средство выводит список всех контейнеров в учетной записи хранения.

Проверка успешности. Возвращает JSON со свойствами контейнера или списком всех контейнеров, если имя не указано.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Большой двоичный объект: получение сведений о большом двоичном объекте

Вывод списка объектов BLOB в контейнере или получение информации о конкретном объекте BLOB. Отображает свойства BLOB-объектов, включая метаданные, размер, время последнего изменения и свойства содержимого.

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

Примеры запросов:

  • Получение сведений о Blob-объектах: "Показать сведения для 'file.txt' в контейнере 'документы' в учетной записи хранилища 'mystorageaccount'."
  • Список блобов: "Какие блобы находятся в контейнере 'фотографии' в учетной записи 'mediafiles'?"
  • Метаданные BLOB-объектов: "Каковы метаданные для «backup.zip» в контейнере «резервные копии» в учетной записи хранения «mydata»?"
Параметр Обязательно или необязательно Description
Учетная запись хранения Обязательно Глобально уникальное имя учетной записи хранения Azure (например, mystorageaccount).
Контейнер Обязательно Имя контейнера в учетной записи облачного хранилища.
Блоб Необязательно Имя большого двоичного объекта в контейнере, включая полный путь (например, file.txt или folder/file.txt). Если имя не указано, инструмент перечисляет все BLOB-объекты в контейнере.

Проверка успешности выполнения: Возвращает JSON со свойствами blob-объектов или список всех blob, если имя не указано.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Blob: загрузка

Отправляет локальный файл в объект BLOB в Azure Storage, если такой объект BLOB не существует.

Необходимые условия: контекст беседы устанавливает глобальные параметры (подписка, проверка подлинности). Вызывающий должен иметь роль вкладчика данных BLOB или эквивалентную роль в учетной записи хранения. Локальный файл должен существовать и быть доступным.

Примеры запросов:

  • Загрузка файла: "Загрузить локальный файл 'report.pdf' в объект 'documents/report.pdf' в контейнере 'документы' в учетной записи хранения 'mystorageaccount'."
  • Отправка и перезапись: "Отправка локального файла data.csv в блоб archive/data.csv в контейнере archive учетной записи хранения mydata, перезаписывая, если такой файл существует".
Параметр Обязательно или необязательно Description
Учетная запись хранения Обязательно Глобально уникальное имя учетной записи хранения Azure (например, mystorageaccount).
Контейнер Обязательно Имя контейнера в учетной записи облачного хранилища.
BLOB Обязательно Имя большого двоичного объекта в контейнере, включая полный путь (например, file.txt или folder/file.txt).
Путь к локальному файлу Обязательно Полный путь к локальному файлу в системе.

Проверка успешности. Средство возвращает время последнего изменения, ETag и хэш содержимого отправленного большого двоичного объекта.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ❌ | Открытый мир: ❌ | Только для чтения: ❌ | Секрет: ❌ | Локальность обязательна: ✅

Таблица: список

Список всех таблиц в учетной записи хранения Azure.

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

Примеры запросов:

  • "Показать все таблицы в учетной записи хранения "dataarchives"
  • Перечислите каждую таблицу в учетной записи хранения "storagesample01"
  • "Получите сведения о таблице «UserLogs» в учетной записи хранения «appstorage01»"
  • "Мне нужно увидеть таблицу с именем InventoryRecords в учетной записи хранения "warehouseacct"
  • "Можно ли предоставить таблицы в учетной записи хранения mystorageaccount"
Параметр Обязательно или необязательно Description
Учетная запись хранения Обязательно Имя учетной записи хранения Azure. Это уникальное имя, выбранное для учетной записи хранения (например, mystorageaccount).

Проверка успешности. Средство возвращает список таблиц в указанной учетной записи хранения.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

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

  • Last updated on