Compartir vía


Herramientas de Azure Storage para el servidor MCP de Azure

El servidor MCP de Azure le permite administrar recursos de Azure Storage, incluidas cuentas de almacenamiento, contenedores, tablas y blobs con mensajes de lenguaje natural. No es necesario recordar una sintaxis de comandos específica.

Azure Storage es la solución de almacenamiento en la nube de Microsoft para escenarios de almacenamiento de datos modernos. Azure Storage ofrece almacenamiento de alta disponibilidad, escalable, duradero y seguro para varios objetos de datos en la nube.

Nota:

Parámetros de herramienta: las herramientas del servidor MCP de Azure definen parámetros para los datos que necesitan para completar las tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan a continuación. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Cuenta: Crear

Cree una nueva cuenta de Azure Storage.

Algunas solicitudes de ejemplo incluyen:

  • Crear cuenta: "Cree una cuenta de almacenamiento denominada "mystorageaccount" en el grupo de recursos "my-resource-group" en la ubicación "eastus".
  • Nuevo almacenamiento: "Configure una nueva cuenta de almacenamiento denominada "datastore2025" en el grupo de recursos "my-resource-group" en la región "westus2".
  • Especifique la SKU y el tipo: "Crear una cuenta de almacenamiento "mydata" en el grupo de recursos "my-resource-group" en la ubicación "eastus" con Standard_GRS".
  • Almacenamiento seguro: "Cree una cuenta de almacenamiento "securestore" en el grupo de recursos "my-resource-group" en la ubicación "centralus" solo con HTTPS".
  • Habilitar Data Lake: "Configurar una cuenta de almacenamiento "datalakeacct" en el grupo de recursos "my-resource-group" en la ubicación "westeurope" con el espacio de nombres jerárquico habilitado".
Parámetro Obligatorio u opcional Description
Grupo de recursos Obligatorio Nombre del grupo de recursos de Azure. Se trata de un contenedor lógico para los recursos de Azure.
Cuenta Obligatorio Nombre de la cuenta de Azure Storage que se va a crear. Debe ser único global, solo de 3 a 24 caracteres, letras minúsculas y números.
Ubicación Obligatorio Región de Azure donde se creará la cuenta de almacenamiento (por ejemplo, eastus, westus2).
SKU Opcional SKU de cuenta de almacenamiento. Valores válidos: Standard_LRS, Standard_GRS, Standard_RAGRS, Standard_ZRS, Premium_ZRSPremium_LRS, , Standard_RAGZRSStandard_GZRS.
Nivel de acceso Opcional Nivel de acceso predeterminado para Blob Storage. Valores válidos: Hot, Cool.
Habilitación del espacio de nombres jerárquico Opcional Si se habilita el espacio de nombres jerárquico (Data Lake Storage Gen2) para la cuenta de almacenamiento.

Sugerencias de anotación de herramientas:

Destructiva: ✅ | Idempotente: ❌ | Open World: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ❌

Cuenta: Obtener detalles

Recupera información detallada sobre las cuentas de Azure Storage, incluidos el nombre de cuenta, la ubicación, la SKU, el tipo, el estado del espacio de nombres jerárquico, la configuración de solo HTTPS y la configuración de acceso público de blobs. Si no se proporciona un nombre de cuenta específico, el comando devolverá los detalles de todas las cuentas de una suscripción.

Algunas solicitudes de ejemplo incluyen:

  • Obtenga los detalles de la cuenta: "Mostrar detalles de la cuenta de almacenamiento "mystorageaccount".
  • Información de la cuenta: "Obtener información sobre mi cuenta de almacenamiento "datastore2025".
  • Ver la configuración de la cuenta: "¿Cuáles son las opciones de la cuenta de almacenamiento "mydata"?"
  • Comprobar las propiedades de la cuenta: "Compruebe las propiedades de la cuenta de almacenamiento "securestore".
  • Metadatos de la cuenta: "Mostrar metadatos para mi cuenta de almacenamiento "datalakeacct".
Parámetro Obligatorio u opcional Description
Cuenta Opcional Nombre de la cuenta de Azure Storage. Este nombre es único para Azure (por ejemplo, "mystorageaccount").

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Contenedor: Creación de un contenedor

Cree un contenedor de blobs con acceso público de blobs opcional.

Algunas solicitudes de ejemplo incluyen:

  • Creación de un contenedor privado: "Cree un contenedor privado denominado "mycontainer" en la cuenta de almacenamiento "mystorageaccount".
  • Nuevo contenedor de blobs privado: "Cree un nuevo contenedor de blobs privado denominado "images" en la cuenta de almacenamiento "mydata".
  • Agregar contenedor privado: "Agregue un contenedor privado denominado "archive" a la cuenta de almacenamiento "contosostore".
  • Configuración del contenedor privado: "Configure un contenedor de blobs privado denominado "logs" en la cuenta de almacenamiento "prodstore".
  • Creación de un contenedor privado (simple): "Cree un contenedor de blobs privado denominado "images" en la cuenta de almacenamiento "mystorageaccount".
  • Creación de un contenedor privado (acceso explícito): "Cree un contenedor de blobs denominado "logs" en la cuenta de almacenamiento "mydata" con el nivel de acceso "privado".
Parámetro Obligatorio u opcional Description
Cuenta Obligatorio Nombre de la cuenta de Azure Storage. Este es el nombre único que eligió para la cuenta de almacenamiento (por ejemplo, "mystorageaccount").
Contenedor Obligatorio Nombre del contenedor al que se va a acceder dentro de la cuenta de almacenamiento.

Sugerencias de anotación de herramientas:

Destructiva: ✅ | Idempotente: ❌ | Open World: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ❌

Contenedor: Obtención de los detalles del contenedor

Use esta herramienta para enumerar todos los contenedores de blobs de la cuenta de almacenamiento o mostrar los detalles de un contenedor de Storage específico. Muestra las propiedades del contenedor, incluidas las directivas de acceso, el estado de concesión y los metadatos. Si no se especifica ningún contenedor, muestra todos los contenedores de la cuenta de almacenamiento.

Algunas solicitudes de ejemplo incluyen:

  • Detalles del contenedor: "Mostrar detalles sobre el contenedor "documents" en mi cuenta de almacenamiento "mystorageaccount".
  • Información del contenedor: "Obtener las propiedades del contenedor "imágenes" en la cuenta de almacenamiento "media_files".
  • Propiedades del contenedor: "¿Cuáles son las opciones de configuración del contenedor de "copias de seguridad"?"
  • Estado del contenedor: "Compruebe la directiva de acceso del contenedor "user_data".
Parámetro Obligatorio u opcional Description
Cuenta Obligatorio Nombre de la cuenta de Azure Storage.
Contenedor Opcional Nombre del contenedor al que se va a acceder.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Blob: obtención de detalles del blob

Use esta herramienta para enumerar los blobs de un contenedor o obtener detalles de un blob específico. Muestra propiedades de blob, como metadatos, tamaño, hora de última modificación y propiedades de contenido. Si no se especifica ningún blob, muestra todos los blobs presentes en el contenedor.

Algunas solicitudes de ejemplo incluyen:

  • Obtenga los detalles del blob: "Mostrar detalles de "file.txt" en el contenedor "documents" en la cuenta de almacenamiento "mystorageaccount".
  • Propiedades del blob: "Obtener propiedades del blob "image1.png" en el contenedor "photos" en la cuenta de almacenamiento "mediafiles".
  • Metadatos de blobs: "¿Cuáles son los metadatos de "backup.zip" en el contenedor "backups" en la cuenta de almacenamiento "mydata"?"
Parámetro Obligatorio u opcional Description
Cuenta Obligatorio Nombre de la cuenta de Azure Storage. Este nombre es único en Azure (por ejemplo, "mystorageaccount").
Contenedor Obligatorio Nombre del contenedor al que se va a acceder dentro de la cuenta de almacenamiento.
Blob Opcional Nombre del blob al que se va a acceder dentro del contenedor. Este nombre incluye la ruta de acceso completa dentro del contenedor (por ejemplo, file.txt o folder/file.txt).

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Open World: ❌ | Solo lectura: ✅ | Secreto: ❌ | Local requerido: ❌

Blob: Upload

Carga un archivo local en un blob de Azure Storage con la opción de sobrescribir si el blob ya existe.

Algunas solicitudes de ejemplo incluyen:

  • Cargue el archivo en blob: "Cargue el archivo local "report.pdf" en el blob "documents/report.pdf" en el contenedor "documents" en la cuenta de almacenamiento "mystorageaccount".
  • Cargar y sobrescribir blob: "Cargar el archivo local "data.csv" en el blob "archive/data.csv" en el contenedor "archive" en la cuenta de almacenamiento "mydata", sobrescribiendo si existe".
  • Sobrescribir blob con archivo: "Sobrescribir blob 'images/photo.jpg' en el contenedor 'images' en la cuenta de almacenamiento 'mediafiles' con el archivo local 'C:\photos\photo.jpg'".
  • Cargue el archivo en el contenedor: "Cargue el archivo local "backup.zip" en el blob "backup.zip" en el contenedor "copias de seguridad" en la cuenta de almacenamiento "securestore".
  • Reemplazar el contenido del blob: "Reemplace el contenido del blob "logs/app.log" en el contenedor "logs" en la cuenta de almacenamiento "prodstore" por el archivo local "app.log".
Parámetro Obligatorio u opcional Description
Cuenta Obligatorio Nombre de la cuenta de Azure Storage. Este es el nombre único que eligió para la cuenta de almacenamiento (por ejemplo, mystorageaccount).
Contenedor Obligatorio Nombre del contenedor al que se va a acceder dentro de la cuenta de almacenamiento.
Blob Obligatorio Nombre del blob al que se va a acceder dentro del contenedor. Debe ser la ruta de acceso completa dentro del contenedor (por ejemplo, file.txt o folder/file.txt).
Ruta de acceso del archivo local Obligatorio Ruta de acceso del archivo local en la que se va a leer o escribir contenido. Esta debe ser la ruta de acceso completa al archivo en el sistema local.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ❌ | Open World: ❌ | Solo lectura: ❌ | Secreto: ❌ | Local requerido: ✅