Инструменты сервера MCP Azure для Azure сетевых ресурсов файлов

Сервер контекста модели Azure (MCP) позволяет управлять общими папками Azure (Майкрософт.FileShares) с помощью запросов естественного языка. Вам не нужно запоминать определенный синтаксис команды.

✔️ Применимо к: файловые ресурсы, созданные с помощью поставщика ресурсов Майкрософт.FileShares (предварительный просмотр)

не применяется к классическим файловым ресурсам, созданным с помощью поставщика ресурсов Майкрософт.Storage

Файлы Azure — это управляемая служба общего доступа к файлам в облаке. Общие папки Azure обеспечивают высокопроизводительное полностью управляемое хранилище для ваших приложений и рабочих нагрузок. Эта статья относится только к общим папкам, созданным с помощью поставщика ресурсов Майкрософт.FileShares (предварительная версия), который в настоящее время доступен только для общих папок сетевой файловой системы (NFS). Он не применяется к классическим общим папкам, созданным с помощью поставщика ресурсов Майкрософт.Storage.

Замечание

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

Получить ограничения

Получение ограничений файлового хранилища для подписки и расположения.

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

  • Покажите мне текущие ограничения на доступ к файлам в регионе "eastus".
  • "Каковы ограничения общей папки для расположения "westeurope?""
  • Получите ограничения общего доступа к файлам для расположения "centralus".
  • Укажите лимиты общего доступа к файлам для расположения "eastus2".
  • "Получение ограничений файлового ресурса для региона Westus".
Параметр Обязательно или необязательно Description
Местоположение Обязательно Имя региона или расположения Azure (например, eastus, westeurope).

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

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

Получение данных об использовании

Получите данные о использовании сетевого диска для подписки и местоположения.

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

  • "Показать мне сведения об использовании общих папок в расположении "eastus".
  • "Я хочу увидеть использование общих папок в регионе "westeurope".
  • Получите статистику использования файловых ресурсов в регионе 'centralus'.
  • "Можно ли предоставить сведения об использовании общих папок в "eastus2"?
  • "Отображение использования файловых ресурсов в регионе Westus".
Параметр Обязательно или необязательно Description
Местоположение Обязательно Имя региона или расположения Azure (например, eastus, westeurope).

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

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

Получение рекомендаций

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

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

  • Получите рекомендации по файловому ресурсу объемом 1000 ГиБ в расположении "eastus".
  • Можно ли дать рекомендации по общей папке объёмом 500 ГиБ в регионе «Западная Европа»?
  • Получение сведений о файловом ресурсе объемом 2000 ГиБ в регионе 'centralus'.
  • Я хочу увидеть рекомендации для файлового хранилища объемом 5000 ГиБ в регионе "eastus2".
  • Получите рекомендации для файлового хранилища объёмом 250 ГиБ в регионе «westus».
Параметр Обязательно или необязательно Description
Местоположение Обязательно Имя региона или расположения Azure (например, eastus, westeurope).
Выделенное хранилище в ГиБ (гибибайты) Обязательно Требуемый размер зарезервированного хранилища разделяемого ресурса в GiB.

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

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

Общая папка: проверка доступности имени

Проверьте, доступно ли имя общей папки в определенном расположении.

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

  • "Можно ли проверить, доступно ли имя общей папки projectdata в расположении "eastus?""
  • "Я хочу узнать, является ли "salesbackup" доступным именем общей папки в "westeurope".
  • Проверьте доступность имени общей папки teamfiles в расположении EastUS.
  • Свободно ли имя «archive2024» для нового ресурса для обмена файлами в регионе WestUS?
  • Проверка того, можно ли использовать "clientdocs" в качестве имени общей папки в расположении "centralus".
Параметр Обязательно или необязательно Description
Имя Обязательно Имя общей папки.
Местоположение Обязательно Имя региона или расположения Azure (например, EastUS, WestEurope).

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

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

Общая папка: создание общей папки

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

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

  • Создайте общую папку с именем "project-data" в группе ресурсов "rg-prod" в расположении "eastus".
  • "Мне нужно создать общую папку с именем backupshare в группе ресурсов "rg-backup" в расположении "westeurope".
  • "Настройте общее хранилище файлов 'userdocs' в группе ресурсов 'rg-dev' в регионе 'centralus'."
  • "Создайте общую папку "archive2024" в группе ресурсов "rg-archive" в расположении "eastus2".
  • Создайте файловое хранилище с именем "mediafiles" в группе ресурсов "rg-media" в регионе "westus".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя Обязательно Имя общей папки.
Местоположение Обязательно Имя региона или расположения Azure (например, EastUS, WestEurope).
Имя точки монтирования Необязательно Имя точки подключения общей папки, как видят конечные пользователи.
Уровень мультимедиа Необязательно Уровень носителей хранилища (например, SSD).
Избыточность Необязательно Уровень избыточности (например, Local, Zone).
Протокол Необязательно Протокол общего доступа к файлам (например, NFS).
Выделенное хранилище в ГиБ (гибибайты) Необязательно Требуемый размер зарезервированного хранилища разделяемого ресурса в GiB.
Подготовленное число операций ввода-вывода в секунду Необязательно Выделенные операции ввода-вывода в секунду.
Подготовленная пропускная способность в MiB на секунду (mebibytes) Необязательно Подготовленная пропускная способность в MiB в секунду.
Доступ к общедоступной сети Необязательно Параметр доступа к общедоступной сети (Enabled или Disabled).
Root squash NFS Необязательно Параметр squash корня NFS (NoRootSquash, RootSquash, или AllSquash).
Разрешенные подсети Необязательно Разделенный запятыми список идентификаторов подсети, разрешенных для доступа к общей папке.
Теги Необязательно Теги ресурсов в формате JSON (например, {"key1":"value1","key2":"value2"}).

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

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

Файловое хранилище: получение доступа к файловому хранилищу

Получение сведений о определенной общей папке или перечисление всех общих папок. Если указать имя, команда возвращает определённый файловый ресурс. В противном случае выводится список всех общих папок в подписке или группе ресурсов.

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

  • "Показать мне все общие папки в группе ресурсов "rg-prod".
  • Список всех общих папок, доступных в группе ресурсов "rg-backup".
  • Получите сведения для общего доступа к файлам «reports2024» в группе ресурсов «rg-production».
  • Можно получить информацию о файловом ресурсе "archive-logs" для группы ресурсов "rg-data"?
  • Мне нужно получить доступ к сетевому ресурсу 'projectfiles' из группы ресурсов 'rg-dev'.
Параметр Обязательно или необязательно Description
Группа ресурсов Необязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя Необязательно Имя общей папки.

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

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

Общая папка: обновление общей папки

Обновите существующий ресурс файлового хранилища Azure. Вы можете обновлять изменяемые свойства, такие как подготовленное хранилище, операции ввода-вывода в секунду (IOPS), пропускная способность и параметры доступа к сети.

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

  • Обновите общую папку с именем "projectdocs" в "группе ресурсов" "rg-prod", чтобы изменить её квоту.
  • "Внесите изменения в общую папку shareddata" в группе ресурсов "rg-backup", обновив параметры доступа".
  • "Применение новых параметров к общей папке "datahub" в группе ресурсов "rg-data" для повышения пропускной способности".
  • Изменение параметров конфигурации для общей папки "prod-share" в группе ресурсов "rg-production".
  • "Мне нужно обновить общую папку "reports2024" в группе ресурсов "rg-analytics".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя Обязательно Имя общей папки.
Выделенное хранилище в ГиБ (гибибайты) Необязательно Требуемый размер зарезервированного хранилища разделяемого ресурса в GiB.
Подготовленное число операций ввода-вывода в секунду Необязательно Выделенные операции ввода-вывода в секунду.
Подготовленная пропускная способность в MiB на секунду (mebibytes) Необязательно Подготовленная пропускная способность в MiB в секунду.
Доступ к общедоступной сети Необязательно Параметр доступа к общедоступной сети (Enabled или Disabled).
NFS root squash Необязательно Параметр squash корня NFS (NoRootSquash, RootSquash, или AllSquash).
Разрешенные подсети Необязательно Разделенный запятыми список идентификаторов подсети, разрешенных для доступа к общей папке.
Теги Необязательно Теги ресурсов в формате JSON (например, {"key1":"value1","key2":"value2"}).

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

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

Общая папка: удаление общей папки

Удалите общую папку безвозвратно. Эту операцию нельзя отменить.

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

  • Удалите общую папку с именем "backup-share" в группе ресурсов "rg-prod".
  • "Удалите общую папку project-files" в группе ресурсов "rg-marketing".
  • "Я хочу удалить общую папку temp-data в группе ресурсов "rg-dev".
  • "Можно ли удалить общую папку "archive-old" в группе ресурсов "rg-archive?""
  • "Удалите общую папку "cleanup-share" из группы ресурсов "rg-cleanup".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя Обязательно Имя общей папки.

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

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

Подключение к частной конечной точке: получение подключения к частной конечной точке

Получение сведений о подключении к определенной частной конечной точке или перечисление всех подключений к частной конечной точке для общей папки. Если вы предоставляете connection-name, команда возвращает определенное соединение. В противном случае выводится список всех подключений.

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

  • Перечислить все подключения к частным конечным точкам для файлового хранилища 'projectfiles' в группе ресурсов 'rg-prod'.
  • Получите подключение к частной конечной точке с именем "myconnection" для файловой общей папки "datashare" в группе ресурсов "rg-data".
  • "Показать подключения частной конечной точки к общей папке "backupshare" в группе ресурсов "rg-backup".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя общей папки Обязательно Имя общей папки.
Имя подключения Необязательно Имя подключения частной конечной точки.

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

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

Подключение к частной конечной точке: обновление подключения частной конечной точки

Обновите статус подключения приватной конечной точки для общего доступа к файлам. Используйте эту операцию для утверждения или отклонения запросов на подключение к частной конечной точке.

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

  • Подтвердите подключение частной конечной точки 'myconnection' для файлового хранилища 'projectfiles' в группе ресурсов 'rg-prod'.
  • "Отклоните подключение частной конечной точки с именем extconnection в общей папке "datashare" в группе ресурсов "rg-data" с описанием "Не авторизовано".
  • Обновите подключение частной конечной точки 'pendingconn' до 'Утверждено' для файлового хранилища 'backupshare' в группе ресурсов 'rg-backup'.
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя общей папки Обязательно Имя общей папки.
Имя подключения Обязательно Имя подключения частной конечной точки.
Статус Обязательно Состояние подключения (Approved, Rejectedили Pending).
Описание Необязательно Описание изменения состояния подключения.

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

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

Моментальный снимок общего доступа к файлам: создание снимка

Создайте моментальный снимок Azure общей папки. Моментальные снимки — это копии только для чтения на определенный момент времени, используемые для резервного копирования и восстановления.

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

  • Создание моментального снимка с именем backup-snap-jan23 для файлового ресурса "backups" в группе ресурсов "rg-data-prod"
  • "Я хочу создать моментальный снимок с именем project-snapshot для общей папки "projectfiles" в группе ресурсов "rg-marketing"
  • Создание моментального снимка с именем "еженедельное резервное копирование" для общей папки "companyshare" в группе ресурсов "rg-finance"
  • Создайте моментальный снимок с именем "reports-snapshot" в файловом хранилище "отчеты" в группе ресурсов "rg-analytics"
  • Инициирование создания моментального снимка с именем dev-snapshot-01 для файлового ресурса devfiles в группе ресурсов rg-development»
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя общей папки Обязательно Имя родительского файлового ресурса.
Имя моментального снимка Обязательно Имя моментального снимка.
Метаданные Необязательно Пользовательские метаданные для моментального снимка в виде объекта JSON (например, {"key1":"value1","key2":"value2"}).

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

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

Моментальный снимок общей папки: получение моментального снимка

Получение сведений о конкретном моментальном снимке общей папки или списке всех моментальных снимков. Если указать имя моментального снимка, команда возвращает определенный моментальный снимок. В противном случае выводится список всех моментальных снимков для общей папки.

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

  • Показать мне все моментальные снимки для файлового ресурса "projectfileshare" в группе ресурсов "rg-prod".
  • Список моментальных снимков, доступных в общей папке Teamdata в группе ресурсов "rg-finance".
  • Получите моментальный снимок с именем "snapshot20240601" из общей папки backupshare в группе ресурсов rg-backup.
  • "Получение сведений о моментальном снимке "dailybackup" в общей папке "отчеты" в группе ресурсов "rg-analytics".
  • "Мне нужно увидеть моментальный снимок "weekendcopy" из общей папки "mediafiles" в группе ресурсов "rg-media".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя общей папки Обязательно Имя родительского файлового ресурса.
Имя моментального снимка Необязательно Имя моментального снимка.

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

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

Моментальный снимок общей папки: обновление моментального снимка

Обновите свойства и метаданные моментального снимка Azure общей папки, например теги или политики хранения.

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

  • Обновление моментального снимка "backup-snap-jan23" для общей папки backupshare в группе ресурсов "rg-backup".
  • Применяйте обновления к моментальному снимку "data-snapshot" в файловом хранилище "datafiles" в группе ресурсов "rg-data".
  • "Можно обновить моментальный снимок "snapshot2024" для общей папки "отчеты" в группе ресурсов "rg-analytics".
  • Обновите снимок с именем «endofmonth» на файловой шару «finance-data» в группе ресурсов «rg-finance».
  • Измените свойства моментального снимка "еженедельная резервная копия" для файловой доли "devfileshare" в группе ресурсов "rg-dev".
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя общей папки Обязательно Имя родительского файлового ресурса.
Имя моментального снимка Обязательно Имя моментального снимка.
Метаданные Необязательно Пользовательские метаданные для моментального снимка в виде объекта JSON (например, {"key1":"value1","key2":"value2"}).

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

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

Моментальный снимок общей папки: удаление моментального снимка

Удалить снимок файлового ресурса навсегда. Отменить эту операцию невозможно.

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

  • Удаление моментального снимка "backup-snap-jan15" из общей папки "datafiles" в группе ресурсов "rg-prod".
  • Удалите моментальный снимок "weekly-backup" из файлового ресурса "backupshare" в группе ресурсов "rg-backup".
  • Удалите снимок "snapshot2024-03-15" из файлового ресурса "отчеты" в группе ресурсов "rg-analytics".
  • Удалите моментальный снимок "dailybackup" из файлового хранилища "projectfiles" в группе ресурсов "rg-dev".
  • Удалите снимок 'weeklysnap' из файловой общей папки 'архив' в группе ресурсов 'rg-archive'.
Параметр Обязательно или необязательно Description
Группа ресурсов Обязательно Имя группы ресурсов Azure. Группа ресурсов — это логический контейнер для Azure ресурсов.
Имя общей папки Обязательно Имя родительского файлового ресурса.
Имя моментального снимка Обязательно Имя моментального снимка.

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

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