Espansione della capacità di condivisione file

Amplia la capacità di condivisione dei file di File Storage for VPC fino a 32.000 GB senza tempi di inattività né migrazione dei dati. La fatturazione viene aggiornata automaticamente per riflettere la nuova capacità.

La fatturazione relativa alla condivisione dei file viene aggiornata automaticamente per aggiungere la differenza, calcolata proporzionalmente, del nuovo prezzo al ciclo di fatturazione in corso. 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.

Selezionare la disponibilità Le condivisioni di file regionali create con il profilo rfs possono essere aumentate fino a 32 TB senza restrizioni.

Le condivisioni di file zonali create con il profilo personalizzato dp2 o con il profilo personalizzato Deprecated possono essere espanse entro l'intervallo IOPS consentito per la dimensione della condivisione file.

Le condivisioni di file zonali create con uno dei profili di livello IOPS di Deprecated possono essere espanse fino alla dimensione massima del relativo 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.

Lo IOPS viene regolato automaticamente per i profili di condivisione file a livelli deprecati, 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 gli IOPS vengono modificati immediatamente e non è necessario 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.
  • Il limite massimo di IOPS per una condivisione di file zonale è di 48.000 IOPS se l'accesso avviene da un singolo host. Per una condivisione di file zonale a cui accedono più host, gli IOPS possono raggiungere i 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 quota di spazio di archiviazione dei file sarà disponibile tra 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
    
 ```sh {: screen}
 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              -
 Allowed Access Protocols     nfs4
 Availability Mode            zonal
 Bandwidth(Mbps)              1
 Storage Generation           1
  1. Eseguire il comando ibmcloud is share-update per incrementare la capacità della condivisione file.
ibmcloud is share-update my-file-share --size 1500
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              -
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 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: Bearer $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: