Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il server MCP (Model Context Protocol) di Azure consente di gestire le condivisioni file di Azure (Microsoft.FileShares) utilizzando inviti in linguaggio naturale. Non è necessario ricordare una sintassi di comando specifica.
✔️ Si applica a: Condivisioni file create con il provider di risorse Microsoft.FileShares(anteprima)
✖️ Non si applica a: condivisioni file classiche create con il provider di risorse Microsoft.Storage
File di Azure è un servizio di condivisione file gestito nel cloud. Azure condivisioni file offrono archiviazione completamente gestita e ad alte prestazioni per le tue applicazioni e carichi di lavoro. Questo articolo si applica solo alle condivisioni file create con il provider di risorse Microsoft.FileShares (anteprima), attualmente disponibile solo per le condivisioni file Network File System (NFS). Non si applica alle condivisioni file classiche create con il provider di risorse Microsoft.Storage.
Annotazioni
parametri Tool: gli strumenti server Azure MCP definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati di seguito. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.
Ottieni i limiti
Ottenere i limiti di condivisione file per una sottoscrizione e una posizione.
Alcuni prompt di esempio includono:
- "Mostra i limiti correnti della condivisione file nella posizione "eastus".
- "Quali sono i limiti di condivisione file per la posizione 'westeurope?'"
- "Ottenere i limiti di condivisione file per la posizione 'centralus'".
- "Specificare i limiti di condivisione file per la posizione 'eastus2'".
- "Recuperare i limiti di condivisione file per l'area "westus".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Ubicazione | Obbligatorio | L'area o il nome della località di Azure, ad esempio eastus, westeurope). |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Ottieni i dati di utilizzo
Ottieni i dati di utilizzo della condivisione di file per una sottoscrizione e una localizzazione.
Alcuni prompt di esempio includono:
- Mostra i dettagli di utilizzo per le condivisioni di file nella posizione 'eastus'.
- Voglio visualizzare l'utilizzo per le condivisioni di file nell'area 'westeurope'.
- Ottieni statistiche di utilizzo per le condivisioni file nella posizione 'centralus'.
- È possibile fornire informazioni sull'utilizzo delle condivisioni di file in 'eastus2'?
- "Visualizzare l'utilizzo per le condivisioni file nell'area "westus".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Ubicazione | Obbligatorio | L'area o il nome della località di Azure, ad esempio eastus, westeurope). |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Ottenere consigli
Ottenere consigli sui parametri di provisioning per una condivisione file in base alle dimensioni di archiviazione desiderate.
Alcuni prompt di esempio includono:
- "Ottenere consigli per una condivisione file da 1.000 GiB nella posizione 'eastus'".
- "È possibile fornire raccomandazioni per una condivisione file 500-GiB in 'westeurope?'"
- Ottieni i dettagli per una condivisione file da 2.000 GiB nella posizione 'centralus'.
- "Voglio visualizzare le raccomandazioni per una condivisione file da 5.000 GiB in 'eastus2'".
- Recuperare le raccomandazioni per una condivisione di file da 250 GiB nella regione 'westus'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Ubicazione | Obbligatorio | L'area o il nome della località di Azure, ad esempio eastus, westeurope). |
| Archiviazione provisionata in GiB (gibibyte) | Obbligatorio | Dimensione di archiviazione richiesta con provisioning della condivisione in GiB. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Condivisione file: controlla la disponibilità del nome
Controllare se un nome di condivisione di file è disponibile in un percorso specifico.
Alcuni prompt di esempio includono:
- "È possibile verificare se il nome della condivisione file 'projectdata' è disponibile nella posizione 'eastus?'"
- "Voglio vedere se 'salesbackup' è un nome di condivisione file disponibile in 'westeurope'".
- Controllare la disponibilità del nome della condivisione file 'teamfiles' nell'area 'EastUS'.
- "Il nome 'archive2024' è gratuito per una nuova condivisione file in 'WestUS?'"
- Verificare se 'clientdocs' può essere usato come nome di condivisione di file nella posizione 'centralus'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Nome | Obbligatorio | Nome della condivisione file. |
| Ubicazione | Obbligatorio | L'area o il nome della località di Azure, ad esempio EastUS, WestEurope). |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Condivisione file: creare una condivisione file
Creare una nuova risorsa di condivisione file Azure in un gruppo di risorse. Questa operazione crea una condivisione file completamente gestita a prestazioni elevate accessibile tramite il protocollo NFS.
Alcuni prompt di esempio includono:
- "Creare una nuova condivisione file denominata 'project-data' nel gruppo di risorse 'rg-prod' nella posizione 'eastus'".
- "È necessario creare una condivisione file denominata "backupshare" nel gruppo di risorse 'rg-backup' nella posizione 'westeurope'.
- "Configurare una condivisione file 'userdocs' nel gruppo di risorse 'rg-dev' nella posizione 'centralus'".
- "Creare la condivisione file 'archive2024' nel gruppo di risorse 'rg-archive' nella posizione 'eastus2'".
- "Generare una condivisione file denominata 'mediafiles' nel gruppo di risorse 'rg-media' nella posizione 'westus'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome | Obbligatorio | Nome della condivisione file. |
| Ubicazione | Obbligatorio | L'area o il nome della località di Azure, ad esempio EastUS, WestEurope). |
| Nome del mount | Opzionale | Nome del montaggio della condivisione file, come visto dagli utenti finali. |
| Livello multimediale | Opzionale | Livello di supporto di archiviazione (ad esempio, SSD). |
| Ridondanza | Opzionale | Livello di ridondanza , ad esempio Local, Zone. |
| Protocollo | Opzionale | Protocollo di condivisione file , ad esempio NFS. |
| Archiviazione provisionata in GiB (gibibyte) | Opzionale | Dimensione di archiviazione richiesta con provisioning della condivisione in GiB. |
| IOPS preconfigurati al secondo | Opzionale | Operazioni di I/O provisionate al secondo. |
| Velocità effettiva con provisioning in MiB al secondo (mebibyte) | Opzionale | Larghezza di banda provisionata in MiB per secondo. |
| Accesso alla rete pubblica | Opzionale | Impostazione di accesso alla rete pubblica (Enabled o Disabled). |
| NFS root squash | Opzionale | Impostazione di root squash NFS (NoRootSquash, RootSquash, o AllSquash). |
| Subnetti consentiti | Opzionale | Elenco delimitato da virgole di ID subnet autorizzati ad accedere alla condivisione di file. |
| Etichette | Opzionale | Tag di risorsa come JSON (ad esempio, {"key1":"value1","key2":"value2"}). |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Condivisione file: Ottieni condivisione file
Ottenere i dettagli di una condivisione file specifica o elencare tutte le condivisioni file. Se si specifica un nome, il comando restituisce una condivisione file specifica. In caso contrario, elenca tutte le condivisioni file nella sottoscrizione o nel gruppo di risorse.
Alcuni prompt di esempio includono:
- "Mostra tutte le condivisioni file nel gruppo di risorse 'rg-prod'"
- Elenca tutte le condivisioni file presenti nel gruppo di risorse 'rg-backup'.
- "Ottenere i dettagli per la condivisione file 'reports2024' nel gruppo di risorse 'rg-production'".
- "È possibile recuperare informazioni sulla condivisione file 'archive-logs' per il gruppo di risorse 'rg-data'".
- "È necessario visualizzare la condivisione file 'projectfiles' dal gruppo di risorse 'rg-dev'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Opzionale | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome | Opzionale | Nome della condivisione file. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Condivisione file: aggiornare la condivisione file
Aggiornare una risorsa di condivisione file Azure esistente. È possibile aggiornare le proprietà modificabili, ad esempio l'archiviazione provisionata, le operazioni di input/output al secondo (IOPS), la velocità effettiva e le impostazioni di accesso alla rete.
Alcuni prompt di esempio includono:
- "Aggiornare la condivisione file denominata "projectdocs" nel gruppo di risorse 'rg-prod' per modificarne la quota."
- "Apportare modifiche alla condivisione file 'shareddata' all'interno del gruppo di risorse 'rg-backup' aggiornando le impostazioni di accesso."
- "Applicare nuove impostazioni alla condivisione file 'datahub' nel gruppo di risorse 'rg-data' per aumentare la velocità effettiva."
- "Modificare le impostazioni di configurazione per la condivisione file 'prod-share' nel gruppo di risorse 'rg-production'".
- "È necessario aggiornare la condivisione file "reports2024" nel gruppo di risorse "rg-analytics".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome | Obbligatorio | Nome della condivisione file. |
| Archiviazione provisionata in GiB (gibibyte) | Opzionale | Dimensione di archiviazione richiesta con provisioning della condivisione in GiB. |
| IOPS preconfigurati al secondo | Opzionale | Operazioni di I/O provisionate al secondo. |
| Velocità effettiva con provisioning in MiB al secondo (mebibyte) | Opzionale | Larghezza di banda provisionata in MiB per secondo. |
| Accesso alla rete pubblica | Opzionale | Impostazione di accesso alla rete pubblica (Enabled o Disabled). |
| NFS root squash | Opzionale | Impostazione di root squash NFS (NoRootSquash, RootSquash, o AllSquash). |
| Subnetti consentiti | Opzionale | Elenco delimitato da virgole di ID subnet autorizzati ad accedere alla condivisione di file. |
| Etichette | Opzionale | Tag di risorsa come JSON (ad esempio, {"key1":"value1","key2":"value2"}). |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Condivisione file: eliminare la condivisione file
Eliminare una condivisione file in modo permanente. Non è possibile annullare questa operazione.
Alcuni prompt di esempio includono:
- "Eliminare la condivisione file denominata "backup-share" nel gruppo di risorse 'rg-prod''
- "Rimuovere la condivisione file "project-files" nel gruppo di risorse "rg-marketing".
- "Si vuole eliminare la condivisione file 'temp-data' nel gruppo di risorse 'rg-dev'".
- "È possibile eliminare la condivisione file 'archive-old' nel gruppo di risorse 'rg-archive?'"
- "Rimuovere la condivisione file 'cleanup-share' dal gruppo di risorse 'rg-cleanup'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome | Obbligatorio | Nome della condivisione file. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Connessione endpoint privato: Ottieni connessione all'endpoint privato
Ottenere i dettagli di una connessione di endpoint privato specifica o elencare tutte le connessioni di endpoint privato per una condivisione di file. Se si specifica connection-name, il comando restituisce una connessione specifica. In caso contrario, elenca tutte le connessioni.
Alcuni prompt di esempio includono:
- "Elencare tutte le connessioni endpoint private per la condivisione file 'projectfiles' nel gruppo di risorse 'rg-prod'"
- Ottieni la connessione all'endpoint privato denominata «myconnection» per la condivisione di file «datashare» nel gruppo di risorse «rg-data».
- Mostra le connessioni agli endpoint privati nella condivisione di file 'backupshare' nel gruppo di risorse 'rg-backup'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome della condivisione dei file | Obbligatorio | Nome della condivisione file. |
| Nome connessione | Opzionale | Nome della connessione dell'endpoint privato. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Connessione endpoint privato: aggiornare la connessione all'endpoint privato
Aggiornare lo stato di una connessione endpoint privato per una condivisione di file. Usare questa operazione per approvare o rifiutare le richieste di connessione all'endpoint privato.
Alcuni prompt di esempio includono:
- "Approvare la connessione all'endpoint privato "myconnection" per la condivisione file 'projectfiles' nel gruppo di risorse 'rg-prod''
- "Rifiuta la connessione all'endpoint privato denominata 'extconnection' nella condivisione file 'datashare' nel gruppo di risorse 'rg-data' con descrizione 'Non autorizzata'".
- Aggiorna lo stato della connessione dell'endpoint privato 'pendingconn' a 'Approvato' per la condivisione di file 'backupshare' nel gruppo di risorse 'rg-backup'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome della condivisione dei file | Obbligatorio | Nome della condivisione file. |
| Nome connessione | Obbligatorio | Nome della connessione dell'endpoint privato. |
| Stato | Obbligatorio | Stato della connessione (Approved, Rejectedo Pending). |
| Descrizione | Opzionale | Descrizione della modifica dello stato della connessione. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Snapshot di condivisione file: creare uno snapshot
Creare uno snapshot di una condivisione file Azure. Gli snapshot sono copie temporizzate di sola lettura usate per il backup e il ripristino.
Alcuni prompt di esempio includono:
- "Creare uno snapshot denominato "backup-snap-jan23" per la condivisione file 'backup' nel gruppo di risorse 'rg-data-prod'"
- Voglio creare uno snapshot denominato 'project-snapshot' per la condivisione di file 'projectfiles' nel gruppo di risorse 'rg-marketing'
- Generare uno snapshot denominato "weekly-backup" per la condivisione di file 'companyshare' nel gruppo di risorse 'rg-finance'
- "Creare uno snapshot denominato "reports-snapshot" nella condivisione file 'reports' nel gruppo di risorse 'rg-analytics'"
- "Avviare la creazione di snapshot denominata 'dev-snapshot-01' per la condivisione file 'devfiles' nel gruppo di risorse 'rg-development'"
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome della condivisione dei file | Obbligatorio | Nome della condivisione file principale. |
| Nome snapshot | Obbligatorio | Nome dello snapshot. |
| Metadati | Opzionale | Metadati personalizzati per lo snapshot come oggetto JSON , ad esempio {"key1":"value1","key2":"value2"}. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Snapshot di condivisione file: Ottieni uno snapshot
Ottenere i dettagli di uno snapshot di condivisione file specifico o elencare tutti gli snapshot. Se si specifica il nome dello snapshot, il comando restituisce uno snapshot specifico. In caso contrario, elenca tutti gli snapshot della condivisione file.
Alcuni prompt di esempio includono:
- Mostra tutti gli snapshot della condivisione di file 'projectfileshare' nel gruppo di risorse 'rg-prod'.
- "Elencare gli snapshot disponibili nella condivisione file 'teamdata' nel gruppo di risorse 'rg-finance'".
- "Ottenere lo snapshot denominato 'snapshot20240601' dalla condivisione file 'backupshare' nel gruppo di risorse 'rg-backup'".
- Recuperare i dettagli dello snapshot 'dailybackup' dalla condivisione file 'reports' nel gruppo di risorse 'rg-analytics'.
- "È necessario visualizzare lo snapshot "weekendcopy" dalla condivisione file 'mediafiles' nel gruppo di risorse 'rg-media'.
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome della condivisione dei file | Obbligatorio | Nome della condivisione file principale. |
| Nome snapshot | Opzionale | Nome dello snapshot. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Lo snapshot della condivisione file: aggiornamento dello snapshot
Aggiornare le proprietà e i metadati di uno snapshot di condivisione file Azure, ad esempio tag o criteri di conservazione.
Alcuni prompt di esempio includono:
- "Aggiornare lo snapshot 'backup-snap-jan23' per la condivisione file 'backupshare' nel gruppo di risorse 'rg-backup'".
- "Applicare aggiornamenti allo snapshot 'data-snapshot' nella condivisione file 'datafiles' nel gruppo di risorse 'rg-data'".
- "È possibile aggiornare lo snapshot 'snapshot2024' per la condivisione file 'reports' nel gruppo di risorse 'rg-analytics'".
- Aggiorna lo snapshot chiamato 'endofmonth' nella condivisione file 'finance-data' nel gruppo di risorse 'rg-finance'.
- "Modificare le proprietà dello snapshot 'weeklybackup' per la condivisione file 'devfileshare' nel gruppo di risorse 'rg-dev'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome della condivisione dei file | Obbligatorio | Nome della condivisione file principale. |
| Nome snapshot | Obbligatorio | Nome dello snapshot. |
| Metadati | Opzionale | Metadati personalizzati per lo snapshot come oggetto JSON , ad esempio {"key1":"value1","key2":"value2"}. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌
Snapshot di condivisione file: eliminare lo snapshot
Eliminare definitivamente uno snapshot della condivisione di file. Questa operazione non può essere annullata.
Alcuni prompt di esempio includono:
- "Eliminare lo snapshot 'backup-snap-jan15' dalla condivisione file 'datafiles' nel gruppo di risorse 'rg-prod'".
- Rimuovere lo snapshot 'weekly-backup' dalla condivisione file 'backupshare' nel gruppo di risorse 'rg-backup'.
- "Eliminare lo snapshot 'snapshot2024-03-15' dalla condivisione file 'reports' nel gruppo di risorse 'rg-analytics'".
- "Eliminare lo snapshot 'dailybackup' dalla condivisione file 'projectfiles' nel gruppo di risorse 'rg-dev'".
- "Rimuovere lo snapshot 'weeklysnap' dalla condivisione file 'archive' nel gruppo di risorse 'rg-archive'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Gruppo di risorse | Obbligatorio | Nome del gruppo di risorse Azure. Il gruppo di risorse è un contenitore logico per Azure risorse. |
| Nome della condivisione dei file | Obbligatorio | Nome della condivisione file principale. |
| Nome snapshot | Obbligatorio | Nome dello snapshot. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ✅ | Idempotente: ❌ | Open World: ❌ | Sola lettura: ❌ | Segreto: ❌ | Locale obbligatorio: ❌