ModificaVolumi
Puoi usare il ModifyVolumes metodo per configurare fino a 500 volumi esistenti contemporaneamente. I cambiamenti avvengono immediatamente. Se ModifyVolumes non riesce a modificare nessuno dei volumi specificati, nessuno dei volumi specificati viene modificato.
Se non si specificano valori QoS quando si modificano i volumi, i valori QoS per ciascun volume rimangono invariati. È possibile recuperare i valori QoS predefiniti per un volume appena creato eseguendo il comando GetDefaultQoS metodo.
Quando è necessario aumentare le dimensioni dei volumi da replicare, procedere nel seguente ordine per evitare errori di replica:
-
Aumentare le dimensioni del volume con l'accesso replicationTarget.
-
Aumentare le dimensioni della sorgente o del volume con accesso readWrite.
Assicurarsi che i volumi di destinazione e di origine abbiano le stesse dimensioni.
|
|
Se si modifica lo stato di accesso in bloccato o replicationTarget, tutte le connessioni iSCSI esistenti vengono terminate. |
Parametri
Questo metodo ha i seguenti parametri di input:
| Nome | Descrizione | Tipo | Valore predefinito | Necessario |
|---|---|---|---|---|
accesso |
Accesso consentito ai volumi. Valori possibili:
|
corda |
Nessuno |
NO |
ID account |
L'accountID a cui vengono riassegnati i volumi. Se non viene specificato alcun nome, verrà utilizzato il nome dell'account precedente. |
intero |
Nessuno |
NO |
associare alla politica QoSP |
Associare il volume al criterio QoS specificato. Valori possibili:
|
booleano |
Nessuno |
NO |
attributi |
Elenco di coppie nome-valore nel formato oggetto JSON. |
Oggetto JSON |
Nessuno |
NO |
createTime |
Una stringa di data ISO 8601 da impostare come data di creazione del nuovo volume. Obbligatorio se setCreateTime è impostato su true. |
Stringa ISO 8601 |
Nessuno |
NO |
dontMoveforIopsRebalance |
Impedisce lo spostamento di un volume durante il bilanciamento del carico con IOPS effettivi. Questa impostazione è disponibile a partire da Element 12.8 ed è efficace solo quando"VolumeLoadBalanceOnActualIOPS" è abilitato. Valori possibili:
Nota: il bilanciamento per l'alta disponibilità (guasto del nodo) ha la precedenza su |
booleano |
falso |
NO |
enableSnapMirrorReplication |
Determina se il volume può essere utilizzato per la replica con endpoint SnapMirror . Valori possibili:
|
booleano |
falso |
NO |
fifoSize |
Specifica il numero massimo di snapshot First-In-First-Out (FIFO) supportati dal volume. Si noti che gli snapshot FIFO e non FIFO utilizzano entrambi lo stesso pool di slot snapshot disponibili su un volume. Utilizzare questa opzione per limitare il consumo di snapshot FIFO degli slot snapshot disponibili. Si noti che non è possibile modificare questo valore in modo che sia inferiore al conteggio attuale degli snapshot FIFO. |
intero |
Nessuno |
NO |
minFifoSize |
Specifica il numero di slot snapshot riservati solo per snapshot First-In-First-Out (FIFO). Poiché gli snapshot FIFO e non FIFO condividono lo stesso pool, il parametro minFifoSize riduce della stessa quantità il numero totale di possibili snapshot non FIFO. Si noti che non è possibile modificare questo valore in modo che entri in conflitto con il conteggio attuale degli snapshot non FIFO. |
intero |
Nessuno |
NO |
modalità |
Modalità di replica del volume. Valori possibili:
|
corda |
Nessuno |
NO |
qualità |
Le nuove impostazioni della qualità del servizio per i volumi. Se non specificato, le impostazioni QoS non vengono modificate. Valori possibili:
|
Nessuno |
NO |
|
qosPolicyID |
ID del criterio le cui impostazioni QoS devono essere applicate ai volumi specificati. Questo parametro è mutuamente esclusivo con il parametro qos. |
intero |
Nessuno |
NO |
impostaCreateTime |
Impostare su true per modificare la data registrata della creazione del volume. |
booleano |
Nessuno |
NO |
dimensione totale |
La nuova dimensione dei volumi in byte. 1000000000 equivale a 1 GB. La dimensione è arrotondata al megabyte più vicino. Questo parametro può essere utilizzato solo per aumentare le dimensioni di un volume. |
intero |
Nessuno |
NO |
volumeID |
Un elenco di volumiID per i volumi da modificare. |
array di interi |
Nessuno |
SÌ |
Valore di ritorno
Questo metodo ha il seguente valore di ritorno:
| Nome | Descrizione | Tipo |
|---|---|---|
volume |
Un array di oggetti contenente informazioni su ogni volume appena modificato. |
volumevettore |
Richiedi esempio
Le richieste per questo metodo sono simili al seguente esempio:
{
"method": "ModifyVolumes",
"params": {
"volumeIDs": [319,22],
"access": "readWrite",
"dontMoveForIopsRebalance": false
},
"id": 1
}
Esempio di risposta
Questo metodo restituisce una risposta simile al seguente esempio:
{
"id": 1,
"result": {
"volumes":
{
"access": "readWrite,
"accountID": 22,
"attributes": {},
"blockSize": 4096,
"createTime": "2024-04-01T19:39:40Z",
"currentProtectionScheme": "doubleHelix",
"deleteTime": "",
"dontMoveForIopsRebalance": false,
"enable512e": false,
"enableSnapMirrorReplication": false,
"fifoSize": 24,
"iqn": "iqn.2010-01.com.solidfire:3eeu.suite40.319",
"lastAccessTime": "2024-04-02T12:41:34Z",
"lastAccessTimeIO": "2024-04-01T20:41:19Z",
"minFifoSize": 0,
"name": "suite40",
"previousProtectionScheme": null,
"purgeTime": "",
"qos": {
"burstIOPS": 27000,
"burstTime": 60,
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500,
"4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"maxIOPS": 27000,
"minIOPS": 500
},
"qosPolicyID": null,
"scsiEUIDeviceID": "336565750000013ff47acc0100000000",
"scsiNAADeviceID": "6f47acc100000000336565750000013f",
"sliceCount": 1,
"status": "active",
"totalSize": 1000000716800,
"virtualVolumeID": null,
"volumeAccessGroups": [
22
],
"volumeConsistencyGroupUUID": "3003109e-6e75-444c-8cee-470d641a09c3",
"volumeID": 319,
"volumePairs": [],
"
}
}
}
Nuovo dalla versione
9,6