IBM Cloud Docs
Espansione della capacità di condivisione file

Espansione della capacità di condivisione file

Per condivisioni file File Storage for VPC, puoi aumentare la dimensione della condivisione file dalla sua capacità originale in incrementi di GB fino a 32.000 GB, a seconda del tuo profilo di condivisione file. Questo processo non richiede di eseguire operazioni manuali. Ad esempio, non è necessario migrare i dati in una condivisione file più grande. L'operazione di espansione non causa alcuna interruzione o mancanza di accesso alla tua archiviazione.

La fatturazione della condivisione di file viene aggiornata automaticamente per aggiungere la differenza proporzionale del nuovo prezzo al ciclo di fatturazione corrente. L'intero nuovo ammontare viene quindi fatturato nel prossimo ciclo di fatturazione.

Concetti di condivisione file espandibili

È possibile aumentare la capacità della condivisione file. La dimensione della condivisione file non può essere inferiore alla dimensione della condivisione file corrente.

La capacità può essere aumentata per le condivisioni file che si trovano in uno stato stable. L'autorizzazione utente viene verificata prima che la condivisione file venga espansa. Puoi utilizzare l'IU, la CLI, l'API o Terraform per incrementare la capacità di condivisione file. È possibile espandere una condivisione file più volte fino al limite massimo di capacità. Una volta espansa la condivisione file, non è possibile ridurre la capacità.

La capacità espansa è determinata dal massimo consentito dal profilo di condivisione file. Le condivisioni file create da un profilo Personalizzato o da un profilo dp2 possono essere espanse all'interno dell'intervallo IOPS consentito per tale dimensione di condivisione file.

Le condivisioni file create da un profilo di livello IOPS possono essere espanse alla dimensione massima per il suo livello IOPS:

  • Un profilo IOPS/GB generico può essere espanso fino a 32.000 GB.
  • Un profilo da 5 IOPS/GB può essere espanso fino a 9.600 GB.
  • Un profilo da 10 IOPS/GB può essere espanso fino a 4.800 GB.

L'IOPS viene regolato automaticamente per i profili di condivisione file a più livelli, in base alle dimensioni della condivisione file. Ad esempio, se espandi una condivisione con un profilo da 5 IOPS/GB da 250 GB a 1.000 GB, ha un IOPS massimo di 5.000 IOPS (capacità da 1.000 GB x 5 IOPS). Poiché una condivisione file di 5 IOPS/GB può potenzialmente espandersi a 9.600 GB, l'IOPS massimo è regolato a 48.000 IOPS. La capacità e l'IOPS vengono immediatamente modificati e non devi riavviare l'istanza.

Puoi monitorare l'avanzamento dell'espansione della tua condivisione file dall'IU o dalla CLI. È inoltre possibile controllare gli eventi di monitoraggio delle attività per verificare che la condivisione di file sia stata espansa. Dopo che una condivisione file è stata espansa, non puoi ridurre la capacità.

Requisiti

La condivisione file deve essere nello stato stable prima di poter richiedere l'aumento della capacità.

Limitazioni

Le seguenti limitazioni si applicano a questa release.

  • Le condivisioni file possono espandersi, con le seguenti limitazioni:
    • Se la condivisione di file è stata creata con un profilo a livelli che limita la capacità a meno di 32.000 GB, può espandersi solo fino alla capacità consentita per quel livello.
    • Se la condivisione di file è stata creata con il profilo Personalizzato in un intervallo IOPS che non consente l'espansione a 16.000 GB, la condivisione può espandersi solo fino alla capacità massima dell'intervallo specificato.
    • Se la condivisione di file è stata creata con il profilo dp2 in un intervallo IOPS che non consente l'espansione a 32.000 GB, la condivisione può espandersi solo fino alla capacità massima dell'intervallo specificato.
    • Le condivisioni file possono espandersi più volte fino a raggiungere la capacità massima.
  • L'IOPS aumenta fino al massimo consentito dal profilo.
  • Non puoi modificare in modo indipendente l'IOPS per una condivisione file creata da un profilo di livello IOPS. L'IOPS viene regolato quando si espande la capacità.
  • Quando espandi una condivisione file creata da un profilo dp2 o personalizzato, la capacità viene aumentata, ma l'IOPS rimane lo stesso a meno che non scegli di regolare l'IOPS.
  • L'IOPS massimo per una condivisione file è limitato a 48.000 IOPS se vi accede un singolo host. Per una condivisione file a cui accedono più host, gli IOPS possono raggiungere fino a 96.000 IOPS.
  • Una volta espansa una condivisione file, non è possibile ridurne la dimensione.

Espansione della capacità della condivisione file nella console

Seguire la seguente procedura per espandere la capacità della condivisione file nella console:

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

  2. La pagina di elenco Condivisioni di file per VPC mostra tutte le condivisioni di file create in quella zona. Fare clic sul nome della condivisione file per visualizzare la pagina dei dettagli.

  3. Nella pagina dei dettagli delle condivisioni file, espandere il menu Azioni.

  4. Selezionare Espandi condivisione file. Il pannello Espandi dimensione condivisione file visualizza la dimensione corrente della condivisione file (in GB) e il profilo a cui è associata. In alternativa, è possibile anche fare clic sull'icona Modifica accanto alle informazioni sulla dimensione della condivisione file.

  5. Immettere una dimensione di condivisione file maggiore, in base al valore massimo consentito per il Profilo condivisione file. Il valore predefinito è la dimensione corrente + 1 GB.

  6. Esamina il riepilogo dell'ordine mensile stimato per la tua area geografica e i nuovi prezzi.

  7. Se si è soddisfatti, fare clic su Salva e continua.

La nuova allocazione di file è disponibile in pochi minuti. Se i tuoi requisiti cambiano, puoi aumentare di nuovo la capacità dopo l'aumento della dimensione della condivisione file e quando si trova nello stato stable.

Non è possibile modificare la dimensione della condivisione di file dopo averne ampliato la capacità.

Espansione delle condivisioni file dalla CLI

Per aumentare la capacità di una condivisione file dalla CLI, utilizza il comando share-update con l'opzione --size e indica la nuova dimensione della condivisione file in GB.

  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. Visualizzare i dettagli della condivisione file che si desidera modificare 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-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)                     1000   
 IOPS                         1000
 User Tags                    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              -               
  1. Eseguire il comando ibmcloud is share-update per incrementare la capacità della condivisione file.

    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              updating   
    Access control mode          security_group  
    Accessor binding role        none  
    Zone                         us-south-2   
    Profile                      dp2   
    Size(GB)                     1500   
    IOPS                         1000   
    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   
    Latest job                   Job status   Job status reasons      
                                 succeeded    -      
    
    Replication share            ID                                          Name               Resource type      
                                 r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share      
    
    Replication role             source   
    Replication status           active   
    Replication status reasons   Status code   Status message      
                                 -             -      
    
    Snapshot count               0
    Snapshot size                0
    Source snapshot              -
    

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

Espansione della capacità di condivisione file con l'API

Puoi espandere le condivisioni file esistenti richiamando l'API VPC. Effettuare una richiesta PATCH /shares/{id} e specificare l'ID della condivisione file per cui si desidera aumentare la dimensione.

Questo esempio di richiesta espande una condivisione file con una capacità da 50 GB a 2500 GB per un profilo da 5 IOPS/GB.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2" \
 -H "Authorization: $iam_token" \
 -d '{
      "size": 2500
    }'

Lo stato di condivisione file mostra updating mentre la capacità viene aumentata. La capacità corrente viene visualizzata durante l'aggiornamento.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "updating",
  "name": "share-name1",
    .
    .
	"size": 2500,
    .
    .
    .
}

Quando l'espansione della condivisione file viene completata, viene visualizzato il nuovo valore e lo stato è stable.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "stable",
  "name": "share-name1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
    "name": "dp2",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/875623bcde2b4ebda924d32640908845",
    "id": "875623bcde2b4ebda924d32640908845",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 2500,
  .
  .
  .
}

Espansione delle condivisioni file con Terraform

Per aumentare la capacità di una condivisione file, utilizzare la risorsa ibm_is_share. Quando viene applicato, il seguente esempio aggiorna la capacità di condivisione a 300 GB.

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

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

Passi successivi

Montare e utilizzare le condivisioni file: