Creazione di condivisioni file e destinazioni di montaggio

Crea condivisioni di file e destinazioni di montaggio con capacità, prestazioni e crittografia personalizzate sia in fase di archiviazione che durante il trasferimento.

È possibile creare condivisioni di file a livello di zona e regionale tramite la console, la CLI, l'API o Terraform. È possibile selezionare la disponibilità dei dati, la posizione, la capacità personalizzata e il livello di prestazioni. È possibile assegnare la condivisione file e la destinazione di montaggio a un gruppo di sicurezza, applicare tag per facilitare la gestione e il supporto al backup.

È possibile creare condivisioni file e destinazioni di montaggio in uno dei seguenti modi:

  • Creare una condivisione di file e una destinazione di montaggio contemporaneamente,
  • Creare una condivisione file e aggiungere la destinazione di montaggio successivamente.

Quando si crea una destinazione di montaggio, il suo tipo di crittografia di transito deve riflettere le modalità di crittografia di transito consentite della condivisione. Puoi creare più destinazioni di montaggio per la condivisione se deve essere utilizzata da risorse in diversi VPC. È possibile creare una destinazione di montaggio per ogni VPC per la condivisione di file.

I clienti con accesso speciale all'anteprima della nuova offerta di file share regionali possono utilizzare il profilo rfs per creare file share con disponibilità regionale e valori di larghezza di banda regolabili. La modalità di accesso VPC non è supportata per le condivisioni regionali.

Le funzioni Hyper Protect Crypto Services sono obsolete. I clienti possono utilizzare le istanze esistenti fino al 20 marzo 2027. Per ulteriori informazioni, consultare la sezione " Deprecazione di IBM Cloud Hyper Protect Crypto Services ". Per garantire una protezione continua, valuta la possibilità di migrare le tue chiavi di crittografia esistenti su un'istanza dedicata di Key Protect. Per ulteriori informazioni, consultare la Guida alla migrazione.

Creare una condivisione di file nella console

Nella console IBM Cloud, puoi creare una condivisione file con o senza una destinazione di montaggio. Tuttavia, devi creare una destinazione di montaggio quando vuoi montare la condivisione su un'istanza del server virtuale.

Creare una condivisione di file nella console

  1. Nella console IBM Cloud, fai clic sull'icona del menu di navigazione > icona VPC infrastruttura > Archiviazione > Condivisioni di archiviazione file. Viene visualizzato un elenco di condivisioni file.

  2. Nella pagina Condivisioni di archiviazione file per VPC, fare clic su Crea. Selezionare " Crea condivisione file ".

  3. Immettere le seguenti informazioni.

Valori per la creazione di una condivisione di file
Campo Valore
Disponibilità
  • Selezionare la disponibilità Se siete un cliente con accesso speciale per l'anteprima della nuova offerta di condivisione di file a livello regionale, potete scegliere tra la disponibilità dei dati a livello regionale e a zona singola. Non è possibile modificare questa proprietà dopo la creazione della condivisione.
  • Se l'account non è inserito nell'elenco dei permessi, questo campo non appare. Selezionate la posizione della vostra condivisione di file zonale.
Posizione
  • Seleziona la disponibilità Se hai scelto l'opzione "Disponibilità in una singola zona", utilizza il menu " Zona " per selezionare una zona. Il menu è suddiviso per area geografica (ad esempio, NORD AMERICA). All’interno di ciascuna area geografica, le località metropolitane sono elencate in ordine alfabetico. Fai clic sulla freccia accanto al nome di una linea della metropolitana per espandere le relative zone, quindi fai clic su una zona per selezionarla. Ad esempio, espandi "Dallas (us-south)" e seleziona " us-south-2 ".
  • Se hai scelto la disponibilità regionale, utilizza il menu "Regione" per selezionare una regione. Il menu è suddiviso per area geografica. All’interno di ciascuna area geografica, le località metropolitane sono elencate in ordine alfabetico. Fai clic sulla freccia accanto al nome di una linea della metropolitana per espandere le relative regioni, quindi fai clic su una regione per selezionarla. Ad esempio, espandi "Dallas" e seleziona "us-south".
Dettagli
Nome Specificare un nome significativo per la condivisione di file. Il nome della condivisione file può contenere fino a 63 caratteri alfanumerici in minuscolo, compreso il trattino (-), e deve iniziare con una lettera minuscola. Puoi modificare successivamente il nome, se lo desideri.
Gruppo di risorse Utilizzare il gruppo di risorse predefinito o specificare un Gruppo di risorse. I gruppi di risorse ti aiutano ad organizzare le tue risorse dell'account per scopi di fatturazione e controllo dell'accesso.
Tag (facoltativo) Immettere eventuali tag utente da applicare a questa condivisione file. Man mano che si digita, vengono visualizzati i tag esistenti che è possibile selezionare. Per ulteriori informazioni sulle tag, consultare Aggiunta di tag utente a una condivisione file.
Tag di gestione accessi (facoltativo) Immetti le tag di gestione dell'accesso che hai creato in IAM per applicarle alla condivisione file. Per ulteriori informazioni sulle tag di gestione degli accessi, consultare Tag di gestione degli accessi per le condivisioni file.
Profilo

Il profilo viene popolato automaticamente in base alla selezione della disponibilità dei dati. Per ulteriori informazioni, vedere Profili di archiviazione file.

  • Se si sceglie la disponibilità a zona singola, la condivisione di file utilizza il profilo dp2. Seleziona la dimensione e gli IOPS per la tua condivisione file. È possibile aumentare la capacità in un secondo momento e regolare gli IOPS in base alle esigenze.
  • Selezionare la disponibilità Se si è scelta la disponibilità regionale, la condivisione dei file utilizza il profilo rfs. Selezionate la dimensione e la larghezza di banda per la vostra condivisione di file. 800 Mbps è la larghezza di banda predefinita per tutte le condivisioni di file, senza costi aggiuntivi. È possibile aumentare la capacità in un secondo momento e regolare la larghezza di banda in base alle esigenze.

  1. La creazione di target di montaggio è facoltativa. È possibile ignorare questo passo se non si desidera creare una destinazione di montaggio ora. Tuttavia, ne serve uno per montare la condivisione di file su un compute host. Una condivisione di file può avere più target di montaggio, in modo da potervi accedere da più VPC. È possibile creare una sola destinazione di montaggio per VPC per condivisione file. Per crearlo, fare clic su Crea.

    La destinazione di montaggio deve essere creata con un' interfaccia di rete virtuale (VNI). La VNI fornisce alla condivisione di file un indirizzo IP riservato e applica le regole del gruppo di sicurezza selezionato. Questa destinazione di montaggio supporta la crittografia in transito e il montaggio tra zone. Definire la destinazione di montaggio fornendo le seguenti informazioni:

    1. Fornire un nome di destinazione di montaggio. Il nome può contenere fino a 63 caratteri alfanumerici in minuscolo, compreso il trattino (-), e deve iniziare con una lettera minuscola. Puoi modificare successivamente il nome, se lo desideri.
    2. Selezionare un VPC disponibile. L'elenco include solo i VPC che dispongono di una sottorete nella posizione selezionata. La selezione della posizione viene ereditata dalla condivisione di file (ad esempio, us-south-2 ).
    3. Viene generata un'interfaccia di rete virtuale predefinita. È possibile personalizzarla facendo clic sull'icona Modifica Icona Modifica. È possibile modificare il nome o la sottorete se nella posizione sono disponibili più sottoreti. È anche possibile selezionare una VNI esistente da collegare alla destinazione di montaggio. Viene visualizzato l'elenco dei VNI disponibili nella VPC e la posizione. Poiché gli indirizzi IP secondari collegati alle VNI non possono essere accettati come destinazione di montaggio della condivisione file, vengono filtrati dall'elenco.
    4. Fai clic su Next.
    5. La crittografia in transito è disattivata per impostazione predefinita per le condivisioni zonali, mentre è attivata per impostazione predefinita per le condivisioni regionali. Fai clic sul pulsante per modificare il valore predefinito. Per ulteriori informazioni su questa funzione, consultare Encryption in transit - Securing mount connections between file share and host.
    6. Poi, fai clic su Avanti.
    7. Rivedere la propria selezione e fare clic su Indietro per tornare indietro e aggiornare le proprie scelte oppure fare clic su Crea.

  2. Nella sezione " Crittografia dei dati inattivi ", tutte le condivisioni di file sono crittografate per impostazione predefinita tramite chiavi gestite d IBM. Per utilizzare la propria chiave di crittografia, fare clic sul pulsante di attivazione/disattivazione per abilitare la crittografia gestita dal cliente. Se disponi già di un'istanza KMS e di una chiave root, il sistema le seleziona automaticamente per te. Per modificare la chiave o l'istanza, fare clic su " Icona Modifica Modifica icona " per aprire il pannello laterale " Configurare la crittografia ". Seleziona una delle seguenti opzioni per individuare la tua chiave di crittografia:

    • Ricerca per istanza: il pannello prevede tre passaggi:
      1. Seleziona un'istanza KMS: l'elenco mostra il nome, l'ID, il tipo (Standard o Dedicata) e la posizione di ciascuna istanza disponibile di Key Protect. Seleziona un'istanza e fai clic su Seleziona. Se non disponi ancora di un'istanza, fai clic su " Crea " per crearne una.
      2. Chiave associata: l'elenco riporta il nome, l'ID, la data dell'ultimo aggiornamento, gli alias e il portachiavi di ciascuna chiave root disponibile. Selezionare un tasto e fare clic su “Seleziona ”. Se non disponi ancora di una chiave, fai clic su " Crea nuova chiave ".
      3. Verifica: confermare le selezioni effettuate, tra cui il servizio di gestione delle chiavi, il tipo di istanza, il nome dell'istanza e il nome della chiave. La sezione " Autorizzazione del servizio " indica se l'autorizzazione richiesta tra File Storage for VPC e l'istanza KMS è già attiva. In caso contrario, puoi consentire a Key Protect di creare automaticamente l'autorizzazione oppure crearne una manualmente. Per ulteriori informazioni, consultare la sezione " Impostazione delle autorizzazioni da servizio a servizio" all'indirizzo File Storage for VPC. Fai clic su Conferma per applicare la selezione ed tornare alla pagina di configurazione della condivisione dei file.
    • Ricerca per CRN: inserire il CRN della chiave radice del cliente da utilizzare per la crittografia della condivisione. Scegli questa opzione se stai utilizzando il CRK di un altro account. Fare clic su “Seleziona ” per passare alla fase di revisione descritta nell’opzione “Individua per istanza ”.

  3. Se si sceglie la disponibilità a zona singola, la sezione " Disaster recovery " viene visualizzata dopo la scheda "Crittografia". Questo passo è facoltativo. Utilizzalo per configurare la replica asincrona all’interno della stessa regione in fase di provisioning. La replica interregionale deve essere configurata separatamente dopo che la condivisione è stata abilitata e si trova in uno stato stabile. Per ulteriori informazioni, consultare la sezione " Aggiunta della replica a una condivisione di file ".

    Per configurare la replica all'interno della stessa regione, fare clic sul pulsante di attivazione/disattivazione " Replica asincrona ". I campi di replica si espandono in linea. La replica eredita il profilo e le impostazioni di crittografia della condivisione di origine. Le destinazioni di montaggio devono essere aggiunte separatamente.

    Completa i seguenti campi:

    1. Zona: i dati relativi alla geografia e alla regione sono precompilati in base alla posizione della quota di origine e non possono essere modificati. Seleziona la zona per la replica dal menu a tendina. Vengono visualizzate solo le zone valide per la replica.
    2. Nome della replica: inserire un nome per la condivisione della replica.
    3. IOPS massimi: specificare il numero massimo di IOPS per la condivisione della replica.
    4. Frequenza: selezionare la frequenza con cui sincronizzare le modifiche dalla condivisione di origine alla replica e configurare l'ora di inizio:
      • Ogni 15 minuti: inserire il valore in minuti corrispondente all'ora di inizio.
      • Orario: inserire il valore in minuti corrispondente all'ora di inizio.
      • Giornalmente: inserire l'ora di inizio in UTC nel formato HH:MM, compresa tra 00:00 e 23:59.
      • Settimanale: selezionare il giorno o i giorni della settimana in cui deve essere eseguita la replica e inserire l'ora di inizio in UTC nel formato HH:MM, compresa tra 00:00 e 23:59.
      • Mensile: inserire il giorno del mese in cui viene eseguita la replica (da 1 a 31) e l'ora di inizio in UTC nel formato HH:MM, compresa tra 00:00 e 23:59.
      • Espressione Cron: inserire un'espressione di tipo " cron-spec " nel formato minute hour day month weekday. La replica deve essere programmata a un intervallo di almeno 15 minuti. Ad esempio, per eseguire la replica ogni giorno alle 17:30 UTC, inserisci 30 17 * * *.

  4. Una volta immesse tutte le informazioni richieste, fare clic su Crea condivisione file. Torni alla pagina File Storage for VPC, dove un messaggio indica che la condivisione file è in fase di provisioning. Una volta completata la transazione, lo stato della condivisione diventa Attivo.

Se non sei ancora pronto per ordinare o stai solo cercando informazioni sui prezzi, puoi aggiungere le informazioni che vedi nel pannello laterale a una stima. Per ulteriori informazioni sul funzionamento di questa funzione, vedere Stima dei costi.

Creazione di una destinazione di montaggio nella console

  1. Nella console IBM Cloud, fai clic sull'icona del menu di navigazione > icona VPC infrastruttura > Archiviazione > Condivisioni di archiviazione file.

  2. Selezionare una condivisione file dall'elenco.

  3. Nella pagina Dettagli condivisioni file, in Destinazioni di montaggio, fare clic su Crea.

    Per creare una destinazione di montaggio è necessario disporre di almeno un VPC. Se non ne hai uno, prima crea un VPC.

  4. A seconda della modalità di accesso della destinazione di montaggio della condivisione, il modulo Crea destinazione montaggio ha un aspetto diverso.

    • Se la condivisione ha la modalità di accesso del gruppo di sicurezza, la destinazione di montaggio deve essere creata con un' interfaccia di rete virtuale (VNI). La VNI fornisce alla condivisione di file un indirizzo IP riservato e applica le regole del gruppo di sicurezza selezionato. Questa destinazione di montaggio supporta la crittografia in transito e il montaggio tra zone. Definire la destinazione di montaggio fornendo le seguenti informazioni:

      1. Fornire un nome di destinazione di montaggio. Il nome può contenere fino a 63 caratteri alfanumerici in minuscolo, compreso il trattino (-), e deve iniziare con una lettera minuscola. Puoi modificare successivamente il nome, se lo desideri.
      2. Selezionare un VPC disponibile. L'elenco include solo i VPC che dispongono di una sottorete nella posizione selezionata. La selezione della posizione viene ereditata dalla condivisione di file (ad esempio, us-south-2 ).
      3. Viene generata un'interfaccia di rete virtuale predefinita. È possibile personalizzarla facendo clic sull'icona Modifica Icona Modifica. È possibile modificare il nome o la sottorete se nella posizione sono presenti più sottoreti. È anche possibile selezionare una VNI esistente da collegare alla destinazione di montaggio. Viene visualizzato l'elenco dei VNI disponibili nella VPC e la posizione. Poiché gli indirizzi IP secondari collegati alle VNI non possono essere accettati come destinazione di montaggio della condivisione file, vengono filtrati dall'elenco.
      4. Fai clic su Next.
      5. La crittografia in transito è disattivata per impostazione predefinita per le condivisioni zonali, mentre è attivata per impostazione predefinita per le condivisioni regionali. Fai clic sul pulsante per modificare il valore predefinito. Per ulteriori informazioni su questa funzione, consultare Encryption in transit - Securing mount connections between file share and host.
      6. Poi, fai clic su Avanti.

    • Se la condivisione zonale ha la modalità di accesso Deprecated VPC, fornire un nome per la destinazione di montaggio e selezionare una VPC dall'elenco. Questa destinazione di montaggio può essere utilizzata per montare la condivisione file su qualsiasi istanza del server virtuale del VPC selezionato nella stessa zona della condivisione file. Il montaggio tra zone non è supportato.

    La modalità di accesso vpc raggiungerà la fine del supporto il 06 maggio 2027. Seguire la guida alla migrazione per aggiornare la modalità di controllo degli accessi della condivisione a security-group.

  5. Fai clic su Crea.

Aggiunta di ID supplementari quando si crea una condivisione di file

Quando si monta una condivisione di file in Linux, l'ID utente (UID) e l'ID gruppo (GID) possono essere usati per assegnare la proprietà di tutti i file e le cartelle di quella condivisione. È possibile specificare gli ID utente e gruppo del proprietario iniziale solo dalla CLI o con l'API. Per vedere i passaggi, passare alle istruzioni della CLI o dell'API.

Creazione di una condivisione file dalla CLI

Prima di iniziare

Prima di poter utilizzare la CLI, è necessario installare la CLI di “ IBM Cloud ” e il plug-in CLI di VPC. Per ulteriori informazioni, vedi i Prerequisiti della CLI.

Gli esempi seguenti illustrano come creare condivisioni zonali e regionali con o senza destinazione di montaggio e diverse modalità di accesso. Per ulteriori informazioni sulle opzioni e sulla sintassi dei comandi, vedere VPC CLI Reference: ibmcloud is share-create.

Raccolta delle informazioni necessarie per la creazione di una condivisione di file

Prima di eseguire il comando ibmcloud is share-create, è possibile raccogliere le informazioni necessarie per il provisioning di una condivisione visualizzando le informazioni su altre condivisioni file, destinazioni di montaggio e profili di archiviazione file.

  • Elencare tutte le condivisioni di file con il comando ibmcloud is shares.
  • Elencare i dettagli di una specifica condivisione di file con il comando ibmcloud is share SHARE.
  • Elencare le istantanee di una specifica condivisione di file con il comando ibmcloud is share-snapshots SHARE.
  • Elencare tutti i profili di condivisione file in una regione con il comando ibmcloud is share-profiles. Solo i profili di condivisione dp2 e rfs possono essere utilizzati per creare condivisioni di file.
  • Elencare tutti gli obiettivi di montaggio di una specifica condivisione di file con il comando ibmcloud is share-mount-targets SHARE.
  • Elencare tutte le sottoreti disponibili nella regione con il comando ibmcloud is subnets.
  • Elencare tutti gli indirizzi IP riservati nella sottorete con il comando ibmcloud is subnet-reserved-ips.
  • Elencare tutti i gruppi di sicurezza disponibili con il comando ibmcloud is security-groups.

Creazione di una condivisione di file zonale senza destinazione di montaggio dalla CLI

È possibile utilizzare il comando ibmcloud is share-create per eseguire il provisioning di una condivisione di file zonale nella zona selezionata con il profilo dp2, con i valori specifici di capacità e IOPS. L'esempio seguente mostra come creare una condivisione di file da 40 GB con 100 IOPS nella zona us-south-1. Questa condivisione file viene creata con la modalità di accesso del gruppo di protezione predefinita e con la cifratura gestita dal fornitore.

ibmcloud is share-create --name my-file-share --zone us-south-1 --profile dp2 --size 40 --iops 100 --allowed-access-protocols nfs4 --atem ipsec,none

Creating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-a08c2505-b933-4dce-a771-efff2e1a59e1
Name                               my-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-a08c2505-b933-4dce-a771-efff2e1a59e1
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   ipsec,none
Zone                               us-south-1
Profile                            dp2
Size(GB)                           40
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T20:10:35+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Creazione di una condivisione di file regionale senza destinazione di montaggio dalla CLI

L'esempio seguente mostra come creare una condivisione di file regionale da 40 GB con una larghezza di banda di 1000 Mbps. Questa condivisione di file viene creata con la crittografia gestita dal provider. La condivisione dei file viene creata nell'area selezionata al momento dell'accesso; non è necessario selezionare la posizione.

ibmcloud is share-create --name my-regional-file-share --profile rfs --size 40 --bandwidth 1000 --allowed-access-protocols nfs4 --atem stunnel,none

Creating file share my-regional-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-749d05eb-9779-4414-b902-553a4fd1421d
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-749d05eb-9779-4414-b902-553a4fd1421d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel,none
Zone                               -
Profile                            rfs
Size(GB)                           40
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T20:20:09+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     -
Snapshot size                      -
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  regional
Bandwidth(Mbps)                    1000
Storage Generation                 2

Creazione di una destinazione di montaggio per una condivisione file da CLI

Per creare una destinazione di montaggio per la condivisione file, eseguire il comando share-mount-target-create. Prima di iniziare, raccogliere alcune informazioni necessarie.

Raccolta delle informazioni necessarie per la creazione del target di montaggio

Quando si crea una destinazione di montaggio, è necessario specificare la condivisione file a cui è destinata. È possibile utilizzare il nome o l'ID della condivisione file. È necessario specificare anche il VPC, con il suo ID o nome. Il VPC deve essere univoco per ciascuna destinazione di montaggio. Devi specificare anche il gruppo di accesso di protezione che verrà utilizzato per gestire l'accesso alla condivisione. I gruppi di sicurezza associati a una destinazione di montaggio devono consentire l'accesso in entrata al protocollo TCP sulla porta NFS da tutti i server in cui si desidera montare la condivisione.

Infine, è possibile specificare i valori per le opzioni necessarie per creare un' interfaccia di rete virtuale per la destinazione di montaggio. Utilizza i comandi della CLI appropriati per elencare le sottoreti disponibili, gli indirizzi IP riservati in una sottorete, i gruppi di protezione per ottenere le informazioni di cui hai bisogno.

I seguenti esempi illustrano come creare target di montaggio con diverse modalità di accesso. Per ulteriori informazioni sulle opzioni e sulla sintassi del comando, vedere VPC CLI Reference: ibmcloud is share-mount-target-create.

Un'interfaccia di rete virtuale a cui sono associati indirizzi IP secondari non può essere accettata come destinazione di montaggio di una condivisione file.

Creare una destinazione di montaggio con la modalità di accesso del gruppo di sicurezza

Il seguente esempio crea una destinazione di montaggio con un'interfaccia di rete virtuale per una condivisione file che ha la modalità di accesso al gruppo di protezione.

ibmcloud is share-mount-target-create my-regional-file-share --subnet my-subnet --name my-regional-share-mount-target-1 --vni-name my-share-vni-2  --resource-group-id 6edefe513d934fdd872e78ee6a8e73ef  --access-protocol nfs4 --transit-encryption none --vpc my-vpc

Mounting target for share r006-749d05eb-9779-4414-b902-553a4fd1421d under account Test Account as user test.user@ibm.com...
ID                          r006-bc95a3c2-b84b-4186-8c5a-e3dd220abefa
Name                        my-regional-share-mount-target-1
VPC                         ID                                          Name
                            r006-243394d6-b192-4e05-bfab-5d0b4e77cf81   my-vpc
Access control mode         security_group
Resource type               share_mount_target
Virtual network interface   ID                                          Name             Protocol State Filtering Mode
                            0717-24e7dcac-e30f-43cf-9bee-3cab93692690   my-share-vni-2   auto
Lifecycle state             pending
Mount path                  -
Transit Encryption          none
Created                     2025-09-23T20:45:14+00:00
Access Protocol             nfs4

Creazione di una destinazione di montaggio con modalità di accesso VPC

Obsoleto

L'esempio seguente crea una destinazione di montaggio per una condivisione di file zonale che utilizza la modalità di accesso VPC, ormai obsoleta.

La modalità di accesso vpc raggiungerà la fine del supporto il 06 maggio 2027. Seguire la guida alla migrazione per aggiornare la modalità di controllo degli accessi della condivisione a security-group.

ibmcloud is share-mount-target-create my-vpc-file-share --vpc cli-vpc-3 --name my-vpc-mount-target --access-protocol nfs4 --transit-encryption none

Mounting target for share r006-10e82e16-ff7f-4ca4-b543-d24084fc03cf under account Test Account as user test.user@ibm.com...
ID                        r006-71fd953c-8e49-48e8-ab49-5977c324a365
Name                      my-vpc-mount-target
VPC                       ID                                          Name
                          r006-060fbfe6-4d0f-47b0-b9c5-94da8e719e22   cli-vpc-3
Access control mode       vpc
Resource type             share_mount_target
Virtual network interface
Lifecycle state           pending
Created                   2025-09-23T22:15:15+00:00
Mount path                -
Transit Encryption        none

Creazione di una condivisione file con una destinazione di montaggio dalla CLI

È possibile creare una condivisione file con una o più destinazioni di montaggio in un unico passo utilizzando il comando ibmcloud is share-create. Devi fornire il nome della zona, il profilo condivisione file, la dimensione della condivisione file e l'IOPS. Inoltre, è possibile specificare un nome, tag utente e anche l'UID proprietario iniziale. Per creare la destinazione di montaggio, devi fornire le relative informazioni in formato JSON.

Creazione di una condivisione di file zonale con una destinazione di montaggio

L'esempio seguente mostra come creare una condivisione di file zonale con capacità di 500 GB e 2000 IOPS nella zona us-south-1. La condivisione file è contrassegnata con env:dev e dispone della modalità di controllo accessi del gruppo di sicurezza. La condivisione file può essere montata su server virtuali autorizzati utilizzando la destinazione di montaggio my-new-mount-target.

ibmcloud is share-create --name my-new-file-share --zone us-south-1 --profile dp2 --size 500 --iops 2000 --allowed-transit-encryption-modes ipsec,none --user-tags env:dev --mount-targets '[{"name":"my-new-mount-target","virtual_network_interface": {"name":"my-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]'

Creating file share my-new-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-201487a2-cf35-4b2a-a4fe-f480803e1e80
Name                               my-new-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-201487a2-cf35-4b2a-a4fe-f480803e1e80
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   ipsec,none
Zone                               us-south-1
Profile                            dp2
Size(GB)                           500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-c8952df9-f479-49a8-a66b-85bf112e0831   my-new-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:17:25+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Creare una condivisione di file regionale con una destinazione di montaggio

L'esempio seguente mostra come creare una condivisione di file regionale con un target di montaggio dalla CLI. Si noti che se il comando specifica un valore di larghezza di banda basso, il sistema corregge automaticamente la configurazione per fornire almeno 800 Mbps.

ibmcloud is share-create --name my-regional-file-share --profile rfs --size 5000 --bandwidth 800 --allowed-access-protocols nfs4 --atem stunnel --mount-targets '[{"name":"my-new-mount-target","virtual_network_interface": {"name":"my-regional-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]'

Creating file share my-regional-file-share under account under account Test Account as user test.user@ibm.com...
ID                                 r006-770ff2f9-3211-459d-918b-fbf0b4a4f999
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-770ff2f9-3211-459d-918b-fbf0b4a4f999
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel
Zone                               -
Profile                            rfs
Size(GB)                           5000
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-f7c84cb2-0e82-4f9e-b729-6e51ea437df6   my-new-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:27:07+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     -
Snapshot size                      -
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  regional
Bandwidth(Mbps)                    800
Storage Generation                 2

Creazione di una condivisione file con la crittografia gestita dal cliente dalla CLI

Per default, le condivisioni File Storage for VPC vengono crittografate con la crittografia gestita da IBM. Tuttavia, puoi anche creare una crittografia di inviluppo per le tue condivisioni file utilizzando uno dei servizi di gestione delle chiavi supportati per creare o importare le tue proprie chiavi root. Per ulteriori informazioni, vedi Protezione dei dati con la crittografia envelope

Per ulteriori informazioni su come creare una condivisione file con la codifica gestita dal cliente, vedi Creazione di condivisioni file con la codifica gestita dal cliente.

Creazione di una condivisione file con una replica in un'altra zona dalla CLI

Per ulteriori informazioni su come creare una condivisione file con una replica contemporaneamente, vedi Crea una condivisione file con la replica dalla CLI.

Le condivisioni di file con disponibilità regionale servono i dati in ogni zona della regione. La replica asincrona all'interno di una regione non è applicabile a queste condivisioni.

Creazione di una condivisione di file da un'istantanea dalla CLI

È possibile utilizzare un'istantanea di una condivisione di file per creare un'altra condivisione di file nella stessa zona. Per creare una condivisione di file basata su un'istantanea, eseguire il comando ibmcloud is share-create.

È possibile specificare il nome, l'ID o il CRN della snapshot. Se si sceglie di specificare il nome della snapshot, è necessario specificare anche il nome o l'ID della condivisione di file a cui la snapshot appartiene. I nomi delle istantanee devono essere unici a livello di condivisione di file, ma un'altra condivisione di file può avere un'istantanea con lo stesso nome.

ibmcloud is share-create --snapshot r026-7647ba64-9728-4bb4-be2f-d958f738fdae

Per ulteriori informazioni su come creare una condivisione di file da un'istantanea con altri esempi, vedere Ripristino dei dati da un'istantanea di condivisione di file.

Selezionare la disponibilità I profili di condivisione file di prima e seconda generazione della famiglia di profili di prestazioni definiti non sono intercambiabili. Non è possibile utilizzare l'istantanea della condivisione di file di prima generazione per creare una condivisione con il profilo rfs. Allo stesso modo, non è possibile utilizzare l'istantanea di seconda generazione per creare una condivisione di file zonale.

Aggiunta di ID supplementari quando si crea una condivisione di file con la CLI

Quando si monta una condivisione di file in Linux, l'ID utente (UID) e l'ID gruppo (GID) possono essere usati per assegnare la proprietà di tutti i file e le cartelle di quella condivisione.

Con la CLI, è possibile impostare i valori UID e GID per le proprietà --initial-owner-uid e --initial-owner-gid per controllare l'accesso alle condivisioni di file. Ovunque si monti la condivisione di file, la cartella principale deve utilizzare l'ID utente e l'ID gruppo. È possibile impostare UID o GID, o entrambi quando si crea una condivisione.

Se si modificano le autorizzazioni degli utenti e dei gruppi locali dall'istanza del server virtuale, non è possibile determinare che siano state modificate dal Cloud. Di conseguenza, il valore initial_owner non cambia nelle risposte della CLI.

La tabella seguente mostra i valori UID e GID che è possibile impostare e i valori riservati.

Unix/Linux® supplemental ID values.
Valore ID Descrizione
UID
UID 0 Riservato per root.
UID 1-99 Riservato per account predefiniti.
UID 100 - 999 Riservato dal sistema per account e gruppi del sistema di amministrazione.
UID 1000 - 10000 Utilizzato dall'account delle applicazioni.
UID 10000 + Disponibile per gli account utente.
GID
GID 0 Riservato per root.
GID 1-99 Riservato per il sistema e l'applicazione.
GID 100 + Assegnato per il gruppo dell'utente.

Per impostare gli ID supplementari quando si crea una condivisione, eseguire il comando ibmcloud is share-create e specificare le proprietà --initial-owner-gid e --initial-owner-gid con gli ID supplementari. Vedi il seguente esempio.

ibmcloud is share-create --name my-file-share --zone us-south-2 --profile dp2 --size 1000 --iops 1000 --initial-owner-gid 101 --initial-owner-uid 10001

Creating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-bc73917f-b86e-4f6d-b919-6997a88c8031
Name                               my-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-bc73917f-b86e-4f6d-b919-6997a88c8031
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   none,ipsec
Zone                               us-south-2
Profile                            dp2
Size(GB)                           1000
IOPS                               1000
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:42:38+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Creazione di una condivisione file con l'API

È possibile creare condivisioni file e destinazioni di montaggio richiamando direttamente le API REST.

Prima di iniziare

Configura il tuo ambiente API. Definisci le variabili per il token IAM, l'endpoint API e la versione API. Per le istruzioni, vedi Configurazione del tuo ambiente API e CLI.

È necessario fornire il parametro generation e specificare generation=2. Per ulteriori informazioni, consultare la sezione " Generazione" nella documentazione di riferimento dell'API del Virtual Private Cloud.

Un buon modo per saperne di più sull'API consiste nel fare clic su Get sample API call nelle pagine di provisioning nella console IBM Cloud. Puoi visualizzare la sequenza corretta di richieste API e comprendere meglio le azioni e le loro dipendenze.

Raccogliere le informazioni necessarie con l'API

Prima di effettuare la richiesta POST /shares, raccogliere le informazioni necessarie per il provisioning di una condivisione utilizzando i seguenti metodi API.

Creazione di una condivisione di file zonale con l'API

Effettuare una richiesta POST /shares per creare una condivisione file. Specifica la dimensione della condivisione file, un nome, il profilo IOPS e la zona. Se si desidera creare una condivisione di file con autorizzazione di accesso granulare, specificare 'security_group come modalità di accesso. Le condivisioni con modalità di accesso a gruppi di sicurezza possono essere configurate per supportare la crittografia in transito, i montaggi cross-zone, le istantanee e i backup. Vedi il seguente esempio.

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "access_control_mode": "security-group",
    "allowed_transit_encryption_modes": ["none","ipsec"],
    "size": 4800,
    "iops": 3000,
    "name": "myshare-1",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"}
}

Assicurarsi che quando si crea la destinazione di montaggio, si specifichi anche un'interfaccia di rete virtuale che sia membro del gruppo di sicurezza a cui appartiene l'istanza del server virtuale.

Creare una condivisione di file regionale con l'API

L'esempio seguente mostra come creare una condivisione di file regionale da 1000 GB con una larghezza di banda di 8000 Mbps. Questa condivisione file viene creata con la modalità di accesso del gruppo di protezione predefinita e con la cifratura gestita dal fornitore. La condivisione dei file viene creata nell'area selezionata al momento dell'accesso; non è necessario selezionare la posizione.

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "name": "my-regional-share-1",
  "mount_targets": [],
  "profile": {"name": "rfs"},
  "size": 1000,
  "bandwidth": 8000,
  "allowed_transit_encryption_modes": ["none","stunnel"],
  "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
  "access_control_mode": "security_group"
}'

Creazione di una destinazione di montaggio per una condivisione file con l'API

È possibile creare una destinazione di montaggio per una condivisione di file esistente facendo una richiesta a POST /shares/{share_id}/mount_targets.

Le modalità di controllo accessi della destinazione di montaggio e della condivisione devono corrispondere. Entrambi devono essere security_group o vpc. Quando si crea una destinazione di montaggio con la modalità di accesso security_group, prestare attenzione alla condivisione allowed_transit_encryption_modes. Il valore transit_encryption deve riflettere ciò che è consentito per la condivisione.

La modalità di accesso vpc raggiungerà la fine del supporto il 06 maggio 2027. Seguire la guida alla migrazione per aggiornare la modalità di controllo degli accessi della condivisione a security-group.

Aggiunta di una destinazione di montaggio a una condivisione file esistente specificando una sottorete e un gruppo di protezione

Effettuare una richiesta POST /shares/{share_id}/mount_targets e specificare una sottorete e un gruppo di sicurezza per l'interfaccia di rete di destinazione del montaggio. I gruppi di sicurezza associati a una destinazione di montaggio devono consentire l'accesso in entrata al protocollo TCP sulla porta NFS da tutti i server in cui si desidera montare la condivisione.

Questo esempio aggiunge una destinazione di montaggio a una condivisione di file zonale esistente, identificata da ID, e fornisce una sottorete e un gruppo di sicurezza per definire l'interfaccia di rete. La crittografia in transito è abilitata.

 curl -X POST "$vpc_api_endpoint/v1/shares/r006-201487a2-cf35-4b2a-a4fe-f480803e1e80/mount_targets/?version=2023-07-18&generation=2"\
 -d '{
     "virtual_network_interface": {
        "subnet": {"id": "1a0b3d75-8a62-4c78-9263-f9bcd25a8759"},
        "security_groups": [{"id": "b2599112-7027-480e-ad1b-fd917d2fcb84"}]
     },
     "transit_encryption": "ipsec"
}'

L'esempio seguente mostra come aggiungere una destinazione di montaggio a una condivisione di file regionale. Per abilitare la crittografia in transito per una destinazione di condivisione file regionale, specificare "stunnel".

 curl -X POST "$vpc_api_endpoint/v1/shares/r006-ee1f6fc0-6fa3-4821-ad70-f6589e30c566/mount_targets/?version=2025-09-23&generation=2"\
 -d '{
     "virtual_network_interface": {
        "subnet": {"id": "1a0b3d75-8a62-4c78-9263-f9bcd25a8759"},
        "security_groups": [{"id": "b2599112-7027-480e-ad1b-fd917d2fcb84"}]
     },
     "transit_encryption": "stunnel"
}'

Aggiunta di una destinazione di montaggio a una condivisione di file esistente con la modalità di accesso VPC

Obsoleto

Questa richiesta aggiunge una destinazione di montaggio a una condivisione di file esistente. In questo esempio, viene specificato il valore " vpc " poiché la modalità di controllo degli accessi della condivisione file è " vpc". Non è possibile abilitare la crittografia dei dati in transito.

curl -X POST "$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-H 'Content-Type: application/json'\
-d '{
    "access_control_mode": "vpc"
    "name": "mount-target-name1",
    "vpc": {"id": "6e01bc24-4a6e-4a0c-a1bd-4caa0c8159e7"},
    "transit_encryption": "none"
  }'

Una risposta corretta è simile all'esempio riportato di seguito.

{
  "access_control_mode": "vpc",
  "created_at": "2023-08-08T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/ff859972-8c39-4528-91df-eb9160eae918/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "pending",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_63aa_4deb_9ed5_1159e37cb5aa",
  "name": "mount-target-name1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/e6ff7b61-feb4-4c87-94aa-277d6f93e164",
    "id": "e6ff7b61-feb4-4c87-94aa-277d6f93e164",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

Creazione di una destinazione di montaggio e condivisione file insieme all'API

Quando si crea programmaticamente una condivisione di file e la sua destinazione di montaggio, le modalità di controllo dell'accesso della destinazione di montaggio e della condivisione devono corrispondere. Entrambi devono essere security_group. Prestate attenzione anche al valore della proprietà dell'azione allowed_transit_encryption_modes. Il valore transit_encryption della destinazione di montaggio deve riflettere ciò che è consentito per la condivisione.

Creazione di una condivisione file e di una destinazione di montaggio specificando una sottorete

La modalità di controllo accessi predefinita per le condivisioni file è security_group. Per creare la destinazione di montaggio con l'interfaccia di rete nello stesso momento in cui viene creata la condivisione di file, fare una richiesta 'POST /shares e specificare una sottorete. La proprietà 'subnet è necessaria quando non si specifica un'interfaccia di rete virtuale.

L'esempio seguente crea e collega un'interfaccia di rete virtuale al target di montaggio con un indirizzo IP riservato e applica le regole del gruppo di sicurezza selezionato. I gruppi di sicurezza associati a una destinazione di montaggio devono consentire l'accesso in entrata al protocollo TCP sulla porta NFS da tutti i server in cui si desidera montare la condivisione.

In questo esempio, la sezione di destinazione del montaggio specifica un ID sottorete. Il sistema seleziona un IP riservato da tale sottorete per l'interfaccia di rete virtuale quando viene creata la destinazione di montaggio.

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "allowed_transit_encryption_modes": ["ipsec"],
    "size": 10,
    "name": "my-share-1",
    "profile": {"name": "dp2"},
     "zone": {"name": "us-south-1"},
     "mount_targets": [{
         "virtual_network_interface": {"subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"}},
         "transit_encryption": "ipsec"}]
}'

Quando la proprietà transit_encryption è impostata su ipsec, la cifratura in transito con un certificato di identità dell'istanza è abilitata. Il valore predefinito della proprietà " transit_encryption è " none, che disabilita la crittografia in transito. Tuttavia, se allowed_transit_encryption_modes è specificato come ipsec, la destinazione di montaggio deve essere creata con ipsec come valore di transit_encryption.

Una risposta corretta è simile all'esempio riportato di seguito.

 {
    "access_control_mode": "security_group",
    "allowed_transit_encryption_modes": ["ipsec"],
    "created_at": "2023-09-23T12:15:12Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/90c4bb62-1724-47bd-8c45-f7d37d7c3508/mount_targets/7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "id": "7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "lifecycle_state": "pending",
    "mount_path": "",
    "name": "myshare-1",
    "primary_ip": {"address": ""},
    "resource_type": "share_target",
    "size": 10,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "name": "subnet-2",
        "resource_type": "subnet"
    },
    "transit_encryption": "ipsec",
    "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interface/710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "id": "710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "name": "enlace-traverse-oat-console",
        "resource_type": "VirtualNetworkInterface"
    },
    "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "id": "82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "name": "my-vpc-2",
        "resource_type": "vpc"
    },
    "user_tags": []
}

L'esempio seguente mostra come aggiungere una destinazione di montaggio a una condivisione di file regionale. Per abilitare la crittografia in transito per una destinazione di condivisione file regionale, specificare "stunnel".

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "allowed_transit_encryption_modes": ["stunnel","none"],
    "size": 5000,
    "name": "my-regional-share-1",
    "profile": {"name": "rfs"},
     "mount_targets": [{
         "virtual_network_interface": {"subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"}},
         "transit_encryption": "stunnel"}]
}'

Quando la proprietà transit_encryption è impostata su stunnel, la crittografia in transito è abilitata ed è necessario completare alcuni passaggi di configurazione sul compute host per montare la condivisione di file in modo sicuro. Nell'esempio, allowed_transit_encryption_modes è specificato come stunnel,none, quindi la destinazione di montaggio può avere uno di questi valori come valore di transit_encryption.

Una risposta corretta è simile all'esempio riportato di seguito.

 {
    "access_control_mode": "security_group",
    "accessor_binding_role": "none",
    "allowed_access_protocols": ["nfs4"],
    "allowed_transit_encryption_modes": ["stunnel"],
    "availability_mode": "regional",
    "access_control_mode": "security_group",
    "bandwidth": 2000,
    "created_at": "2025-09-23T12:15:12Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/90c4bb62-1724-47bd-8c45-f7d37d7c3508/mount_targets/7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "id": "7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "lifecycle_state": "pending",
    "mount_path": "",
    "name": "my-regional-share-1",
    "primary_ip": {"address": ""},
    "resource_type": "share_target",
    "size": 5000,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "storage_generation": 2,
    "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "name": "subnet-2",
        "resource_type": "subnet"
    },
    "transit_encryption": "stunnel",
    "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interface/710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "id": "710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "name": "enlace-traverse-oat-console",
        "resource_type": "VirtualNetworkInterface"
    },
    "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "id": "82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "name": "my-vpc-2",
        "resource_type": "vpc"
    },
    "user_tags": []
}

Creazione di una condivisione file e di una destinazione di montaggio specificando una sottorete e un gruppo di protezione

Per creare l'interfaccia di rete di destinazione del montaggio, effettua una richiesta POST /shares e specifica una sottorete e un gruppo di sicurezza. I gruppi di sicurezza associati a una destinazione di montaggio devono consentire l'accesso in entrata al protocollo TCP sulla porta NFS da tutti i server in cui si desidera montare la condivisione.

Nell'esempio seguente, la proprietà mount_targets specifica un ID di sottorete e un ID di gruppo di sicurezza. Quando la proprietà transit_encryption è impostata su ipsec, abilita la crittografia in transito utilizzando un certificato di identità dell'istanza. Questa opzione è applicabile solo alle condivisioni di file zonali. Le condivisioni di file regionali utilizzano stunnel per la crittografia in transito. Il valore predefinito è none, che disabilita la crittografia in transito.

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "size": 20,
    "iops": 100,
    "name": "myshare-3",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"},
    "allowed_transit_encryption_modes": ["ipsec"],
    "mount_targets": [{
        "virtual_network_interface": {
            "subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"},
            "security_groups": [{"id": "34c09abb-37bf-4ef6-88bb-f63a0ef28915"}]
        },
        "transit_encryption": "ipsec"
      }]
    }'

L'esempio seguente mostra la risposta dell'API andata a buon fine.

{
    "access_control_mode": "security_group",
    "allowed_transit_encryption_modes": ["ipsec"],
    "created_at": "2025-09-23T12:55:40Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-56f91d4a-2801-470a-b368-176bde64e954",
    "id": "r006-56f91d4a-2801-470a-b368-176bde64e954",
    "initial_owner": {
        "gid": 0,
        "uid": 0
    },
    "iops": 100,
    "lifecycle_state": "pending",
    "name": "myshare-3",
    "mount_targets": [
        {
            "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-56f91d4a-2801-470a-b368-176bde64e954/mount_targets/r006-b8573e2c-60ee-4ecc-9eae-c52f890a8195",
            "id": "r006-b8573e2c-60ee-4ecc-9eae-c52f890a8195",
            "name": "sticky-idealist-spoiled-sloppily",
            "resource_type": "share_target",
            "transit_encryption": "ipsec"
        }
    ],
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
        "name": "dp2",
        "resource_type": "share_profile"
    },
    "replication_role": "none",
    "replication_status": "none",
    "replication_status_reasons": [],
    "resource_group": {
        "crn": "crn:[...]",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups//678523bcbe2b4eada913d32640909956",
        "id": "678523bcbe2b4eada913d32640909956",
        "name": "Default"
    },
    "resource_type": "share",
    "size": 20,
    "snapshot_count": 10,
    "snapshot_size": 10,
    "user_tags": [],
    "zone": {
        "href": "https://us-south.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
}

Creazione di una condivisione file e di una destinazione di montaggio specificando un'interfaccia di rete virtuale

Per eseguire questa operazione, è necessario avere già un'interfaccia di rete virtuale e che questa non sia collegata a un'altra risorsa. Un'interfaccia di rete virtuale a cui è associato un indirizzo IP secondario non può essere accettata come destinazione di montaggio di una condivisione file.

Effettuare una richiesta POST /shares e creare una destinazione di montaggio con un'interfaccia di rete virtuale. Specificare l'ID di un'interfaccia di rete virtuale non collegata nella proprietà 'virtual_network_interface della destinazione di montaggio.

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "size": 10,
    "name": "my-share-sc-2",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-3"},
    "allowed_transit_encryption_modes": ["none"],
    "mount_targets": [{
        "name": "mount-target-1",
        "transit_encryption": "none",
        "virtual_network_interface": {"id": "0767-fa41aecb-4f21-423d-8082-630bfba1e1d9"}
      }]
    }'

Creare una condivisione di file da un'istantanea con l'API

Per ulteriori informazioni su come creare una condivisione di file da un'istantanea, vedere Ripristino dei dati da un'istantanea di condivisione di file.

Aggiunta di ID supplementari quando si crea una condivisione file con l'API

Quando si monta una condivisione di file in Linux, l'ID utente (UID) e l'ID gruppo (GID) possono essere usati per assegnare la proprietà di tutti i file e le cartelle di quella condivisione.

Con l'API, puoi impostare i valori UID e GID per la proprietà initial_owner per controllare l'accesso alle tue condivisioni file. Ovunque si monti la condivisione di file, la cartella principale deve utilizzare l'ID utente e l'ID gruppo. È possibile impostare UID o GID, o entrambi, quando si crea una quota in una chiamata POST /shares.

Se si modificano le autorizzazioni degli utenti e dei gruppi locali dall'istanza del server virtuale, non è possibile determinare che siano state modificate dal Cloud. Di conseguenza, il valore di initial_owner non cambia nelle risposte dell'API.

La tabella seguente mostra i valori UID e GID che è possibile impostare e i valori riservati.

Unix/Linux® supplemental ID values.
Valore ID Descrizione
UID
UID 0 Riservato per root.
UID 1-99 Riservato per account predefiniti.
UID 100 - 999 Riservato dal sistema per account e gruppi del sistema di amministrazione.
UID 1000 - 10000 Utilizzato dall'account delle applicazioni.
UID 10000 + Disponibile per gli account utente.
GID
GID 0 Riservato per root.
GID 1-99 Riservato per il sistema e l'applicazione.
GID 100 + Assegnato per il gruppo dell'utente.

Per impostare gli ID supplementari quando si crea una condivisione, effettuare una chiamata POST /shares e specificare la proprietà initial_owner con gli ID supplementari. Vedi il seguente esempio.

curl -X POST \
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "initial_owner": {"gid": 101,"uid": 10001},
    "size": 4800,
    "name": "share-name",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"}
     .
     .
     .
   }'

Creazione di una condivisione file con Terraform

Per utilizzare Terraform, scaricare la CLI di Terraform e configurare il plug-in IBM Cloud® Provider. Per ulteriori informazioni, vedi Introduzione a Terraform.

I servizi dell'infrastruttura VPC utilizzano uno specifico endpoint regionale, che per impostazione predefinita punta a us-south. Se il tuo VPC viene creato in un'altra regione, assicurati di specificare la regione appropriata nel blocco del provider nel file provider.tf.

Vedi il seguente esempio di destinazione di una regione diversa da quella predefinita us-south.

provider "ibm" {
   region = "eu-de"
}

Creare una condivisione zonale di file con Terraform

Per creare una condivisione file, utilizzare la risorsa ibm_is_share. L'esempio seguente crea una condivisione con disponibilità zonale, capacità di 200 GB, 500 IOPS e il profilo di prestazioni dp2.

resource "ibm_is_share" "zonalexample" {
  allowed_transit_encryption_modes = ["ipsec", "none"]
  name                             = "my-new-share"
  size                             = "200"
  iops                             = "500"
  profile                          = "dp2"
  zone                             = "us-south-2"
}

Creare una condivisione di file regionale con Terraform

L'esempio seguente crea una condivisione con disponibilità regionale, capacità di 200 GB, larghezza di banda di 800 Mbps e profilo di prestazioni rfs.

resource "ibm_is_share" "regionalexample" {
  access_control_mode              = "security_group"
  allowed_transit_encryption_modes = ["stunnel", "none"]
  bandwidth                        = "800"
  name                             = "my-share"
  profile                          = "rfs"
  size                             = "200"
}

Creazione di una condivisione di file zonale con una replica con Terraform

Per creare una condivisione file, utilizzare la risorsa ibm_is_share. Per aggiungere una replica, definire la condivisione della replica in maniera simile al seguente esempio. Crea una condivisione con capacità di 220 GB e il profilo delle prestazioni dp2. L'argomento replica_share definisce il nome della condivisione della replica, la frequenza di replica (in cron spec), il profilo delle prestazioni e la zona in cui deve essere creata la condivisione della replica.

resource "ibm_is_share" "example-2" {
  allowed_transit_encryption_modes = "none"
  iops                             = "800"
  name                             = "my-share"
  profile                          = "dp2"
  size                             = "220"
  zone                             = "us-south-1"
  replica_share {
    name                           = "my-replica"
    replication_cron_spec          = "0 */5 * * *"
    profile                        = "dp2"
    zone                           = "us-south-3"
  }
}

Creare una condivisione di file da un'istantanea con Terraform

Per ulteriori informazioni su come creare una condivisione di file da un'istantanea, vedere Ripristino dei dati da un'istantanea di condivisione di file.

Creazione di una destinazione di montaggio con Terraform

Per creare una destinazione di montaggio per una condivisione file che fornisce l'autenticazione granulare con l'utilizzo dei gruppi di sicurezza, utilizzare la risorsa ibm_is_share_mount_target. Il seguente esempio crea una destinazione di montaggio con modalità di controllo accessi security_group. Innanzitutto, specificare la condivisione per la quale viene creata la destinazione di montaggio. Quindi, specificare il nome della destinazione di montaggio e definire la nuova interfaccia di rete virtuale fornendo un indirizzo IP e un nome. È inoltre necessario specificare il gruppo di protezione che si desidera utilizzare per gestire l'accesso alla condivisione file a cui è associata la destinazione di montaggio. I gruppi di sicurezza associati a una destinazione di montaggio devono consentire l'accesso in entrata al protocollo TCP sulla porta NFS da tutti i server in cui si desidera montare la condivisione. L'attributo auto_delete = true indica che l'interfaccia di rete virtuale deve essere eliminata se la destinazione di montaggio viene eliminata.

resource "ibm_is_share_mount_target" "zonal-target-with-vni" {
     access_protocol    = "nfs4"
     name               = "my-example-mount-target"
     security_groups    = [<security_group_ids>]
     share              = ibm_is_share.is_share.ID
     transit_encryption = "none"
     virtual_network_interface {
         name = "my-example-vni"
         primary_ip {
            reserved_ip = ibm_is_subnet_reserved_ip.example.reserved_ip.id
         }
     }
}

L'esempio precedente non abilita la crittografia in transito. Se si desidera proteggere i dati durante il transito con la crittografia, specificare il valore dell'attributo transit_encryption come ipsec per le condivisioni di file zonali o stunnel per le condivisioni di file regionali. È anche possibile creare una VNI per la destinazione di montaggio specificando la subnet e lasciando che il sistema scelga un indirizzo IP da quella subnet. Vedi il seguente esempio:

resource "ibm_is_share_mount_target" "regional-mount-target-with-vni" {
  access_protocol    = "nfs4"
  name               = "my-example-mount-target"
  share              = ibm_is_share.example.id
  transit_encryption = "stunnel"
  virtual_network_interface {
       subnet        = ibm_is_subnet.example.id
       name          = "my-example-vni"
  }
}

Obsoleto

È inoltre possibile creare una destinazione di montaggio per una condivisione di file zonale con la modalità di accesso VPC utilizzando la risorsa is_share_mount_target. Il seguente esempio crea una destinazione di montaggio con il nome my-share-target per la condivisione file specificata dal relativo ID. Quando viene creata la destinazione di montaggio, tutte le istanze del server virtuale nel VPC possono montare la condivisione utilizzandola. La crittografia in transito non è supportata.

resource "ibm_is_share_mount_target" "mount-target-without-vni" {
     name   = <share_target_name>
     share  = ibm_is_share.is_share.ID
     vpc    = <vpc_id>
}

Per ulteriori informazioni sugli argomenti e sugli attributi, consultare ibm_is_share_mount_target.

Creare una condivisione di file con un obiettivo di montaggio con Terraform

Non è necessario creare separatamente la condivisione file e la destinazione di montaggio.

Creazione di una condivisione file con una destinazione di montaggio con la modalità di accesso del gruppo di protezione

Per creare una condivisione file con una destinazione di montaggio che consente l'autenticazione basata sui gruppi di protezione in un VPC, utilizza la risorsa ibm_is_share. Specificare la modalità di controllo dell'accesso come security_group e definire la destinazione di montaggio fornendo un nome, i dettagli dell'interfaccia di rete virtuale come il nome, la sottorete o l'indirizzo IP. Inoltre, specificare i gruppi di protezione che si desidera utilizzare per controllare l'accesso alla condivisione file. I gruppi di sicurezza associati a una destinazione di montaggio devono consentire l'accesso in entrata al protocollo TCP sulla porta NFS da tutti i server in cui si desidera montare la condivisione.

resource "ibm_is_share" "share4" {
   access_control_mode              = "security_group"
   allowed_transit_encryption_modes = "ipsec"
   iops                             = "3000"
   name                             = "my-share4"
   profile                          = "dp2"
   size                             = "800"
   zone                             = "us-south-2"
   mount_target {
       access_protocol              = "nfs4"
       name                         = "my-mount-target"
       resource_group               = <resource_group_id>
       security_groups.             = [<security_group_ids>]
       transit_encryption           = "ipsec"
       virtual_network_interface {
          primary_ip {
              address               = "10.240.64.5"
              auto_delete           = true
              name                  = "my-example-pip"
          }
       }
   }
}

L'esempio precedente abilita la crittografia in transito per una condivisione di file zonale. Quando si desidera proteggere i dati con la crittografia di transito per una condivisione reginale, specificare l'argomento transit_encryption come stunnel.

Per ulteriori informazioni sugli argomenti e gli attributi, vedi ibm_is_share.

Creazione di una condivisione file con una destinazione di montaggio con la modalità di accesso a livello VPC

Deprecato La modalità di controllo dell'accesso VPC è deprecata. Selezionare invece l'opzione Gruppo di sicurezza.

Per creare una condivisione di file zonale con una destinazione di montaggio accessibile a tutte le istanze di server virtuale all'interno di una VPC, utilizzare la risorsa ibm_is_share. Specifica la modalità di controllo dell'accesso come vpc e definisci la destinazione di montaggio fornendo un nome per essa e il VPC in cui verrà utilizzata.

resource "ibm_is_share" "share3" {
    access_control_mode   = "vpc"
    iops                  = "800"
    name                  = "my-share3"
    profile               = "dp2"
    size                  = "700"
    zone                  = "us-south-2"
    mount_target {
          access_protocol = "nfs4"
          name            = "my-mount-target"
          vpc             = <vpc_id>
    }
}

Il montaggio tra zone e la codifica in transito non sono supportati per questo tipo di condivisione file.

Aggiunta di ID supplementari quando si crea una condivisione di file con Terraform

Quando si monta una condivisione di file in Linux, l'ID utente (UID) e l'ID gruppo (GID) possono essere usati per assegnare la proprietà di tutti i file e le cartelle di quella condivisione. È possibile specificare i valori UID e GID per la proprietà initial_owner per controllare l'accesso alle condivisioni di file. Ovunque si monti la condivisione di file, la cartella principale deve utilizzare l'ID utente e l'ID gruppo.

Se si modificano le autorizzazioni degli utenti e dei gruppi locali dall'istanza del server virtuale, non è possibile determinare che siano state modificate dal Cloud. Di conseguenza, il valore di initial_owner non cambia.

La tabella seguente mostra i valori UID e GID che è possibile impostare e i valori riservati.

Unix/Linux® supplemental ID values.
Valore ID Descrizione
UID
UID 0 Riservato per root.
UID 1-99 Riservato per account predefiniti.
UID 100 - 999 Riservato dal sistema per account e gruppi del sistema di amministrazione.
UID 1000 - 10000 Utilizzato dall'account delle applicazioni.
UID 10000 + Disponibile per gli account utente.
GID
GID 0 Riservato per root.
GID 1-99 Riservato per il sistema e l'applicazione.
GID 100 + Assegnato per il gruppo dell'utente.

Utilizzando la risorsa ibm_is_share, specificare l'UID, il GID o entrambi nell'argomento initial_owner. Vedi il seguente esempio.

resource "ibm_is_share" "example" {
  allowed_transit_encryption_modes = "none"
  name                             = "my-new-share"
  size                             = "200"
  iops                             = "500"
  profile                          = "dp2"
  zone                             = "us-south-2"
  initial_owner {
        gid = "10042"
        uid = "123"
  }
}

Passi successivi

Montare le condivisioni file. Il montaggio è un processo con cui il sistema operativo di un server rende i file e le directory sul dispositivo di archiviazione disponibili per l'accesso da parte degli utenti attraverso il file system del server. Per ulteriori informazioni, vedi i seguenti argomenti:

Gestire le condivisioni file e i dati. Per ulteriori informazioni, vedi i seguenti argomenti: