Sdílet prostřednictvím


Přehled nástrojů Azure Storage pro Azure MCP Server

Azure MCP Server umožňuje spravovat prostředky Azure Storage, včetně účtů úložiště, kontejnerů, tabulek a objektů blob s výzvami přirozeného jazyka.

Azure Storage je řešení cloudového úložiště Od Microsoftu pro moderní scénáře ukládání dat.

Poznámka:

Parametry nástroje: Nástroje Azure MCP Serveru definují parametry pro data, která potřebují k dokončení úloh. Některé z těchto parametrů jsou specifické pro každý nástroj a jsou popsané níže. Ostatní parametry jsou globální a sdílejí všechny nástroje. Další informace naleznete v tématu Parametry nástroje.

Účet: Vytvořit

Vytvořte nový účet Azure Storage.

Požadavky: Kontext konverzace vytváří globální parametry (předplatné, skupina prostředků). Volající musí mít v cílovém předplatném roli Přispěvatel účtu úložiště nebo ekvivalentní oprávnění.

Mezi ukázkové výzvy patří:

  • Vytvořte účet úložiště: "Vytvořte účet úložiště s názvem mystorageaccount" ve skupině prostředků my-resource-group v umístění eastus.
  • Se SKU: Vytvořte účet úložiště 'mydata' ve skupině prostředků 'my-resource-group' v umístění 'eastus' se Standard_GRS.
  • Povolte Data Lake: Vytvořte účet úložiště 'datalakeacct' ve skupině prostředků 'my-resource-group' v umístění 'westeurope' s povoleným hierarchickým oborem názvů.
Parameter Povinné nebo volitelné Description
Skupina zdrojů Povinné Název skupiny prostředků Azure Skupina prostředků je logický kontejner pro prostředky Azure.
Účet úložiště Povinné Globálně jedinečný název účtu služby Azure Storage (jenom 3–24 znaků, malá písmena a číslice).
Location Povinné Oblast Azure, ve které Azure vytvoří účet úložiště (například eastus, westus2).
SKU Volitelný Skladová položka účtu úložiště. Platné hodnoty: Standard_LRS, Standard_GRS, Standard_RAGRS, Standard_ZRS, Premium_LRSPremium_ZRS, Standard_GZRS. Standard_RAGZRS
Úroveň přístupu Volitelný Výchozí úroveň přístupu pro úložiště objektů blob. Platné hodnoty: Hot, Cool.
Povolení hierarchického oboru názvů Volitelný Určuje, jestli pro účet úložiště povolíte hierarchický obor názvů (Data Lake Storage Gen2).

Úspěšné ověření: Nástroj vrátí podrobnosti vytvořeného účtu úložiště.

Nápovědy pro poznámky k nástrojům:

Destruktivní: ✅ | Idempotentní: ❌ | Open World: ❌ | Jen pro čtení: ❌ | Tajný kód: ❌ | Místní povinné: ❌

Účet: Získání podrobností

Načte podrobné informace o účtech Azure Storage, včetně názvu účtu, umístění, skladové položky, typu, stavu hierarchického oboru názvů, nastavení pouze HTTPS a konfigurace veřejného přístupu objektu blob. Pokud nezadáte konkrétní název účtu, nástroj vrátí podrobnosti pro všechny účty v předplatném.

Požadavky: Kontext konverzace vytváří globální parametry (předplatné, ověřování). Volající musí mít roli čtenáře účtu úložiště nebo ekvivalentní oprávnění.

Mezi ukázkové výzvy patří:

  • Získejte podrobnosti o účtu úložiště: "Ukáž mi podrobnosti o účtu úložiště 'mystorageaccount'."
  • Uveďte všechny účty: Jaké účty úložiště jsou v mém předplatném?
  • Zkontrolujte vlastnosti: Jaká jsou nastavení účtu úložiště mydata?
Parameter Povinné nebo volitelné Description
Účet úložiště Volitelný Globálně jedinečný název účtu Azure Storage (například mystorageaccount).

Ověření úspěšnosti: Vrátí JSON s vlastnostmi účtu úložiště nebo seznamem všech účtů, pokud nezadáte název.

Nápovědy pro poznámky k nástrojům:

Destruktivní: ❌ | Idempotentní: ✅ | Open World: ❌ | Jen pro čtení: ✅ | Tajný kód: ❌ | Místní povinné: ❌

Kontejner: Vytvoření kontejneru

Vytvořte kontejner objektů blob s volitelným veřejným přístupem k objektům blob.

Požadavky: Kontext konverzace vytváří globální parametry (předplatné, ověřování). Uživatel musí mít na účtu úložiště roli Storage Blob Data Contributor nebo ekvivalentní roli.

Mezi ukázkové výzvy patří:

  • Vytvořte kontejner: "Vytvořte privátní kontejner s názvem mycontainer v účtu úložiště mystorageaccount".
  • S úrovní přístupu: "Vytvořte kontejner objektů blob s názvem „logs“ v účtu úložiště 'mydata' s úrovní přístupu 'soukromé'."
Parameter Povinné nebo volitelné Description
Účet úložiště Povinné Globálně jedinečný název účtu Azure Storage (například mystorageaccount).
Kontejner Povinné Název kontejneru, který se má vytvořit v rámci účtu úložiště.

Úspěšné ověření: Nástroj vrátí vytvořené vlastnosti kontejneru.

Nápovědy pro poznámky k nástrojům:

Destruktivní: ✅ | Idempotentní: ❌ | Open World: ❌ | Jen pro čtení: ❌ | Tajný kód: ❌ | Místní povinné: ❌

Kontejner: Získání podrobností o kontejneru

Vypište všechny kontejnery blobů v úložišti nebo zobrazte podrobnosti o konkrétním kontejneru. Zobrazí vlastnosti kontejneru, včetně zásad přístupu, stavu zapůjčení a metadat.

Požadavky: Kontext konverzace vytváří globální parametry (předplatné, ověřování). Volající musí mít na účtu úložiště roli Čtenáře dat objektů blob služby Storage nebo ekvivalentní roli.

Mezi ukázkové výzvy patří:

  • Získejte podrobnosti o kontejneru: "Ukaž mi podrobnosti o kontejneru 'dokumenty' v účtu úložiště 'mystorageaccount'."
  • Výpis kontejnerů: Jaké kontejnery jsou v účtu úložiště media_files?
  • Zkontrolujte zásady přístupu: Kontrola zásad přístupu pro kontejner user_data v účtu úložiště prodstore.
Parameter Povinné nebo volitelné Description
Účet úložiště Povinné Globálně jedinečný název účtu Azure Storage.
Kontejner Volitelný Název kontejneru. Pokud nezadáte název, nástroj zobrazí seznam všech kontejnerů v účtu úložiště.

Ověření úspěšnosti: Vrátí JSON s vlastnostmi kontejneru nebo seznamem všech kontejnerů, pokud nezadáte název.

Nápovědy pro poznámky k nástrojům:

Destruktivní: ❌ | Idempotentní: ✅ | Open World: ❌ | Jen pro čtení: ✅ | Tajný kód: ❌ | Místní povinné: ❌

Objekt blob: Získání podrobností o objektu blob

Výpis objektů blob v kontejneru nebo získání podrobností o konkrétním objektu blob Zobrazuje vlastnosti objektů blob, včetně metadat, velikosti, času poslední změny a vlastností obsahu.

Požadavky: Kontext konverzace vytváří globální parametry (předplatné, ověřování). Volající musí mít na úložišťovém účtu roli Čtenáře údajů Storage Blob nebo ekvivalentní roli.

Mezi ukázkové výzvy patří:

  • Získejte podrobnosti o objektu blob: Zobrazit podrobnosti profile.txtv kontejneru Documents v účtu úložiště mystorageaccount.
  • Výpis objektů blob: Jaké bloby jsou v kontejneru 'photos' v účtu úložiště 'mediafiles'?
  • Metadata objektů blob: Jaká jsou metadata probackup.zipv kontejneru Backups v účtu úložiště mydata?
Parameter Povinné nebo volitelné Description
Účet úložiště Povinné Globálně jedinečný název účtu Azure Storage (například mystorageaccount).
Kontejner Povinné Název kontejneru v rámci účtu úložiště.
Kapka Volitelný Název objektu blob v rámci kontejneru, včetně úplné cesty (například file.txt nebo folder/file.txt). Pokud nezadáte název, nástroj zobrazí seznam všech objektů blob v kontejneru.

Ověření úspěšnosti: Vrátí JSON s vlastnostmi objektu blob nebo seznamem všech objektů blob, pokud nezadáte název.

Nápovědy pro poznámky k nástrojům:

Destruktivní: ❌ | Idempotentní: ✅ | Open World: ❌ | Jen pro čtení: ✅ | Tajný kód: ❌ | Místní povinné: ❌

Objekt blob: Nahrání

Nahraje místní soubor do objektu blob ve službě Azure Storage, pokud objekt blob neexistuje.

Požadavky: Kontext konverzace vytváří globální parametry (předplatné, ověřování). Volající musí mít na účtu úložiště roli Přispěvatel dat objektů blob nebo ekvivalentní roli. Místní soubor musí existovat a musí být přístupný.

Mezi ukázkové výzvy patří:

  • Nahrání souboru: "Nahrajte lokální soubor 'report.pdf' do blobu 'documents/report.pdf' v kontejneru 'documents' v úložišti 'mystorageaccount'."
  • Nahrání a přepsání: "Nahrajte lokální soubor 'data.csv' do objektu 'archive/data.csv' v kontejneru 'archive' v úložišti 'mydata', a pokud existuje, přepište jej."
Parameter Povinné nebo volitelné Description
Účet úložiště Povinné Globálně jedinečný název účtu Azure Storage (například mystorageaccount).
Kontejner Povinné Název kontejneru v rámci účtu úložiště.
Kapka Povinné Název objektu blob v rámci kontejneru, včetně úplné cesty (například file.txt nebo folder/file.txt).
Cesta k místnímu souboru Povinné Úplná cesta k místnímu souboru v systému.

Úspěšné ověření: Nástroj vrátí čas poslední změny, značku ETag a hodnotu hash obsahu nahraného objektu blob.

Nápovědy pro poznámky k nástrojům:

Destruktivní: ❌ | Idempotentní: ❌ | Open World: ❌ | Jen pro čtení: ❌ | Tajný kód: ❌ | Místní povinné: ✅