Gestione delle condivisioni file, dei bind di condivisione accessor e delle destinazioni di montaggio

Gestire le condivisioni di File Storage for VPC rinominandole, ampliandone la capacità, regolando gli IOPS e la larghezza di banda, aggiungendo destinazioni di montaggio e gestendo i collegamenti delle condivisioni di accesso.

File Storage for VPC il servizio richiede le autorizzazioni IAM per il controllo degli accessi basato sui ruoli. Ad esempio, per creare una condivisione file, è necessario disporre almeno delle autorizzazioni di editor. Per ulteriori informazioni, vedere Gestione dell'accesso IAM per i servizi di infrastruttura VPC per le condivisioni di file.

Differenze nella gestione delle condivisioni di file normali e delle condivisioni accessor

Le seguenti sezioni contengono istruzioni per modificare e aggiornare varie proprietà di condivisioni file e destinazioni di montaggio. A causa della natura delle condivisioni accessor, alcune proprietà (ad esempio, il profilo di condivisione file, la modalità di controllo accessi o le modalità di codifica di transito consentite) non possono essere modificate. Queste proprietà vengono ereditate dalla condivisione origine. Per le proprietà di condivisione dell'accessor che è possibile modificare, i passaggi sono gli stessi dell'aggiornamento di una condivisione normale. Sebbene non sia possibile creare un'istantanea di una condivisione accessor, se la condivisione di origine ha delle istantanee, è possibile accedere alle istantanee nella directory .snapshot. Questa directory è di sola lettura.

Gestione delle condivisioni di file, dei binding delle condivisioni accessorie e dei target di montaggio nella console

Nella console, è possibile:

Nella console, è possibile gestire le normali condivisioni file e le condivisioni accessor. Solo il proprietario della condivisione può modificare proprietà come la modalità di controllo accessi, IOPS e profilo. L'account del programma di accesso non può modificare la condivisione di origine e può modificare una serie più piccola di proprietà della condivisione del programma di accesso.

Le istantanee sono supportate solo per le condivisioni che hanno il gruppo di sicurezza come modalità di controllo dell'accesso. Non è possibile cambiare la modalità di controllo dell'accesso in VPC se non vengono eliminate tutte le istantanee della condivisione.

Rinominare una condivisione di file nella console

  1. Nella pagina Dettagli condivisioni file, fare clic sull'icona Modifica icona Modifica accanto al nome della condivisione file.

  2. Assegnare un nuovo nome alla condivisione di file.

I nomi validi delle condivisioni di file possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle condivisioni di file devono iniziare con una lettera minuscola.

Rinominare una destinazione di montaggio di una condivisione di file nella console

  1. Andare alla pagina Dettagli condivisioni file.
  2. Fare clic sull'icona Azioni icona Azioni.
  3. Selezionare Rinomina.
  4. Inserisci un nuovo nome e fai clic su " Rinomina ".

I nomi validi delle destinazioni di montaggio possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle destinazioni di montaggio devono iniziare con una lettera minuscola.

Aggiornamento di un profilo di condivisione file nella console

Queste istruzioni si riferiscono alla precedente generazione di profili di condivisione file (scopo generale, 5-iop, 10-iop o personalizzato) utilizzati nella versione beta delle condivisioni file zonali. A partire dal 06 maggio 2026, questi profili azionari sono deprecati. Per accedere alle funzioni attuali, è necessario modificare il profilo IOPS della condivisione in dp2. I profili delle condivisioni di file creati con il profilo dp2 o rfs non possono essere modificati.

Puoi modificare il profilo per una condivisione file dal profilo corrente a un altro profilo livello IOPS, a un profilo personalizzato o a un profilo di dp2 ad alte prestazioni. La fatturazione si adatta al profilo scelto.

  1. Andare alla pagina Dettagli condivisioni file.
  2. Fai clic su Icona Modifica Icona Modifica accanto al profilo corrente oppure utilizza il menu Azioni Icona Azioni e seleziona Modifica profilo IOPS. Un pannello laterale mostra il profilo corrente, la dimensione della condivisione file e l'IOPS massimo.
  3. Per un Nuovo profilo, fare clic sulla freccia verso il basso. Puoi selezionare un nuovo livello IOPS, un profilo personalizzato o dp2. Per IOPS personalizzati o dp2, specifica un nuovo IOPS massimo in base alla dimensione della condivisione file. Il prezzo della condivisione file viene calcolato automaticamente in base alla selezione.
  4. Fai clic su " Salva e continua ".

Aggiornamento delle modalità di crittografia del transito consentite nella console

Il proprietario di una condivisione può modificare le modalità di crittografia del transito consentite. Tuttavia, prima di poter modificare questa proprietà, è necessario eliminare tutti i bind. L'eliminazione dei bind interrompe il percorso di rete tra la condivisione del file di origine e la condivisione del programma di accesso e pone la destinazione di montaggio collegata alla condivisione del programma di accesso in uno stato di errore. Per ulteriori informazioni, vedi Rimozione dell'accesso a una condivisione file da altri account.

  1. Selezionare una condivisione file dall'elenco di condivisioni file.
  2. Nella pagina Dettagli condivisione file, individuare le modalità di cifratura di transito consentite.
  3. Fare clic sull'icona Modifica icona Modifica per modificare il valore corrente.

Gestione delle condivisioni file, dei bind di condivisione accessor e delle destinazioni di montaggio dalla CLI

Utilizzando la CLI, puoi:

Le istantanee sono supportate solo per le condivisioni che hanno il gruppo di sicurezza come modalità di controllo dell'accesso. Non è possibile cambiare la modalità di controllo dell'accesso in VPC se non vengono eliminate tutte le istantanee della condivisione.

Ridenominazione di una condivisione file dalla CLI

  1. Individuare la condivisione file che si desidera ridenominare elencando le condivisioni file nella regione con il comando ibmcloud is shares. Prendete nota del nome e dell'ID della condivisione di file.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile    Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
    r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2        10         defaults         none               none                    0                0
    r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2        10         defaults         none               none                    0                0
    r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2        10         defaults         replica            none                    0                0
    r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2        10         defaults         source             none                    0                0
    r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2        10         defaults         replica            none                    0                0
    r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2        10         defaults         source             none                    0                0
    r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
    
  2. Eseguire il comando ibmcloud is share-update e specificare un nuovo nome di condivisione file con le opzioni --name.

    ibmcloud is share-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 --name my-renamed-share
    
    Updating file share r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 under account Test Account as user test.user@ibm.com...
    ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Name                         my-renamed-share
    CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Lifecycle state              stable
    Access control mode          vpc
    Zone                         us-south-2
    Profile                      dp2
    Size(GB)                     100
    IOPS                         100
    Encryption                   ipsec
    Mount Targets                ID                          Name
                                 No mounted targets found.
    Resource group               ID                                 Name
                                 6edefe513d934fdd872e78ee6a8e73ef   defaults
    Created                      2023-08-01T17:02:01+00:00
    Encryption key               crn:v1:bluemix:public:kms:eu-de:a/a1234567:key:f602ae93-b915-49bc-a0e1-af29c73e7788
    Latest job                   Job status   Job status reasons
                                 -            -
    Replication cron spec        00 11 * * 0
    Replication role             replica
    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
    

I nomi validi delle condivisioni di file possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle condivisioni di file devono iniziare con una lettera minuscola.

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-update.

Ridenominazione di una destinazione di montaggio di una condivisione file dalla CLI

  1. Elencare le condivisioni file nella regione con il comando ibmcloud is shares. Prendere nota del nome e dell'ID della condivisione file con la destinazione di montaggio che si desidera ridenominare.

  2. Utilizzare il nome o l'ID della condivisione per trovare le relative destinazioni di montaggio con il comando ibmcloud is share-mount-targets.

    ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    
    Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                     VPC      Lifecycle state   Transit Encryption
    r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target   my-vpc   stable            none
    
  3. Per ridenominare la destinazione di montaggio, eseguire il comando share-mount-target-update con il nome o l'ID della condivisione file e il nome della destinazione di montaggio. Specificare un nuovo nome di destinazione di montaggio con l'opzione --name.

    ibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
    

I nomi validi delle destinazioni di montaggio possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle destinazioni di montaggio devono iniziare con una lettera minuscola.

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-mount-target-update.

Aggiornamento di un profilo di condivisione file nella CLI

Queste istruzioni si riferiscono alla precedente generazione di profili di condivisione file (scopo generale, 5-iop, 10-iop o personalizzato) utilizzati nella versione beta delle condivisioni file zonali. A partire dal 06 maggio 2026, questi profili azionari sono deprecati. Per accedere alle funzioni attuali, è necessario modificare il profilo IOPS della condivisione in dp2. I profili delle condivisioni di file creati con il profilo dp2 o rfs non possono essere modificati.

  1. Individuare la condivisione file che si desidera aggiornare elencando le condivisioni file nella regione con il comando ibmcloud is shares.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile    Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
    r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2        10         defaults         none               none                    0                0
    r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2        10         defaults         none               none                    0                0
    r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2        10         defaults         replica            none                    0                0
    r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2        10         defaults         source             none                    0                0
    r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2        10         defaults         replica            none                    0                0
    r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2        10         defaults         source             none                    0                0
    r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
    
  2. Utilizzare il comando share-update con il parametro --profile per indicare il nuovo profilo di condivisione file per nome.

    ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000
    
    Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com...
    ID                           r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
    Name                         my-old-file-share
    CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
    Lifecycle state              updating
    Access control mode          vpc
    Zone                         us-south-1
    Profile                      dp2
    Size(GB)                     1000
    IOPS                         3000
    User Tags                    env:dev,env:prod
    Encryption                   provider_managed
    Mount Targets                ID                                          Name
                                 r006-c9d82a15-7ead-4388-abc8-88e81c12ed28   my-target121
    Resource group               ID                                 Name
                                 6edefe513d934fdd872e78ee6a8e73ef   defaults
    Created                      2023-03-27T20:43:36+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
    

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-update.

Aggiornamento delle modalità di crittografia di transito consentite dalla CLI

Il proprietario della condivisione può aggiornare le modalità di crittografia di transito consentite con i seguenti valori.

  • Per le condivisioni di file zonali, i valori consentiti sono ipsec,none,ipsec, o none.
  • Per le condivisioni di file regionali, i valori consentiti sono stunnel,none, stunnel, o none.

Tuttavia, prima che questa proprietà possa essere modificata, tutti i binding e i target di montaggio devono essere cancellati. L'eliminazione dei bind interrompe il percorso di rete tra la condivisione del file di origine e la condivisione del programma di accesso e pone la destinazione di montaggio collegata alla condivisione del programma di accesso in uno stato di errore. Per ulteriori informazioni, vedere Rimozione dell'accesso a una condivisione di file da altri account.

ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes ipsec
Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                               r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                             my-origin-share
CRN                              crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state                  stable
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec
Origin share CRN                                                                                             Name            Remote account  Remote region
                                 crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed  my-origin-share a7654321        -
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
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T22:15:15+00:00
Replication role                 none
Replication status               none
Replication status reasons       Status code   Status message
                                 -             -
 Allowed Access Protocols        nfs4
 Availability Mode               zonal
 Bandwidth(Mbps)                 1
 Storage Generation              1

Gestione delle condivisioni file, dei bind di condivisione accessor e delle destinazioni di montaggio con l'API

Utilizzando l'API, puoi:

Per visualizzare informazioni sui metodi API File Storage for VPC, consultare la sezione seguente nella Guida di riferimento API.

Le istantanee sono supportate solo per le condivisioni che hanno il gruppo di sicurezza come modalità di controllo dell'accesso. Non è possibile cambiare la modalità di controllo dell'accesso in VPC se non vengono eliminate tutte le istantanee della condivisione.

Ridenominazione di una condivisione file con l'API

Effettuare una chiamata PATCH /shares/$share_id per ridenominare una condivisione file specifica. Vedi il seguente esempio.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"\
  -d '{"name": "share-renamed1"}'

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

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-17T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-renamed1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
    "name": "tier-10iops",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 100,
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

I nomi validi delle condivisioni di file possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle condivisioni di file devono iniziare con una lettera minuscola.

Ridenominazione di una destinazione di montaggio di una condivisione file con l'API

Effettuare una chiamata PATCH /shares/$share_id/mount_targets/$target_id per ridenominare una destinazione di montaggio di una condivisione file. Vedi il seguente esempio.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{"name": "target-renamed1"}

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

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-18T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "stable",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
  "name": "target-renamed1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
    "id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

I nomi validi delle destinazioni di montaggio possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle destinazioni di montaggio devono iniziare con una lettera minuscola.

Aggiornamento di un profilo di condivisione file con l'API

Queste istruzioni si riferiscono alla precedente generazione di profili di condivisione file (scopo generale, 5-iop, 10-iop o personalizzato) utilizzati nella versione beta delle condivisioni file zonali. A partire dal 06 maggio 2026, questi profili azionari sono deprecati. Per accedere alle funzioni attuali, è necessario modificare il profilo IOPS della condivisione in dp2. I profili delle condivisioni di file creati con il profilo dp2 o rfs non possono essere modificati.

Effettuare una chiamata PATCH /shares/{share_ID} e specificare il nome del profilo nella proprietà profile. Il seguente esempio modifica il profilo in un profilo dp2.

curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{"profile": {"name": "dp2"}}'

Aggiornamento delle modalità di crittografia di transito consentite con l'API

Il proprietario della condivisione può aggiornare le modalità di crittografia di transito consentite con i seguenti valori.

  • Per le condivisioni di file zonali, i valori consentiti sono ipsec,none,ipsec, o none.
  • Per le condivisioni di file regionali, i valori consentiti sono stunnel,none, stunnel, o none.

Tuttavia, prima che questa proprietà possa essere modificata, tutti i binding e i target di montaggio devono essere cancellati. L'eliminazione dei bind interrompe il percorso di rete tra la condivisione del file di origine e la condivisione del programma di accesso e pone la destinazione di montaggio collegata alla condivisione del programma di accesso in uno stato di errore. Per ulteriori informazioni, vedi Rimozione dell'accesso a una condivisione file da altri account.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"
  -d '{"allowed_transit_encryption_modes": "ipsec"}'

Gestione delle condivisioni file, dei bind di condivisione accessor e delle destinazioni di montaggio con Terraform

Con Terraform, è possibile:

Aggiornamento degli attributi di una condivisione file con Terraform

Aggiornare la risorsa ibm_is_share per modificare gli attributi della condivisione file come nome, dimensione, profilo, tag. Quando viene applicato, il seguente esempio aggiorna il nome della condivisione in new_name.

resource "ibm_is_share" "example" {
  name    = "new_name"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

I nomi validi per la condivisione di file e la destinazione di montaggio possono includere una combinazione di caratteri alfanumerici minuscoli (a-z, 0-9) e il trattino (-), per un massimo di 63 caratteri. I nomi delle condivisioni di file devono iniziare con una lettera minuscola.

Alcuni attributi, come il profilo, le modalità di crittografia in transito consentite e la crittografia a riposo, non sono modificabili per le condivisioni degli accessi.

Il proprietario della condivisione può aggiornare le modalità di crittografia di transito consentite con i seguenti valori.

  • Per le condivisioni di file zonali, i valori consentiti sono ipsec,none,ipsec, o none.
  • Per le condivisioni di file regionali, i valori consentiti sono stunnel,none, stunnel, o none.

Tuttavia, prima che questa proprietà possa essere modificata, tutti i binding e i target di montaggio devono essere cancellati. L'eliminazione dei bind interrompe il percorso di rete tra la condivisione del file di origine e la condivisione del programma di accesso e pone la destinazione di montaggio collegata alla condivisione del programma di accesso in uno stato di errore. Per ulteriori informazioni, vedere Rimozione dell'accesso a una condivisione di file da altri account.

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

Aggiornamento degli attributi di una destinazione di montaggio con Terraform

Aggiornare la risorsa ibm_is_share_mount_target per modificare il nome della destinazione di montaggio. Quando applicata, la seguente risorsa modifica il nome della destinazione di montaggio in my-new-share-target.

resource "ibm_is_share_mount_target" "is_share_target" {
  access_protocol    = "nfs4"
  name               = "my-new-share-target"
  share              = is_share.is_share.id
  subnet             = ibm_is_subnet.example.id
}`

Per ulteriori informazioni sugli argomenti e gli attributi, consultare ibm_is_share_target.

Aggiunta di tag utente a una condivisione file

È possibile aggiungere tag utente a condivisioni file nuove o esistenti, modificare ed eliminare tag per una condivisione file con l'interfaccia utente, la CLI, l'API e Terraform. Puoi visualizzare le tag in tutto il tuo account filtrando per tag dal tuo elenco di risorse. È anche possibile aggiungere tag utente alle condivisioni file di replica.

È possibile collegare o scollegare fino a 100 tag nella stessa operazione. Quando si modificano i tag, i nuovi tag sovrascrivono quelli esistenti. Per mantenere i tag gestibili, creare solo il numero di tag utente richiesto per gestire in modo efficace la risorsa.

Puoi gestire le tue tag in IBM Cloud con Global Tagging API. Con questa API, è possibile creare, eliminare, ricercare, allegare o scollegare tag. Per ulteriori informazioni sulla gestione delle tag per il tuo account, vedi Gestione delle tag.

Aggiunta di tag utente alla condivisione di file nella console

È possibile aggiungere tag utente a una condivisione di file nella console.

  1. Andare alla lista delle condivisioni file. 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 per visualizzarne i dettagli.
  3. Nella pagina dei dettagli della condivisione file, i tag utente vengono visualizzati accanto al nome della condivisione file. Fare clic sull'icona Modifica Icona Modifica per modificare i tag.
  4. Nella finestra Modifica tag, immettere un tag nella casella di testo Tag utente.
  5. Fare clic su Salva.

Aggiunta o modifica di tag utente di condivisione file dalla CLI

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.

È possibile aggiungere tag quando si esegue il provisioning di una condivisione file con il comando ibmcloud is share-create. L'opzione --user-tags specifica le tag per la condivisione file. Per ulteriori informazioni, vedi Creazione di una condivisione file con una destinazione di montaggio dalla CLI.

È possibile aggiungere e rimuovere tag quando si aggiorna una condivisione file con il comando ibmcloud is share-update.

  1. Individua la tua condivisione dalla CLI elencando le tue condivisioni file nella regione con il comando ibmcloud is shares.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
    r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
    r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
    r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
    r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
    r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
    r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0
    
  2. Richiamare i dettagli della condivisione file con il comando ibmcloud is share.

    ibmcloud is share my-file-share
    
    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
    ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Name                         my-file-share
    CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Lifecycle state              stable
    Access control mode          security_group
    Accessor binding role        none
    Zone                         us-south-2
    Profile                      dp2
    Size(GB)                     1000
    IOPS                         1000
    Encryption                   provider_managed
    Mount Targets                ID                                          Name
                                 r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target
    Resource group               ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
    Created                      2023-10-18T22:15:15+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
    

    L'esempio seguente mostra le informazioni restituite dal comando ibmcloud is share quando si recuperano informazioni su una condivisione di file regionale.

    ibmcloud is share my-regional-file-share
    
    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
    ID                                 r006-9ae55188-610e-4cf9-9350-d0b675026ff8
    Name                               my-regional-file-share
    CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-9ae55188-610e-4cf9-9350-d0b675026ff8
    Lifecycle state                    stable
    Access control mode                security_group
    Accessor binding role              none
    Allowed transit encryption modes   stunnel,none
    Zone                               -
    Profile                            rfs
    Size(GB)                           1000
    IOPS                               35000
    Encryption                         provider_managed
    Mount Targets                      ID                          Name
                                       No mounted targets foun
    Resource group                     ID                                 Name
                                       db8e8d865a83e0aae03f25a492c5b39e   Default
    Created                            2025-07-22T22:15:15+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           nsf4
    Availability Mode                  regional
    Bandwidth(Mbps)                    125
    Storage Generation                 2
    
  3. Utilizzare il comando ibmcloud is share-update con l'opzione --user-tags per aggiungere un tag alla condivisione file. Se la condivisione file aveva delle tag in precedenza, esse vengono sovrascritte dalle tag specificate nel comando.

L'esempio seguente aggiunge due tag utente alla condivisione di file.

ibmcloud is share-update my-file-share --user-tags daily-backup-plan,docs:test
Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              stable
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1500
IOPS                         2000
User Tags                    daily-backup-plan,docs:test
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+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

Aggiunta o modifica dei tag utente della condivisione file con l'API

Quando si utilizza l'API, è 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.

Aggiunta di un tag utente quando viene creata una condivisione file

Effettuare una richiesta POST /shares e specificare la proprietà user_tags. Questo esempio crea una condivisione con tre tag utente, env:test1, env:test2 e env:prod.

curl -X POST \
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
    -H "Authorization: Bearer $iam_token"\
    -H 'Content-Type: application/json'\
    -d '{
        "name": "share-name1",
        "size": 2300,
        "iops": 6000,
        "profile": {"name": "dp2"},
        "user_tags": [
           "env:test1",
           "env:test2",
           "env:prod"
        ],
        "zone": {"name": "us-south-1"}
      }'

Modifica di tag utente per una condivisione file esistente

Aggiungere nuovi tag utente a una condivisione file esistente eseguendo una richiesta PATCH /shares e specificare i tag utente nella proprietà user_tags. Se la condivisione file non aveva tag, vengono aggiunti i nuovi tag nella richiesta. Se la condivisione file aveva tag in precedenza, i nuovi tag sovrascrivono i tag precedenti.

L'esempio seguente modifica una condivisione di file identificata da ID. La condivisione viene rinominata e vengono aggiunti i tag utente.

curl -X PATCH\
"$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "name": "myshare-patch-1",
    "user_tags": [
      "ut8",
      "ut9"
    ],
  }'

La risposta corretta appare come in questo esempio:

{
    "access_control_mode": "vpc",
    "created_at": "2023-01-28T22:31:50Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south-1.cloud.ibm.com/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3",
    "id": "432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3",
    "initial_owner": {
      "gid": 0,
      "uid": 0
    },
    "iops": 3000,
    "lifecycle_state": "stable",
    "name": "myshare-patch-1",
    "profile": {
      "href": "https://us-south-1.cloud.ibm.com/v1/share/profiles/tier-3iops",
      "name": "tier-3iops",
      "resource_type": "share_profile"
    },
    "replication_role": "none",
    "replication_status": "none",
    "replication_status_reasons": [],
    "resource_group": {
      "crn": "crn": "crn:[...]",
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/86ccf0a1315646d4bc719fe34ff4d1e3",
      "id": "86ccf0a1315646d4bc719fe34ff4d1e3",
      "name": "Default"
    },
    "resource_type": "share",
    "size": 100,
    "mount_targets": [],
    "user_tags": [
      "ut8",
      "ut9"
    ],
    "zone": {
      "href": "https://us-south-1.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
      "name": "us-south-1"
    }
  }

Modifica dei tag utente di condivisione file con la verifica ETag

Per assicurarsi che gli aggiornamenti a una condivisione file siano validi, è possibile ottenere un ETag valore stringa hash e specificarlo nell'intestazione If-Match nella chiamata PATCH /shares/{share_id}. Ciò conferma che non è stata apportata alcuna modifica all'oggetto di condivisione tra l'ultimo stato osservato e lo stato al momento della chiamata PATCH.

Per modificare le tag utente esistenti aggiunte a una condivisione file, è necessario prima effettuare una chiamata GET /shares/{share_id} e copiare il valore hash dalla proprietà ETag nell'intestazione di risposta. Invii quindi il valore ETag utilizzando l'intestazione If-Match in una richiesta PATCH /shares/{share_id}. La specifica di un valore Etag garantisce che gli aggiornamenti o le eliminazioni di una condivisione file abbiano esito negativo se il valore If-Match non corrisponde al valore corrente della condivisione file Etag. Attieniti alla seguente procedura:

  1. Effettuare una richiesta GET /shares/{share_id} e copiare la stringa hash dalla proprietà ETag nell'intestazione della risposta. Usare il valore della stringa di hash quando si specifica If-Match nella richiesta PATCH /shares/{share_id} per modificare i tag utente per la condivisione al punto 2.
curl -sSL -D GET\ "https://us-south.cloud.ibm.com/v1/shares/{share_id}?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $TOKEN" -o /dev/null

L'intestazione della risposta è simile all'esempio seguente:

HTTP/2 200
date: Mon, 09 January 2023 17:48:03 GMT
content-type: application/json; charset=utf-8
content-length: 1049
cf-ray: 69903d250c4966ef-DFW
cache-control: max-age=0, no-cache, no-store, must-revalidate
expires: -1
strict-transport-security: max-age=31536000; includeSubDomains
cf-cache-status: DYNAMIC
expect-ct: max-age=604800, report-uri="[uri...]"
pragma: no-cache
x-content-type-options: nosniff
x-request-id: 1fbe2384-6828-4503-ae7d-050426d1b11b
x-xss-protection: 1; mode=block
server: cloudflare
etag: W/xxxyyyzzz123
  1. Effettuare una richiesta PATCH /shares/{share_id}. Specificare la stringa hash ETag per la proprietà If-Match nell'intestazione. Specificare la tag utente nella proprietà user_tags.

Questo esempio aggiorna le tag utente di condivisione file in env:test e env:prod. Il valore della stringa hash ottenuto dalla proprietà ETag (W/xxxyyyzzz123) è specificato nell'intestazione If-Match nella chiamata.

curl -X PATCH\
"$vpc_api_endpoint/v1/shares/50fda9c3-eecd-4152-b473-a98018ccfb10?version=2023-08-08&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -H "If-Match: W/xxxyyyzzz123"\
   -d `{
      "user_tags": [
         "env:test2",
         "env:prod2"
      ]
   }'

Aggiungere o modificare i tag utente della condivisione file con Terraform

Per applicare i tag utente a una condivisione di file, utilizzare la risorsa 'ibm_is_share per creare un argomento nel file 'main.tf. L'esempio seguente specifica la condivisione 'my-new-share e il tag 'dev:test da allegare alla condivisione. Una volta applicato, il tag viene aggiunto alla condivisione.

resource "ibm_is_share" "example" {
  name    = "my-new-share"
  size    = 200
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
  tags    = ["dev:test"]
}

Aggiunta di tag di gestione accessi a una condivisione file

Le tag di gestione degli accessi sono metadati che è possibile aggiungere alle condivisioni file per organizzare le relazioni delle risorse di controllo degli accessi. Creare prima il tag e quindi aggiungerlo a una condivisione file esistente o quando si crea una condivisione file. È possibile applicare la stessa tag di gestione accessi a più condivisioni file. Puoi assegnare l'accesso alla tag in Cloud Identity and Access Management (IAM). Facoltativamente, puoi creare un gruppo di accesso IAM e gestire gli utenti.

Passo 1 - Creazione di un tag di gestione degli accessi in IAM nella console

Nella console:

  1. Vai su Gestisci > Account, quindi seleziona Tag.
  2. Fare clic sulla scheda Tag di gestione accessi. Aggiungere un nome tag nel campo. I tag di gestione degli accessi devono essere in formato key:value.
  3. Fare clic su Crea tag.

Passo 1 - Creare un tag di gestione degli accessi IAM dalla CLI

Dalla riga di comando, inserire il comando 'ibmcloud resource tag-create per creare un tag di gestione degli accessi nel proprio account. L'esempio seguente crea un tag chiamato 'project:myproject:

ibmcloud resource tag-create --tag-names project:myproject

Per ulteriori informazioni, vedere il documento 'riferimento al comando ibmcloud resource.

Passo 1 - Creare un tag di gestione degli accessi IAM con l'API

Con l'API Global Search and Tagging, fare una richiesta 'POST/ tags per creare un tag di gestione degli accessi. Specificare il tag nella proprietà 'tag_names. Per un esempio, vedere Creazione di tag di gestione degli accessi tramite l'API.

Passo 1 - Creare un tag di gestione degli accessi IAM con Terraform

Creare un argomento nel file 'main.tf. L'esempio seguente crea il tag di gestione degli accessi 'ibm_tag che viene aggiunto alla risorsa 'ibm per l'ID della risorsa 'ibm_is_share.example.crn.

resource "ibm_resource" "ibm" {
resource_id = ibm_is_share.example.crn
tags        = [ "ibm_tag" ]
}

Passo 2 - Aggiunta di una tag di gestione accessi a una condivisione file

Aggiungere un tag di gestione accessi a una condivisione file esistente o quando si crea una condivisione file. Per una condivisione di file esistente:

  1. Nella consoleIBM Cloud, vai all'elenco Risorsa e seleziona una condivisione file nelle risorse Storage.
  2. Nel campo Tag di gestione accessi, immettere il nome di una tag di gestione accessi precedentemente creata. La tag viene visualizzata mentre si digita.
  3. Salva le tue modifiche.

Passo 3 - Creazione di un gruppo di accesso e assegnazione dell'accesso agli utenti

Dopo aver creato una tag di gestione accessi e averla applicata a una condivisione file, completare la seguente procedura per assegnare l'accesso e aggiungere utenti:

  1. Crea un gruppo di accesso. I gruppi di accesso vengono associati a criteri che assegnano ruoli e autorizzazioni ai membri di quel gruppo. Si assegna l'accesso alle tag di gestione accessi specifiche per il servizio file. Per ulteriori informazioni sui gruppi di accesso, vedi Configurazione dei gruppi di accesso.
  2. Assegnare una politica di accesso ad un gruppo.
  3. Aggiungere utenti al gruppo di accesso.

Quando guardi le risorse specifiche per l'infrastruttura VPC e specifichi File Storage for VPC come tipo di risorsa, puoi visualizzare le tag di gestione dell'accesso per il servizio file.

Rimozione dell'accesso a una condivisione file da altri account

La revoca dell'accesso a una condivisione file è un processo in due fasi.

  1. Rimuovere l'autorizzazione IAM tra gli account. La rimozione dell'autorizzazione IAM impedisce all'altro account o servizio di creare una condivisione di accesso e una destinazione di montaggio.
  1. Eliminare il bind di condivisione che connette la condivisione di origine con la condivisione del programma di accesso. Questa azione fa sì che la destinazione di montaggio dell'altro account entri in stato failed.

Montaggio e smontaggio delle condivisioni file su un'istanza del server virtuale

Il montaggio è il processo con cui il sistema operativo di un server rende disponibili i file e le directory sul dispositivo di archiviazione per l'accesso degli utenti attraverso il file system del server. Per montare una condivisione file su un'istanza del server virtuale, individuare le informazioni sul percorso di montaggio. Il percorso di montaggio viene creato quando si crea una destinazione di montaggio per la condivisione file. Consultare le seguenti informazioni per il montaggio su alcuni sistemi operativi Linux. Altre distribuzioni Linux seguono procedure simili.

Monitoraggio delle condivisioni di file

È possibile controllare lo stato e le condizioni di salute della condivisione di file utilizzando la console, la CLI o l'API. È possibile monitorare la larghezza di banda totale, gli IOPS totali, il numero di target di montaggio e l'utilizzo della capacità della condivisione nel tempo nella console IBM Cloud. Si può usare IBM Cloud® Activity Tracker Event Routing per configurare come instradare gli eventi di auditing per le condivisioni di file. Si può anche configurare IBM Cloud Logs Routing per la gestione dei registri. Per ulteriori informazioni, vedere Monitoraggio degli stati di salute delle condivisioni di file, dello stato del ciclo di vita e degli eventi.

Le condivisioni di file possono essere integrate con IBM Cloud® Monitoring per ottenere visibilità operativa sulle prestazioni e sullo stato di salute delle vostre condivisioni. Nell'interfaccia web di Sysdig è possibile visualizzare le metriche di larghezza di banda, IOPS e capacità in modo più dettagliato, personalizzare i dashboard e impostare gli avvisi. Per ulteriori informazioni, vedere Monitoraggio delle metriche per File Storage for VPC.

Eliminazione di condivisioni di file, binding di condivisioni accessorie e target di montaggio

Prima di eliminare una condivisione di file, assicurarsi che sia smontata da tutte le istanze del server virtuale e che tutti i target di montaggio che appartengono alla condivisione di file siano eliminati. Se la condivisione file è condivisa con un altro account, eliminare i collegamenti accessor prima di eliminare la condivisione. Inoltre, se la condivisione file ha una condivisione file di replica, è necessario rimuovere la relazione di replica. Per ulteriori informazioni, vedere Rimuovere la relazione di replica nella consoleRimuoverela relazione di replica dal CLIRimuoverela relazione di replica con APIRimuovere la relazione di replica con Terraform.

Sanificazione dei dati prima di eliminare una condivisione di file

Quando si elimina una condivisione di file, IBM garantisce che i dati non siano più accessibili sul disco fisico e che vengano infine eliminati definitivamente. Se sono previsti ulteriori requisiti di conformità, quali le linee guida NIST 800-88 per la sanificazione dei supporti, è necessario eseguire le procedure di sanificazione dei dati prima di eliminare le condivisioni di file. Per ulteriori informazioni, consultare le Linee guida NIST 800-88 per la sanificazione dei supporti.

La sanificazione della condivisione file prima della cancellazione garantisce che i dati residui presenti sul disco fisico non possano essere individuati né ricostruiti, anche qualora il supporto dovesse finire in mani estranee al controllo di IBM.

Eliminazione di condivisioni di file, binding di condivisioni accessorie e target di montaggio nella console

Le seguenti istruzioni possono aiutare ad assicurarsi che i binding delle condivisioni e i target di montaggio siano eliminati prima di provare a eliminare la condivisione di file non più necessaria.

Se la condivisione di file ha delle istantanee, queste ultime vengono eliminate insieme alla condivisione di file.

Eliminazione dei vincoli di condivisione di una condivisione di file nella console

  1. Selezionare una condivisione file dall'elenco di condivisioni file.
  2. Nella pagina Dettagli condivisione file, scorrere fino alla sezione Bind condivisione Accessor per individuare il bind che si desidera eliminare.
  3. Alla fine della riga del bind, fare clic sull'icona Azioni icona Azioni e selezionare Elimina.

Eliminazione della destinazione di montaggio di una condivisione di file nella console

  1. Selezionare una condivisione file dall'elenco di condivisioni file.
  2. Nella pagina Dettagli condivisione file, selezionare una destinazione di montaggio da eliminare.
  3. Fare clic sull'icona Azioni icona Azioni e selezionare Elimina.

Eliminazione di una condivisione di file nella console

La condivisione file deve essere nello stato stable o failed.

  1. Selezionare una condivisione file dall'elenco di condivisioni file.
  2. Fai clic sull'icona Azioni alla fine della riga e seleziona Elimina.

Eliminazione di condivisioni file, bind di condivisione accessor e destinazioni di montaggio dalla CLI

Le seguenti istruzioni possono aiutare ad assicurarsi che i binding delle condivisioni e i target di montaggio siano eliminati prima di provare a eliminare la condivisione di file non più necessaria.

  1. Individuare la condivisione file che si desidera eliminare elencando tutte le condivisioni file con il comando ibmcloud is shares.
ibmcloud is shares
Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                    Lifecycle state   Zone         Profile    Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2        10         defaults         none               none                    0                0
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2        10         defaults         none               none                    0                0
r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2        10         defaults         replica            none                    0                0
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2        10         defaults         source             none                    0                0
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2        10         defaults         replica            none                    0                0
r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2        10         defaults         source             none                    0                0
r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   dp2        40         defaults         none               -                       -                -
  1. Richiamare i dettagli della condivisione file per vedere la destinazione di montaggio collegata e le informazioni di replica con il comando ibmcloud is share.
ibmcloud is share my-file-share-2
Getting file share my-file-share-2 under account Test Account as user test.user@ibm.com...
ID                           r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940
Name                         my-file-share-2
CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940
Lifecycle state              stable
Access control mode          vpc
Zone                         us-south-1
Profile                      dp2
Size(GB)                     40
IOPS                         2000
User Tags                    env:dev,env:prod
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-36d67ada-ca83-44be-adad-dc58e7c38dc5   my-new-mount-target
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T23:52:45+00:00
Replication role             none
Replication status           none
Replication status reasons   Status code   Status message
                             -             -
Snapshot count               0
Snapshot size                0
Source snapshot              -

Eliminazione dei bind di condivisione di una condivisione file dalla CLI

Eseguire il comando share-binding-delete e specificare la condivisione del file di origine e il bind in base ai relativi nomi o ID. Immettere y quando viene richiesto. Se più di un bind è allegato alla condivisione file, ripetere questo passo fino a quando non vengono eliminati tutti i bind. Vedi il seguente esempio.

ibmcloud is share-bindings-delete my-origin-share r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
This will delete accessor binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for share ID my-origin-share and cannot be undone. Continue [y/N] ?> y
Deleting binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for share ID my-origin-share under account Test Account as user test.user@ibm.com...
OK
Binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 is deleted.

Eliminazione di una destinazione di montaggio di una condivisione file dalla CLI

Eseguire il comando share-mount-target-delete e specificare la condivisione file e la destinazione di montaggio in base ai relativi nomi o ID. Immettere y quando viene richiesto. Se più di una destinazione di montaggio è collegata alla condivisione file, ripetere questa operazione fino a quando non vengono eliminate tutte le destinazioni di montaggio.

ibmcloud is share-mount-target-delete my-file-share-2 my-new-mount-target
This will delete mounted target my-new-mount-target for share ID my-file-share-2 and cannot be undone. Continue [y/N] ?> y
Deleting mounted target my-new-mount-target for share ID my-file-share-2 under account Test Account as user test.user@ibm.com...
OK
Share mount target my-new-mount-target is deleted.

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-mount-target-delete.

Eliminazione di una condivisione file dalla CLI

La condivisione file deve essere in uno stato stable o failed. Per eliminare la condivisione file, eseguire il comando share_delete e specificare la condivisione file in base al relativo nome o ID.

ibmcloud is share-delete my-file-share-2
This will delete file share my-file-share-2 and cannot be undone. Continue [y/N] ?> y
Deleting file share my-file-share-2 under account Test Account as user test.user@ibm.com...
OK
File share my-file-share-2 is deleted.

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-delete.

Se la condivisione di file ha delle istantanee, queste ultime vengono eliminate insieme alla condivisione di file.

Eliminazione di condivisioni file, bind di condivisione accessor e destinazioni di montaggio con l'API

Le seguenti istruzioni possono aiutare ad assicurarsi che i binding delle condivisioni e i target di montaggio siano eliminati prima di provare a eliminare la condivisione di file non più necessaria.

Eliminazione dei bind di condivisione di una condivisione file con l'API

Puoi eliminare in modo programmatico un bind di condivisione richiamando il metodo /shares nell'API VPC come mostrato nella seguente richiesta di esempio.

curl -X DELETE "$vpc_api_endpoint/v1/shares/v1/shares/$share_id/bindings/$binding_id?version=2024-06-21&generation=2"

Eliminazione della destinazione di montaggio di una condivisione file con la API

Effettuare una chiamata DELETE /shares/{share_ID}/mount_targets/{target_id} per eliminare una destinazione di montaggio di una condivisione file. La condivisione file deve essere in stato stable. Una condivisione file non può essere eliminata, se una destinazione di montaggio esistente è associata a tale condivisione file o se sono in corso operazioni di replica.

Vedi il seguente esempio.

curl -X DELETE \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"

Una risposta riuscita ha una conferma di accettazione per l'eliminazione e una risposta che contiene le informazioni di destinazione.

L'esempio seguente mostra una destinazione di montaggio in cui 'access_control_mode è 'security_group. La risposta mostra il gruppo di sicurezza e la sottorete. È possibile vedere le specifiche dell'indirizzo IP riservato utilizzato per l'interfaccia di rete virtuale del target di montaggio nella sezione 'primary_ip. Per impostazione predefinita, l'interfaccia di rete virtuale viene eliminata insieme alla destinazione di montaggio quando la destinazione di montaggio viene eliminata. Lo stato della destinazione di montaggio mostra l'eliminazione mentre l'eliminazione è in corso.

{
  "access_control_mode": "security_group",
  "created_at": "2022-08-08T01:59:46.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_reasons": [],
  "lifecycle_state": "deleting",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_63aa_4deb_9ed5_1159e37cb5aa",
  "name": "target-name1",
  "primary_ip": {
    "address": "10.10.12.64",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5/reserved_ips/0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
    "id": "0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
    "name": "my-reserved-ip",
    "resource_type": "subnet_reserved_ip"
  },
  "resource_type": "share_mount_target",
  "security_groups": [
    {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
      "id": "r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
      "name": "my-security-group",
      "resource_type": "security_group"
    }
  ],
  "subnet": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5",
    "id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5",
    "name": "my-subnet",
    "resource_type": "subnet"
  },
  "transit_encryption": "none",
  "virtual_network_interface": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/4727d842-f94f-4a2d-824a-9bc9b02c523b",
    "id": "4727d842-f94f-4a2d-824a-9bc9b02c523b",
    "name": "my-virtual-network-interface",
    "resource_type": "virtual_network_interface"
  },
  "vpc": {
  "crn": "crn:[...]",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/8c95b3c1-fe3c-45c-97a6-e43d14088287",
  "id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
  "name": "vpc-name1",
  "resource_type": "vpc"
  }
}

La destinazione di montaggio viene eliminata in background. Confermare l'eliminazione tentando di visualizzare le informazioni sulla destinazione di montaggio. Se ricevi un errore 404 Not Found, la destinazione di montaggio viene eliminata correttamente.

Eliminazione di una condivisione file nell'API

La condivisione file deve essere in uno stato stable o failed.

Effettuare una chiamata DELETE /shares/$share_id per eliminare una condivisione file. La condivisione file deve essere nello stato stable o failed (ovvero, quando il provisioning non riesce). Una condivisione file non può essere eliminata, se una destinazione di montaggio esistente è associata a tale condivisione file o se sono in corso operazioni di replica.

Vedi il seguente esempio.

curl -X DELETE \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"

Una risposta corretta conferma l'accettazione per l'eliminazione e mostra le informazioni di condivisione file. Lo stato della condivisione file viene aggiornato in pending_elimina. Vedi il seguente esempio:

{
  "access_control_mode": "vpc",
  "created_at": "2022-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "iops": 3000,
  "lifecycle_state": "pending_deletion",
  "name": "share-name1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
    "name": "tier-10iops",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 100,
  "snapshot_count": 10,
  "snapshot_size": 10,
  "user_tags": [],
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

La condivisione file viene eliminata in background. Confermare l'eliminazione tentando di visualizzare le informazioni sulla destinazione di montaggio. Se ricevi un errore 404 Not Found, la destinazione di montaggio viene eliminata correttamente. Se la condivisione di file ha delle istantanee, queste ultime vengono eliminate insieme alla condivisione di file.

Una chiamata DELETE /shares/$share_id può includere facoltativamente un'intestazione If-Match che specifichi una stringa hash ETag. Effettua una chiamata GET /shares/{share_id} e copia la stringa hash ETag dall'intestazione della risposta. Per ulteriori informazioni, consultare Tag utente per le condivisioni file.

Eliminazione di condivisioni di file o target di montaggio con Terraform

Utilizza il comando " terraform destroy " per eliminare comodamente un oggetto remoto, ad esempio una condivisione file. Il seguente esempio mostra la sintassi per l'eliminazione di una condivisione. Sostituire l'ID effettivo della condivisione per ibm_is_share.example.id. Per eliminare un target di montaggio, utilizzare i loro ID con lo stesso comando.

terraform destroy --target ibm_is_share.example.id

Se la condivisione di file ha delle istantanee, queste ultime vengono eliminate insieme alla condivisione di file.

Per ulteriori informazioni, consulta terraform destroy.

Se si vuole rimuovere il binding di un accessor share utilizzando Terraform, si può usare la risorsa ibm_is_share_delete_accessor_binding.

resource "ibm_is_share_delete_accessor_binding" "example" {
    share = ibm_is_share.example.id
    accessor_binding = data.ibm_is_share_accessor_bindings.example.accessor_bindings.0.id
}

Per ulteriori informazioni sugli argomenti e gli attributi, vedere ibm_is_share_delete_accessor_binding.