Regolazione di IOPS per una condivisione di file zonale

Regolare i limiti delle operazioni di input/output al secondo (IOPS) per le condivisioni di file zonali con il profilo " dp2 " da 100 a 96.000 IOPS senza interruzioni del servizio.

Le modifiche hanno effetto immediato senza alcuna interruzione del servizio. È possibile gestire il limite di IOPS tramite la console, la CLI, l'API o Terraform.

La fatturazione per una condivisione aggiornata viene aggiornata automaticamente. La differenza ripartita del nuovo prezzo viene aggiunta al ciclo di fatturazione corrente. L'intero nuovo ammontare viene quindi fatturato nel prossimo ciclo di fatturazione.

Selezionare la disponibilità Non è possibile modificare il valore IOPS delle condivisioni file regionali create con il profilo rfs. Tuttavia, è possibile regolare il valore della larghezza di banda per ottimizzare le prestazioni della condivisione.

Concetti IOPS regolabili

È possibile regolare gli IOPS per le condivisioni di file zonali per adattare le prestazioni alle proprie esigenze.

Ad esempio, si potrebbe scoprire che un'applicazione è stata scalata in modo tale che l'attuale limite di IOPS è ora un collo di bottiglia delle prestazioni. È possibile modificare le caratteristiche di prestazione della condivisione di file esistente aumentando gli IOPS.
In un altro scenario, si potrebbe voler impostare inizialmente lo storage dei file a un livello IOPS più alto per accelerare il caricamento dei dati. Una volta completato il caricamento, puoi reimpostare l'archiviazione su 5 IOPS/GB per le normali operazioni. Inoltre, potresti voler aumentare l'IOPS della tua condivisione file durante le ore di picco per la tua applicazione e diminuire l'IOPS durante le ore non di picco.

Quando la condivisione utilizza il profilo dp2 iOPS della condivisione possono variare da 100 a 96.000. È possibile specificare il valore IOPS con restrizioni minime. Gli IOPS possono essere regolati più volte fino a raggiungere il limite massimo o minimo.

Per raggiungere i 96.000 IOPS, una singola condivisione di file deve essere accessibile da più istanze di server virtuali. Una singola condivisione di file a cui accede un solo client è limitata a 48.000 IOPS.

Quando la condivisione di file utilizza il profilo di condivisione personalizzato Deprecated, l'intervallo IOPS si basa sulle dimensioni della condivisione di file.

Ad esempio, per una condivisione file di 25 GB, puoi aumentare l'IOPS ovunque nell'intervallo 100-1.000 IOPS con un profilo personalizzato. Se in seguito si aumenta la dimensione di una condivisione di file alla fascia successiva più alta, è possibile aumentare nuovamente gli IOPS. Gli IOPS possono essere regolati più volte fino a raggiungere il limite massimo o minimo.
Oppure si può passare da un profilo personalizzato a un profilo di livello IOPS o al profilo dp2. La selezione del livello IOPS è limitata dalla dimensione della condivisione dei file. Quando si passa da un profilo personalizzato a uno qualsiasi, la fatturazione viene aggiornata e la IOPS viene regolata in base al profilo.

Quando la condivisione di file utilizza uno dei profili di condivisione a livelli Deprecated, è possibile regolare il limite IOPS mediante:

Passare da un profilo di livello IOPS al profilo dp2 o custom. In questo caso, la dimensione della condivisione dei file limita l'intervallo IOPS selezionato.
- Ad esempio, se si regolano le IOPS per la condivisione di file con un profilo di 3 IOPS/GB e il volume è di 12.000 GB, è possibile regolare le IOPS utilizzando un profilo personalizzato o dp2. È possibile perché entrambi supportano una dimensione di condivisione di 12.000 GB.
- Se la dimensione della condivisione dei file fosse superiore a 16.000 GB, il profilo personalizzato non supporterebbe la regolazione degli IOPS, ma il profilo dp2 sì, perché supporta dimensioni di condivisione fino a 32.000 GB. Le dimensioni massime del livello IOPS sono 32.000 GB per 3 IOPS/GB, 9.600 GB per 5 IOPS/GB e 4.800 GB per 10 IOPS/GB.
Quando si passa da un profilo a livelli a un profilo personalizzato o dp2, la fatturazione viene aggiornata in base agli IOPS specificati.
Selezionare un livello IOPS diverso. L'IOPS è regolato all'interno del livello. Il grado a cui l'IOPS può essere aumentato è determinato dal massimo consentito dal profilo del livello IOPS della condivisione file. Puoi regolare l'IOPS per un livello IOPS in base alle dimensioni della condivisione o selezionare il profilo successivo che consente di aumentare le prestazioni.

L'IOPS massimo per una condivisione file per un profilo di livello 3 IOPS/GB è 96.000 IOPS. Tutti gli altri profili sono limitati a 48.000 IOPS. Per 96.000 IOPS da realizzare, a una singola condivisione file devono accedere più istanze del server virtuale. Una singola condivisione file a cui si accede da un'istanza è limitata a 48.000 IOPS.

Per modificare l'IOPS di una condivisione file, la condivisione file deve essere in uno stato stabile . La tua autorizzazione utente viene verificata prima che l'IOPS venga modificato.

Puoi monitorare l'avanzamento della modifica IOPS della tua condivisione file dall'IU o dalla CLI. È inoltre possibile controllare gli eventi di monitoraggio delle attività per verificare che le IOPS siano state regolate.

Limitazioni

Si applicano le seguenti limitazioni.

Per regolare l'IOPS, la condivisione file deve essere in stato stabile .
Un profilodp2 può espandersi al massimo consentito dalla banda dp2. Non è possibile cambiare le bande IOPS di dp2 a meno che non si aumenti la dimensione della condivisione dei file e quindi si passi a una banda superiore.
Per una condivisione file creata con un profilo di livello IOPS per aumentare o diminuire l'IOPS, seleziona un profilo differente per la dimensione della condivisione file. Se la dimensione della condivisione file supera quella del nuovo profilo del livello IOPS, non puoi modificare il profilo.
Un profilo IOPS personalizzato ( custom IOPS profile ) può espandersi al massimo consentito dalla banda personalizzata. Non è possibile cambiare bande personalizzate a meno che non si aumenta la dimensione della condivisione file e quindi si passa a una banda superiore.
La regolazione dell'IOPS spostandosi tra i profili è limitata dalla dimensione della condivisione file.
L'IOPS massimo per una condivisione file per tutti i profili è 96.000 IOPS. Per 96.000 IOPS da realizzare, a una singola condivisione file devono accedere più istanze del server virtuale. Una singola condivisione file in un'istanza è limitata a 48.000 IOPS.

Regolazione di IOPS nella console

Segui questa procedura per regolare l'IOPS selezionando un nuovo livello IOPS o una banda IOPS personalizzata:

Andare alla lista delle condivisioni file. Nella console IBM Cloud, fai clic del menu di navigazione > infrastruttura > Archiviazione > Condivisioni di archiviazione file. Per impostazione predefinita, le condivisioni di file vengono visualizzate per tutti i gruppi di risorse nella propria regione.
Nella pagina di elenco Condivisioni file per VPC, fare clic sul nome di una condivisione file per visualizzarne i dettagli.
Nella pagina dei dettagli della condivisione file, individuare Profilo e fare clic sull'icona Modifica oppure utilizzare il menu Azioni e selezionare Modifica profilo IOPS. I volumi devono essere collegati a un'istanza del server virtuale per queste azioni.
Nel pannello laterale, regola IOPS come segue:
- Per il profilo dp2 o personalizzato, viene mostrato il valore IOPS corrente e la dimensione della condivisione dei file. Immettere un nuovo valore IOPS nell'intervallo consentito per tale dimensione.
- Per un livello IOPS, seleziona un altro livello dal menu. Ad esempio, è possibile che si disponga di un profilo per scopi generici 3 IOPS/GB che si desidera aumentare a 5 IOPS/GB.
Esamina il riepilogo dell'ordine mensile stimato per la tua area geografica e i nuovi prezzi.
Se si è soddisfatti, fare clic su Salva e continua. La tua nuova allocazione IOPS viene realizzata quando riavvii l'istanza.

Adattamento dell'IOPS dalla CLI

Regolazione di IOPS per un profilo personalizzato o dp2

Dalla CLI, utilizza il comando share-update con la propriet ... --iops per indicare la nuova dimensione IOPS per un profilo dp2 personalizzato. Gli IOPS indicati devono rientrare nell'intervallo delle dimensioni della condivisione di file. Per ulteriori informazioni, consultare il " dp2 o il " Profilo IOPS personalizzato.

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

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
r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source
r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          replica
r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          source

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              -

Utilizza il comando ibmcloud is share-update per aumentare o diminuire l'IOPS della tua condivisione file.

ibmcloud is share-update my-file-share --iops 2000

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)                     1000
IOPS                         2000
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

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

Regolazione di IOPS specificando un diverso profilo di livello IOPS

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 di azioni sono deprecati. Per accedere alle funzioni più recenti, è necessario modificare il profilo IOPS della condivisione in dp2.

Dalla CLI, utilizza il comando ibmcloud is share-update con la proprietà --profile e indica il nome o l'href del profilo del livello IOPS.

Il seguente esempio modifica un profilo 3 IOPS/GB in un profilo 5 IOPS/GB. In questo caso, la condivisione file non può superare 9.600 GB per passare al profilo superiore.

ibmcloud is share-update my-file-share --profile tier-5iops

Updating file share my-file-share under account Test Account as user user@mycompany.com...
ID                           ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-1
Profile                      tier-5iops
Size(GB)                     100
IOPS                         3000
User Tags                    docs:test
Encryption                   provider_managed
Mount targets                ID                          Name   VPC ID   VPC Name
                             No mount targets found.
Resource group               ID                                     Name
                             7f1645c5-8afa-4a7e-860d-3df563e0aa8d   Default
Created                      2023-02-26T20:01:18+05:30
Snapshot count               0
Snapshot size                0
Source snapshot              -

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

Regolazione dell'IOPS con l'API

Puoi modificare gli IOPS per le condivisioni di file di dati esistenti richiamando il VPC (Virtual Private Cloud) API.

Regolazione degli IOPS per il profilo dp2 o il profilo personalizzato

Effettua una richiesta PATCH /shares e specifica la proprietà iops per modificare l'IOPS all'interno dell'intervallo consentito per un profilo dp2 personalizzato.

Non puoi aggiornare il nome della condivisione file e modificare l'IOPS nella stessa richiesta PATCH /shares. Effettuare due richieste PATCH /shares.

Il seguente esempio mostra un aumento di 100 IOPS a 3.000 IOPS per una condivisione file da 100 GB basata su un profilo personalizzato 100-499. L'intervallo IOPS per questa banda personalizzata è compreso tra 100 e 6.000 IOPS. Per ulteriori informazioni sugli intervalli IOPS disponibili, vedere Panoramica del profilo di archiviazione dei file.

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

Lo stato della condivisione file mostra updating mentre l'IOPS viene modificato. L'IOPS corrente viene visualizzato finché non riavvii l'istanza. Nell'esempio seguente, il valore IOPS viene regolato a partire da 100.

{
   "created_at": "2023-08-08T22:58:49.000Z",
   "crn": "crn:[...]",
   "encryption": "provider_managed",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "id": "r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "iops": 100,
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

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

{
  "created_at": "2023-08-08T22:58:49.000Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86",
  "id": "a0c07083-f411-446c-9316-7b08d6448c86",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "my-share-updated",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-3iops",
    "name": "custom",
    "resource_type": "share_profile"
  },
  "access_control_mode": "security-group",
  "allowed_transit_encryption_modes": ["none", "user-managed"],
  "replication_role": "none",
  "replication_status": "none",
  "replication_status_reasons": [],
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 4800,
  "mount_targets": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86/mount_targets/1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "name": "my-mount-target",
      "resource_type": "share_target",
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-12bb28fc-856d-4902-813b-dc065d1ed084",
        "id": "12bb28fc-856d-4902-813b-dc065d1ed084",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "snapshot_count": 10,
  "snapshot_size": 10,
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1",
    "resource_type": "zone"
  }
}

Regolazione di IOPS specificando un diverso profilo di livello IOPS

Effettuare una richiesta PATCH /shares e specificare la proprietà profile e indicare il nome o l'href del profilo del livello IOPS.

Il seguente esempio modifica un profilo 3 IOPS/GB in un profilo 5 IOPS/GB. In questo caso, la condivisione file non può superare 9.600 GB per passare al profilo superiore.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-07-18&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "profile": "5iops-tier"
    }'

Regolazione IOPS con Terraform

Puoi modificare l'IOPS per le condivisioni di file di dati esistenti in Terraform.

Regolazione di IOPS per un profilo personalizzato o dp2

Per modificare il livello di prestazioni di una condivisione file, utilizzare la risorsa ibm_is_share e fornire il valore IOPS desiderato. Quando specifichi il valore IOPS, assicurati che sia compreso tra le prestazioni per la dimensione della condivisione file. Per ulteriori informazioni, consultare dp2 file storage profile.

Quando viene applicato, il seguente esempio aggiorna le prestazioni della condivisione a 5000 IOPS.

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

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

Regolazione di IOPS specificando un diverso profilo di livello IOPS

Per modificare il livello di prestazioni di una condivisione file con un profilo del livello IOPS, utilizza la risorsa ibm_is_share e specifica un livello IOPS diverso. Quando viene applicato, il seguente esempio aggiorna le prestazioni della condivisione a 5000 IOPS.

resource "ibm_is_share" "example" {
  name    = "my-share"
  size    = 220
  profile = "tier-5iops"
  zone    = "us-south-2"
}

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

Passi successivi

Creare più condivisioni file o gestire le condivisioni esistenti: